ロギング

Logging は、Java 用の汎用ロギング ライブラリである SLF4J を使用して構成されています。 を使用すると、ログをさまざまなロギング実装に転送できます。Google の log4j 1.2/2 および Java Util Logging（JUL）用の設定ファイルです。

ロギングのレイアウトと機能

リクエストは、1 行の概要と完全なリクエスト/レスポンス本文とともにログに記録されます。 使用します。

ログタイプ ログ名 成功レベル 障害レベル
概要 com.google.ads.googleads.lib.request.summary 情報 WARN
詳細 com.google.ads.googleads.lib.request.detail デバッグ 情報

詳細ログの切り捨て

デフォルトでは、詳細なログは切り捨てられ、大きなログが作成されなくなります。宛先 ログが切り捨てられる長さの変更、 -Dapi.googleads.maxLogMessageLength=<number>。-1 を設定すると、次のようになります。 使用します。

Log4j 2

  1. log4j-slf4j-impl ライブラリへの依存関係を追加します。 2.x.y は、プロジェクトで使用している Log4j 2 のバージョンに置き換えます。

    <dependency>
  <groupId>org.apache.logging.log4j</groupId>
  <artifactId>log4j-slf4j-impl</artifactId>
  <version>2.x.y</version>
</dependency>

  2. （省略可）リソース ディレクトリに構成ファイルを作成し、 Maven での例: src/main/resourcesLog4j 2 がその構成を読み込む ファイルは、作業ディレクトリではなくクラスパスから作成するので、 リソース ディレクトリにあります。

  3. 次のように指定して、アプリケーションを実行します。 -Dlog4j.configurationFile=<CONFIG_FILE_PATH>。このように CONFIG_FILE_PATH=googleads-logging/log4j2.xml: デフォルトを使用します。 構成ファイルを使用します。

Log4j 1.2（レガシー）

  1. slf4j-log4j12 ライブラリへの依存関係を追加します。1.x.y を以下に置き換えます。 プロジェクトで使用している Log4j 1.2 のバージョン。

    <dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-log4j12</artifactId>
  <version>1.x.y</version>
</dependency>

  2. （省略可）プロジェクトのリソース ディレクトリに構成ファイルを作成します。 たとえば、Maven ではパスは src/main/resources です。Log4j 1.2 は、 構成ファイルからすべての構成ファイルを リソース ディレクトリにコピーします。

  3. -Dlog4j.configuration=<CONFIG_FILE_PATH> を指定してアプリケーションを実行します。 使用する CONFIG_FILE_PATH=googleads-logging/log4j.properties を指定すると、 デフォルトの構成ファイルを使用します。

Java ユーティリティ ロギング

  1. slf4j-jdk14 ライブラリへの依存関係を追加します。

    <dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-jdk14</artifactId>
  <version>1.7.25</version>
</dependency>

  2. ファイル システム上で、読み取り可能なパスに JUL 構成ファイルを作成する アプリケーション（例: ./jdk-logger.properties）テンプレートは 提供 google-ads/src/main/resources/googleads-logging/jdk-logger.properties。7 月 はファイル システムからのみ読み取られるため、resources ディレクトリにはコピーしないでください。

  3. 以下を指定してアプリケーションを実行します。 -Djava.util.logging.config.file=./jdk-logger.properties。