Skip to content

詳細なログ記録

詳細なログ出力は、Braze SDKからの詳細かつ低レベルな情報を提供する。これにより、SDKの初期化方法、サーバーとの通信方法、プッシュ通知、アプリ内メッセージ、コンテンツカードといったメッセージングチャネルの処理方法が可視化される。

何かが期待通りに動作しない場合——例えばプッシュ通知が届かない、アプリ内メッセージが表示されない、ユーザーデータが同期されない——詳細ログは根本原因の識別に役立つ。推測する代わりに、SDKが各ステップで何をしているかを正確に確認できる。

詳細ログを記録するタイミング

必要な時に詳細ログを有効にしろ：

  • SDKの初期化を確認する：SDKが正しいAPIキーとエンドポイントで正しく起動することを確認せよ。
  • メッセージ配信のトラブルシューティング：プッシュトークンが登録されているか、アプリ内メッセージがトリガーされているか、コンテンツカードが同期されているかを確認する。
  • ディープリンクをデバッグする：SDKがプッシュ通知、アプリ内メッセージ、またはコンテンツカードからのディープリンクを受信し、開封することを確認せよ。
  • セッショントラッキングを検証する：セッションの開始と終了が予定通りであることを確認する。
  • 接続の問題を診断する：SDKとBrazeサーバー間のネットワークリクエストとレスポンスを検査する。

詳細ログ記録のイネーブルメント

メソッドApplication.onCreate()内で他のSDK呼び出しを行う前に詳細ログ記録をイネーブルにすると、最も完全な出力を取得できる。

コードでは：

1

BrazeLogger.setLogLevel(Log.VERBOSE);

1

BrazeLogger.logLevel = Log.VERBOSE

In braze.xml:

1

<integer name="com_braze_logger_initial_log_level">2</integer>

詳細ログのイネーブルメントを確認するには、Logcat出力で`V/Brazeverbose`を検索する。以下に例を示します。

1

2077-11-19 16:22:49.591 ? V/Braze v9.0.01 .bo.app.d3: Request started

詳細については、Android SDKのロギングを参照せよ。

初期化時に、オブジェクトBraze.Configurationのログ.debugレベルを に設定する。

1
2
3
4
5
6

let configuration = Braze.Configuration(
  apiKey: "<BRAZE_API_KEY>",
  endpoint: "<BRAZE_ENDPOINT>"
)
configuration.logger.level = .debug
let braze = Braze(configuration: configuration)

1
2
3
4

BRZConfiguration *configuration = [[BRZConfiguration alloc] initWithApiKey:@"<BRAZE_API_KEY>"
                                                                  endpoint:@"<BRAZE_ENDPOINT>"];
[configuration.logger setLevel:BRZLoggerLevelDebug];
Braze *braze = [[Braze alloc] initWithConfiguration:configuration];

レベル.debugは最も詳細な出力を示すため、トラブルシューティングに推奨される。詳細については、SWIFT SDKのロギングを参照せよ。

URLパラメータとして`add?brazeLogging=true`を追加するか、SDK初期化時にロギングのイネーブルメントを行う。

1
2
3
4

braze.initialize('YOUR-API-KEY', {
    baseUrl: 'YOUR-SDK-ENDPOINT',
    enableLogging: true
});

初期化後にログ記録のオンオフを切り替えることもできる。

1

braze.toggleLogging();

ログはブラウザの開発者の開発ツールのコンソールタブに表示される。詳細については、Web SDKのログ記録を参照せよ。

  1. [Braze] > [Braze 構成] の順に移動して、[Braze 構成設定] を開きます。
  2. 「Show Braze Android 設定」ドロップダウンを選択する。
  3. SDKログレベルフィールドに「.」と入力する0。

SDK設定時にログレベルを設定する：

1
2

const configuration = new Braze.BrazeConfiguration('YOUR-API-KEY', 'YOUR-SDK-ENDPOINT');
configuration.logLevel = Braze.LogLevel.Verbose;

ログの収集

詳細ログ記録のイネーブルメント後、トラブルシューティング対象の問題を再現し、プラットフォームのコンソールまたはデバッグツールからログを収集する。

Android StudioでLogcatを使ってログをキャプチャする：

  1. デバイスを接続するか、エミュレータを起動する。
  2. Android Studioで、下部のパネルからLogcatを開け。
  3. またはV/Brazeでフィルターをかけて、D/BrazeBraze SDKの出力を分離する。
  4. 問題を再現する。
  5. 関連するログをコピーして、テキストファイルに保存する。

MacOSのコンソールアプリを使ってログをキャプチャする：

  1. 詳細ログ記録を有効にした状態で、アプリを端末にインストールせよ。
  2. デバイスをMacに接続せよ。
  3. コンソールアプリを開封し、デバイスのサイドバーから自分のデバイスを選ぶ。
  4. 検索バーで BrazeKitまたは Brazeでフィルターをかける。
  5. 問題を再現する。
  6. 関連するログをコピーして、テキストファイルに保存する。

ブラウザの開発者ツールを使え：

  1. ブラウザの開発者ツールを開封（通常はF12キーかCmd+Option+Iキーだ）。
  2. コンソールタブに移動する。
  3. 問題を再現する。
  4. コンソールの出力をコピーして、テキストファイルに保存しろ。

冗長なログを読む

詳細ログは一貫した構造に従っているため、SDKの動作を追跡するのに役立つ。特定のチャネルのログ出力を学習する方法、具体的には確認すべきキーエントリや一般的なトラブルシューティングパターンについては、「詳細ログの読み方」を参照せよ。

Brazeサポートとのログ共有

SDKに関する問題でBrazeサポートに連絡する際は、以下の情報を含めてください：

  1. 詳細なログファイル：アプリ起動前から問題発生までの完全なログ記録。
  2. 再現ステップ：問題をトリガーするアクションの明確な説明。
  3. 期待される動作と実際の動作：君が予想していたことと、実際に起きたこと。
  4. SDKバージョン：使用しているBraze SDKのバージョン。
  5. プラットフォームとOSのバージョン：例えば、iOS 18.0、Android 14、あるいはChrome 120といったものだ。
Github   GitHub でこのページを編集
New Stuff!