Logging

La libreria client .NET registra richieste, risposte e messaggi di riepilogo inviati all'API Google Ads. I log possono essere scritti in un TraceListener personalizzato o in un'istanza ILogger personalizzata.

TraceListener

Puoi abilitare la registrazione in un TraceListener aggiungendo la seguente riga nel metodo Main prima di effettuare chiamate 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);

Tieni presente che TraceListeners.Configure deve essere chiamato una sola volta per ciclo di vita dell'applicazione, poiché TraceListener che crea verrà riutilizzato automaticamente in tutte le richieste API effettuate dall'applicazione. Non è necessario crearne uno nuovo per ogni richiesta API.

ILogger

Se utilizzi già un ILogger per i log delle applicazioni, questa soluzione ti consente di integrare i log dell'API Google Ads nei log esistenti.

Innanzitutto, crea un LoggerFactory o, se ne hai già uno, aggiungi i filtri per i log dell'API Google Ads:

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);
});

Quindi, utilizza LoggerFactory per creare logger per riepiloghi e dettagli di richieste e risposte:

ILogger summaryLogger = loggerFactory.CreateLogger(TraceUtilities.SUMMARY_REQUEST_LOGS_SOURCE);
ILogger detailLogger = loggerFactory.CreateLogger(TraceUtilities.DETAILED_REQUEST_LOGS_SOURCE);

Infine, configura la libreria client in modo che reindirizzi le tracce alle tue istanze ILogger:

TraceUtilities.ConfigureSummaryLogger(summaryLogger);
TraceUtilities.ConfigureDetailLogger(detailLogger);

Questa soluzione consente di integrare i log di richieste e risposte dell'API Google Ads in framework di logging esistenti, come Log4Net, NLog e Serilog.

Livelli di log

La libreria registra diversi tipi di eventi a diversi livelli di log. Per una risposta API riuscita, il riepilogo viene registrato in INFO e la richiesta e le risposte complete vengono registrate in DEBUG.

In una richiesta che genera un errore API, il messaggio di riepilogo viene registrato in WARN, mentre la richiesta e la risposta complete vengono registrate in INFO.

Gli errori parziali vengono registrati in DEBUG.

ID richiesta

Nella maggior parte dei casi, i log generati dalla libreria client forniscono dettagli sufficienti per risolvere i problemi. Quando contatti il forum/gli alias di assistenza, puoi fornire i log (che oscurano le informazioni sensibili per impostazione predefinita) o semplicemente condividere l'ID richiesta (che viene registrato come parte del log di risposta).

Se preferisci acquisire l'ID richiesta manualmente, puoi utilizzare uno dei seguenti approcci:

Estrazione tramite chiamate API ordinarie

Puoi utilizzare un CallSetting personalizzato con un TrailingMetadataHandler per acquisire gli ID richiesta dalle normali chiamate unarie.

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);

Estrazione tramite chiamate API di streaming

L'ID richiesta viene restituito come parte dell'oggetto risposta per le chiamate API in streaming. Ad esempio, puoi ottenere l'ID richiesta per una chiamata SearchStream come segue:

// Get the GoogleAdsService.
GoogleAdsServiceClient googleAdsService = client.GetService(
    Services.V21.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);
        }
    }
);

Eccezioni

L'ID richiesta viene restituito nell'ambito dell'eccezione GoogleAdsException ogni volta che una chiamata API non va a buon fine.

try
{
  // Make an API call.
  ...
}
catch (GoogleAdsException e)
{
    string requestId = e.RequestId;
}

Logging avanzato

Se il log API non fornisce dettagli sufficienti, attiva la registrazione di livello inferiore a livello gRPC. Tieni presente che l'output può essere voluminoso. I log gRPC vengono scritti in stderr, ma puoi collegare il tuo logger come mostrato di seguito. Variabili di ambiente supportate.

Environment.SetEnvironmentVariable("GRPC_VERBOSITY", "DEBUG");
Environment.SetEnvironmentVariable("GRPC_TRACE", "http");
GrpcEnvironment.SetLogger(new ConsoleLogger());

Configurazione di TraceListener utilizzando App.config (legacy)

Se la tua app viene creata per un target .NET Framework, puoi caricare la configurazione della registrazione dal file App.config o Web.config dell'app. Si tratta di una funzionalità .NET legacy non supportata per le app create per le destinazioni .NET Core.

Per utilizzare questa funzionalità, devi aggiungere le seguenti modifiche al file di configurazione:

1. Aggiungi il seguente snippet nella sezione <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>
   

2. Aggiungi il seguente snippet nella sezione <configSections>.

   <section name="system.diagnostics" type="System.Diagnostics.SystemDiagnosticsSection"/>
   

   Il tuo App.config avrà il seguente aspetto:

   <?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>