Biblioteka klienta .NET rejestruje żądania, odpowiedzi i komunikaty podsumowujące przesyłane do interfejsu Google Ads API. Logi mogą być zapisywane w niestandardowej instancji TraceListener
lub niestandardowej instancji ILogger
.
TraceListener
Aby włączyć logowanie w TraceListener
, dodaj ten wiersz w metodzie Main
przed wykonaniem jakichkolwiek wywołań interfejsu API.
using Google.Ads.GoogleAds.Util;
...
// Detailed logs.
TraceUtilities.Configure(TraceUtilities.DETAILED_REQUEST_LOGS_SOURCE,
"C:\\logs\\details.log", System.Diagnostics.SourceLevels.All);
// Summary logs.
TraceUtilities.Configure(TraceUtilities.SUMMARY_REQUEST_LOGS_SOURCE,
"C:\\logs\\details.log", System.Diagnostics.SourceLevels.All);
ILogger
Jeśli korzystasz już z logów aplikacji za pomocą ILogger
, to rozwiązanie pozwoli Ci zintegrować dzienniki interfejsu Google Ads API z istniejącymi logami.
Najpierw utwórz LoggerFactory
, a jeśli już go masz, dodaj filtry dla dzienników interfejsu Google Ads API:
var loggerFactory = LoggerFactory.Create(delegate (ILoggingBuilder builder)
{
// Log to stdout.
builder.AddConsole();
builder.AddFilter(TraceUtilities.SUMMARY_REQUEST_LOGS_SOURCE, LogLevel.Trace);
builder.AddFilter(TraceUtilities.DETAILED_REQUEST_LOGS_SOURCE, LogLevel.Trace);
});
Następnie za pomocą LoggerFactory
utwórz rejestratory żądań i odpowiedzi oraz szczegóły:
ILogger summaryLogger = loggerFactory.CreateLogger(TraceUtilities.SUMMARY_REQUEST_LOGS_SOURCE);
ILogger detailLogger = loggerFactory.CreateLogger(TraceUtilities.DETAILED_REQUEST_LOGS_SOURCE);
Na koniec skonfiguruj bibliotekę klienta, aby przekierowywała logi czasu do instancji ILogger
:
TraceUtilities.ConfigureSummaryLogger(summaryLogger);
TraceUtilities.ConfigureDetailLogger(detailLogger);
To rozwiązanie pozwala zintegrować logi żądań i odpowiedzi interfejsu Google Ads API z istniejącymi platformami logowania, takimi jak Log4Net, NLog czy Serilog.
Poziomy logu
Biblioteka rejestruje różne typy zdarzeń na różnych poziomach logów. W przypadku pomyślnej odpowiedzi interfejsu API podsumowanie jest logowane na stronie INFO
, a pełne żądanie i odpowiedzi – DEBUG
.
W przypadku żądania, które powoduje błąd interfejsu API, komunikat z podsumowaniem jest logowany na stronie WARN
, a pełne żądanie i odpowiedź – INFO
.
Częściowe błędy są logowane DEBUG
.
Identyfikator zgłoszenia
W większości przypadków logi generowane przez bibliotekę klienta zawierają wystarczającą ilość szczegółów, aby rozwiązać problemy. Kontaktując się z forum pomocy lub aliasami, możesz udostępnić dzienniki (co domyślnie usuwa informacje poufne) lub po prostu udostępnić identyfikator żądania (rejestrowany jako część dziennika odpowiedzi).
Jeśli wolisz samodzielnie przechwytywać identyfikator żądania, możesz zastosować jedną z tych metod:
Wyodrębnianie za pomocą zwykłych wywołań interfejsu API
Za pomocą niestandardowego identyfikatora CallSetting
z TrailingMetadataHandler
możesz przechwytywać identyfikatory żądań ze zwykłych jednoargumentowych wywołań.
CallSettings callSettings = CallSettings.FromTrailingMetadataHandler(
delegate (Metadata metadata) {
// Extract the request ID from the trailing metadata.
string requestId = metadata.Get("request-id").Value;
});
// Add the campaigns.
MutateCampaignsResponse retVal = campaignService.MutateCampaigns(
customerId.ToString(), operations.ToArray(), callSettings);
Wyodrębnianie za pomocą wywołań interfejsu API strumieniowania
Identyfikator żądania jest zwracany jako część obiektu odpowiedzi w przypadku wywołań interfejsu API strumieniowania. Identyfikator żądania dla wywołania SearchStream
możesz na przykład uzyskać w następujący sposób:
// Get the GoogleAdsService.
GoogleAdsServiceClient googleAdsService = client.GetService(
Services.V17.GoogleAdsService);
// Retrieve all campaigns.
string query = @"SELECT
campaign.id,
campaign.name,
campaign.network_settings.target_content_network
FROM campaign
ORDER BY campaign.id";
// Issue a search request.
googleAdsService.SearchStream(customerId.ToString(), query,
delegate (SearchGoogleAdsStreamResponse resp)
{
// Extract the request ID from the response.
string requestId = resp.RequestId;
foreach (GoogleAdsRow googleAdsRow in resp.Results)
{
Console.WriteLine("Campaign with ID {0} and name '{1}' was found.",
googleAdsRow.Campaign.Id, googleAdsRow.Campaign.Name);
}
}
);
Wyjątki
Identyfikator żądania jest zwracany w ramach wyjątku GoogleAdsException
w przypadku niepowodzenia wywołania interfejsu API.
try
{
// Make an API call.
...
}
catch (GoogleAdsException e)
{
string requestId = e.RequestId;
}
Zaawansowane logowanie
Jeśli dziennik interfejsu API nie zawiera wystarczających informacji, włącz więcej logowania niskiego poziomu na poziomie gRPC. Pamiętaj, że wyniki mogą być bardzo obszerne. Logi gRPC są zapisywane w katalogu stderr, ale możesz dołączyć własny rejestrator, jak pokazano poniżej. Obsługiwane zmienne środowiskowe.
Environment.SetEnvironmentVariable("GRPC_VERBOSITY", "DEBUG");
Environment.SetEnvironmentVariable("GRPC_TRACE", "http");
GrpcEnvironment.SetLogger(new ConsoleLogger());
Konfiguracja TraceListener z użyciem pliku App.config (starsza wersja)
Jeśli Twoja aplikacja kompiluje się pod kątem środowiska docelowego .NET Framework, możesz wczytać konfigurację logowania z pliku App.config
lub Web.config
swojej aplikacji. Jest to starsza funkcja .NET, która nie jest obsługiwana w aplikacjach utworzonych na potrzeby środowiska docelowego .NET Core.
Aby korzystać z tej funkcji, musisz dodać do pliku konfiguracji te zmiany:
Dodaj poniższy fragment kodu w sekcji
<configuration>
.<system.diagnostics> <sources> <source name="GoogleAds.DeprecationMessages" switchName="GoogleAds.DeprecationMessages" switchType="System.Diagnostics.SourceSwitch"> <listeners> <add name="myListener" type="System.Diagnostics.EventLogTraceListener" initializeData="Application"/> </listeners> </source> <source name="GoogleAds.DetailedRequestLogs" switchName="GoogleAds.DetailedRequestLogs" switchType="System.Diagnostics.SourceSwitch"> <listeners> <add name="detailedRequestLogListener" type="System.Diagnostics.ConsoleTraceListener" initializeData="true"/> <!-- Use the following to log to file. Modify the initializeData attribute to control the path to the detailed request log file. --> <!-- <add name="detailedRequestLogListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="C:\Logs\detailed_logs.log"/> <remove name="Default"/> --> </listeners> </source> <source name="GoogleAds.SummaryRequestLogs" switchName="GoogleAds.SummaryRequestLogs" switchType="System.Diagnostics.SourceSwitch"> <listeners> <add name="summaryRequestLogListener" type="System.Diagnostics.ConsoleTraceListener" initializeData="true"/> <!-- Use the following to log to file. Modify the initializeData attribute to control the path to the summary request log file. --> <!-- <add name="summaryRequestLogListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="C:\Logs\summary_logs.log"/> --> <remove name="Default"/> </listeners> </source> </sources> <switches> <!-- Use this trace switch to control the deprecation trace messages written by Ads* .NET libraries. The default is level is set to Warning. To disable all messages, set this value to Off. See msdn.microsoft.com/en-us/library/system.diagnostics.sourcelevels.aspx for all possible values this key can take. --> <add name="GoogleAds.DeprecationMessages" value="Warning"/> <!-- Use this trace switch to control the detailed request logs written by Ads* .NET libraries. The default level is set to Off. Logs are generated at both the Error and Information levels. --> <add name="GoogleAds.DetailedRequestLogs" value="Off"/> <!-- Use this trace switch to control the summary request logs written by Ads* .NET libraries. The default level is set to Off. Logs are generated at both the Error and Information levels. --> <add name="GoogleAds.SummaryRequestLogs" value="Off"/> </switches> <trace autoflush="true"/> </system.diagnostics>
Dodaj poniższy fragment kodu w sekcji
<configSections>
.<section name="system.diagnostics" type="System.Diagnostics.SystemDiagnosticsSection"/>
App.config
wygląda wtedy tak:<?xml version="1.0" encoding="utf-8"?> <configuration> <configSections> <section name="GoogleAdsApi" type="System.Configuration.DictionarySectionHandler"/> <section name="system.diagnostics" type="System.Diagnostics.SystemDiagnosticsSection"/> </configSections> <GoogleAdsApi> <!-- Google Ads API settings. --> </GoogleAdsApi> <system.diagnostics> <!-- Logging settings. --> </system.diagnostics> </configuration>