Logging

As solicitações, respostas e mensagens de resumo feitas à API Google Ads podem ser registradas com seu próprio registrador personalizado ou com o registrador padrão na biblioteca de cliente para Perl.

Níveis de registro

A biblioteca registra diferentes tipos de eventos em diferentes níveis de registro. Em uma resposta de API bem-sucedida, o resumo é registrado em INFO, e a solicitação e a resposta completas são registradas em DEBUG. Em uma solicitação que resulta em um erro de API, a mensagem de resumo é registrada em WARN, e a solicitação e a resposta completas são registradas em INFO.

Tipo de registro	Nome do registro	Nível de sucesso	Nível de falha
RESUMO	Google.Ads.GoogleAds.Summary	INFO	WARN
DETALHE	Google.Ads.GoogleAds.Detail	DEBUG	INFO

Em caso de falhas parciais, os detalhes são registrados no logger DETAIL em DEBUG.

Configuração

A biblioteca de cliente usa uma classe personalizada para todas as finalidades de geração de registros e é exposta pelo módulo GoogleAdsLogger. Essa classe fornece uma configuração padrão em que os gravadores de registros de resumo e detalhes gravam em arquivos na pasta logs no diretório HOME.

Personalizar a configuração do Log4perl

É possível substituir a configuração padrão fornecendo um arquivo log4perl.conf personalizado no diretório HOME ou inicializando Log::Log4perl diretamente no aplicativo antes de fazer chamadas de API.

Ativar ou desativar registros

A geração de registros pode ser ativada ou desativada de forma programática usando os seguintes métodos auxiliares:

• Ative a geração de registros para os dois loggers (transmita 1 para definir o nível como DEBUG para que os payloads completos de solicitação e resposta sejam registrados em chamadas bem-sucedidas):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• Desative toda a geração de registros:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();
  

• Desative a geração de registros de resumo:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
  

• Desative a geração de registros detalhada:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
  

É possível usar os métodos da classe GoogleAdsLogger diretamente para ter ainda mais controle sobre como as solicitações são registradas.