로깅

이 라이브러리는 Google Ads API와의 상호작용을 기록하도록 사용할 수 있습니다. 다음과 같이 자세한 요청과 응답을 로깅할 수 있습니다. 더 간결한 요약 메시지도 제공합니다 이러한 설정은 클라이언트 라이브러리 구성을 참조하세요. 다음은 사용 가능한 여러 유형의 구성 옵션도 제공합니다.

이 라이브러리는 Python의 기본 제공 로깅을 사용합니다. 기본적으로 stderr에 로깅합니다. 포함된 경우 logging 객체 생성된 모든 포드가 logging.config.dictConfig dict로 표현됩니다.

로깅을 설정하여 프로그래매틱 방식으로 로깅을 구성할 수도 있습니다. 구성 전에 구성 설정을 확인하세요. Cloud Shell에서 클라이언트를 검색하여 다음 예를 사용하여 logger 인스턴스를 구성합니다.

import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)

클라이언트 로거는 클라이언트가 초기화될 때 구성됩니다. 모든 문자 이후에 로깅 구성에 대한 변경사항은 무시됩니다. 목표: YAML 파일에서 로깅 구성을 프로그래매틱 방식으로 재정의하려면 클라이언트가 초기화되기 전에 위의 줄을 호출합니다.

로그 수준

클라이언트는 몇 가지 다양한 수준에서 로그를 생성하며, 구성을 클릭하여 아래 일부 또는 전체를 표시합니다.

수준 요청 완료 실패한 요청
DEBUG 전체 요청 및 응답 객체가 JSON인 자세한 로그입니다. 완전한 요청 및 예외 객체가 JSON인 자세한 로그입니다.
INFO 특정 요청 및 응답 필드가 포함된 간결한 요약입니다. 완전한 요청 및 예외 객체가 JSON인 자세한 로그입니다.
WARNING 없음 특정 요청 정보, 예외 상태, 메시지가 포함된 간결한 요약입니다.

Python 로깅 프레임워크는 덜 심각한 로그 메시지를 무시하므로 WARNING로 설정하면 실패한 요청과 관련된 간결한 메시지이지만, DEBUG로 설정하면 위의 표에 가능한 모든 유형의 로그가 표시됩니다.

파일에 로깅

로그 메시지를 쉽게 파일로 보낼 수 있습니다. 예를 들어 get_campaigns 예:

python get_campaigns.py -c $CLIENT_ID 2> example.log

로깅 인터셉터

Python 클라이언트 라이브러리는 gRPC를 사용 인터셉터: 액세스 및 로그 요청 확인할 수 있습니다 gRPC를 만들어 자체 커스텀 로깅을 설정할 수 있습니다. 인터셉터입니다. 자세한 내용은 로깅 가이드 커스텀 로깅 인터셉터의 예시와 자세한 내용을 참조하세요.