詳細なログ記録

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

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

ヒント

手動で詳細ログのイネーブルメントをせずにデバッグしたい場合、SDKデバッガーを使ってBrazeダッシュボード内で直接デバッグセッションを作成できる。

詳細ログの使用タイミング

以下のような場合に詳細ログを有効にしてください。

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

注

カスタムイベントやセッションがBrazeに表示されない場合は、他のSDK呼び出しの前に詳細ログを有効にし、テストデバイスで再現して、changeUserが期待するユーザーIDで実行されていることを確認してください。ログの収集セクションの手順に従って、ログをサポートに共有してください。セッションおよびイベント行の解釈については、詳細ログの読み方を参照してください。

詳細ログの有効化

重要

詳細ログは開発環境およびテスト環境でのみ使用することを想定しています。機密情報が露出するのを防ぐため、本番環境にアプリをリリースする前に詳細ログを無効にしてください。

• android
• swift
• web
• unity
• react native

1

BrazeLogger.setLogLevel(Log.VERBOSE);

1

BrazeLogger.logLevel = Log.VERBOSE

1

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

1

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

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];

1
2
3
4

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

1

braze.toggleLogging();

1
2

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

ログの収集

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

• android
• ios
• web

ヒント

Brazeサポートのためにログを収集する場合は、アプリを起動する前にログの記録を開始し、問題が発生した後も十分な時間が経過するまで記録を続けてください。これにより、イベントの完全なシーケンスをキャプチャできます。

詳細ログの読み取り

詳細ログは一貫した構造に従っており、SDKの動作を追跡するのに役立ちます。特定のチャネルのログ出力の解釈方法（注目すべき主要なエントリや一般的なトラブルシューティングパターンなど）については、詳細ログの読み取りを参照してください。

Braze サポートとのログ共有

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

1. 詳細ログファイル: アプリ起動前から問題発生時までの完全なログキャプチャ。
2. 再現手順: 問題を引き起こすアクションの明確な説明。
3. 期待される動作と実際の動作: 期待していた動作と、実際に起こった動作。
4. SDK バージョン: 使用している Braze SDKのバージョン。
5. プラットフォームと OS バージョン: 例: iOS 18.0、Android 14、Chrome 120。