Để thảo luận và đưa ra ý kiến phản hồi về các sản phẩm của chúng tôi, hãy tham gia kênh Discord chính thức của Google Ads trong máy chủ Cộng đồng quảng cáo và đo lường của Google.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tính năng ghi nhật ký được định cấu hình bằng SLF4J, một thư viện ghi nhật ký chung cho Java, cho phép chuyển nhật ký đến nhiều cách triển khai ghi nhật ký khác nhau. Chúng tôi cung cấp các tệp cấu hình cho log4j 1.2/2 và Java Util Logging (JUL).
Bố cục và chức năng ghi nhật ký
Các yêu cầu được ghi nhật ký bằng một dòng tóm tắt và toàn bộ nội dung yêu cầu/phản hồi cũng như tiêu đề.
Loại nhật ký
Tên nhật ký
Cấp độ thành công
Cấp độ lỗi
TÓM TẮT
com.google.ads.googleads.lib.request.summary
INFO (THÔNG TIN)
WARN (CẢNH BÁO)
CHI TIẾT
com.google.ads.googleads.lib.request.detail
DEBUG (Gỡ lỗi)
INFO (THÔNG TIN)
Cắt bớt nhật ký chi tiết
Theo mặc định, nhật ký chi tiết sẽ bị cắt bớt để tránh tạo nhật ký có kích thước lớn. Để thay đổi độ dài mà nhật ký bị cắt bớt, hãy đặt -Dapi.googleads.maxLogMessageLength=<number>. Việc đặt -1 sẽ tắt tính năng cắt bớt nhật ký.
Log4j 2
Thêm một phần phụ thuộc vào thư viện log4j-slf4j-impl, thay thế 2.x.y bằng phiên bản Log4j 2 mà bạn đang dùng trong dự án.
(Không bắt buộc) Tạo một tệp cấu hình trong thư mục tài nguyên, ví dụ: trong Maven: src/main/resources. Log4j 2 tải tệp cấu hình từ đường dẫn lớp chứ không phải thư mục đang hoạt động, vì vậy, hãy đảm bảo bạn tạo trong thư mục tài nguyên.
Chạy ứng dụng của bạn, chỉ định -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Bạn có thể chỉ định CONFIG_FILE_PATH=googleads-logging/log4j2.xml để sử dụng tệp cấu hình mặc định có trong thư viện ứng dụng.
Log4j 1.2 (cũ)
Thêm phần phụ thuộc vào thư viện slf4j-log4j12, thay thế 1.x.y bằng phiên bản Log4j 1.2 mà bạn đang dùng trong dự án.
(Không bắt buộc) Tạo một tệp cấu hình trong thư mục tài nguyên của dự án, ví dụ: trong Maven, đường dẫn là src/main/resources. Log4j 1.2 tải tệp cấu hình từ đường dẫn lớp, chứ không phải thư mục đang hoạt động, vì vậy, hãy đảm bảo bạn sao chép vào một thư mục tài nguyên.
Chạy ứng dụng của bạn, chỉ định -Dlog4j.configuration=<CONFIG_FILE_PATH>.
Bạn có thể chỉ định CONFIG_FILE_PATH=googleads-logging/log4j.properties để sử dụng tệp cấu hình mặc định có trong thư viện ứng dụng.
Tạo một tệp cấu hình JUL trên hệ thống tệp theo một đường dẫn có thể đọc được từ ứng dụng của bạn (ví dụ: ./jdk-logger.properties). Một mẫu được cung cấp tại google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL chỉ đọc từ hệ thống tệp, vì vậy, đừng sao chép vào thư mục tài nguyên.
Chạy ứng dụng của bạn bằng cách chỉ định -Djava.util.logging.config.file=./jdk-logger.properties.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-27 UTC."],[[["\u003cp\u003eLogging is managed through SLF4J, offering flexibility with log4j 1.2/2 and Java Util Logging configurations.\u003c/p\u003e\n"],["\u003cp\u003eRequest logging includes a summary line along with detailed request/response bodies and headers at configurable log levels.\u003c/p\u003e\n"],["\u003cp\u003eDetailed logs are truncated by default, adjustable via the \u003ccode\u003e-Dapi.googleads.maxLogMessageLength\u003c/code\u003e system property.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration instructions and examples are provided for setup with Log4j 2, Log4j 1.2, and Java Util Logging.\u003c/p\u003e\n"]]],[],null,["# Logging is configured with SLF4J a generic logging library for Java, which\nallows logs to be directed to many different logging implementations. We provide\nconfiguration files for log4j 1.2/2 and Java Util Logging (JUL).\n\nLogging layout and functionality\n--------------------------------\n\nRequests are logged with a one line summary and the full request/response body\nand headers.\n\n| Log type | Log name | Success level | Failure level |\n|----------|----------------------------------------------|---------------|---------------|\n| SUMMARY | com.google.ads.googleads.lib.request.summary | INFO | WARN |\n| DETAIL | com.google.ads.googleads.lib.request.detail | DEBUG | INFO |\n\n| **Key Point:** Mutate requests where [Partial\n| failure](/google-ads/api/samples/handle-partial-failure) is true won't cause the entire request to fail. Thus, partial failure logs are always logged at Success level, not at Failure level as might be expected.\n\nDetail Log Truncation\n---------------------\n\nThe detailed logs are truncated by default to avoid creating large logs. To\nchange the length at which logs are truncated, set\n`-Dapi.googleads.maxLogMessageLength=\u003cnumber\u003e`. Setting `-1` disables\nlog truncation.\n\nLog4j 2\n-------\n\n1. Add a dependency on the `log4j-slf4j-impl` library, substituting\n `2.x.y` with the version of Log4j 2 you are using in your project.\n\n \u003cdependency\u003e\n \u003cgroupId\u003eorg.apache.logging.log4j\u003c/groupId\u003e\n \u003cartifactId\u003elog4j-slf4j-impl\u003c/artifactId\u003e\n \u003cversion\u003e2.x.y\u003c/version\u003e\n \u003c/dependency\u003e\n\n2. (Optional) Create a configuration file in your resources directory, for\n example, in Maven: `src/main/resources`. Log4j 2 loads its configuration\n file from the classpath, not the working directory, so ensure you create in a\n resources directory.\n\n3. Run your application, specifying\n `-Dlog4j.configurationFile=\u003cCONFIG_FILE_PATH\u003e`. You can specify\n `CONFIG_FILE_PATH=googleads-logging/log4j2.xml` to use the default\n configuration file included with the client libraries.\n\nLog4j 1.2 (legacy)\n------------------\n\n1. Add a dependency on the `slf4j-log4j12` library, substituting `1.x.y` with\n the version of Log4j 1.2 you are using in your project.\n\n \u003cdependency\u003e\n \u003cgroupId\u003eorg.slf4j\u003c/groupId\u003e\n \u003cartifactId\u003eslf4j-log4j12\u003c/artifactId\u003e\n \u003cversion\u003e1.x.y\u003c/version\u003e\n \u003c/dependency\u003e\n\n2. (Optional) Create a configuration file in your projects resources directory,\n for example, in Maven, path is `src/main/resources`. Log4j 1.2 loads its\n configuration file from the classpath, not the working directory, so ensure\n you copy to a resources directory.\n\n3. Run your application, specifying `-Dlog4j.configuration=\u003cCONFIG_FILE_PATH\u003e`.\n You can specify `CONFIG_FILE_PATH=googleads-logging/log4j.properties` to use\n the default configuration file includedwith the client libraries.\n\nJava Util Logging\n-----------------\n\n1. Add a dependency on the `slf4j-jdk14` library.\n\n \u003cdependency\u003e\n \u003cgroupId\u003eorg.slf4j\u003c/groupId\u003e\n \u003cartifactId\u003eslf4j-jdk14\u003c/artifactId\u003e\n \u003cversion\u003e1.7.25\u003c/version\u003e\n \u003c/dependency\u003e\n\n2. Create a JUL configuration file on the file system in a path readable from\n your application (for instance, `./jdk-logger.properties`). A template is\n provided at\n `google-ads/src/main/resources/googleads-logging/jdk-logger.properties`. JUL\n reads from the filesystem only, so do not copy to the resources directory.\n\n3. Run your application specifying\n `-Djava.util.logging.config.file=./jdk-logger.properties`."]]
