Skip to content

同期ログと可観測性

クラウドデータ取り込み（CDI）の同期ログダッシュボードでは、CDIによって処理された全データを監視し、データの同期が正常に行われたかどうかを確認し、「不正」または欠落したデータに関する問題を診断できます。

同期ログにアクセスするには、データ設定 > クラウドデータ取り込みに移動し、同期ログタブを選択します。

同期ログダッシュボードについて

メインの同期ログページでは、すべての同期実行の概要を俯瞰できます。これには、現在のステータスまたは最終ステータスに基づく最近の同期の概要も含まれます。

  • Running: 現在進行中の同期ジョブです。
  • Success: 同期ジョブが完了し、すべての行が正常に処理されました。
  • Partial Success: 同期ジョブが完了しましたが、1つ以上の行でエラーが発生しました。
  • Error: 同期ジョブが完了できませんでした。
  • Limit Exceeded: データ制限を超えたために処理が停止した同期ジョブです。

合計6,576件の成功を記録した同期ログの例。

同期ログは、各同期について以下の詳細も提供します。

  • 同期名: 同期設定の名前です。
  • 実行ID: 同期の特定の実行に対する一意の識別子です。このIDを選択すると、詳細が表示されます。これはCDI APIエンドポイントでも使用できます。また、Brazeサポートに同期実行を問い合わせる際にも利用できます。
  • ステータス: 実行のステータス（成功、部分的な成功、エラー、実行中）です。
  • ソースから読み込んだ新しい行: この実行でデータウェアハウスから取得した新規行の数です。
  • 結果: 実行中に成功した行数と失敗した行数の内訳です。
  • 最終 UPDATED_AT: この同期実行で処理された最新のレコードのタイムスタンプです。
  • 実行開始時刻: 同期ジョブが開始された時刻です。
  • 実行時間: 同期ジョブが完了するまでに要した合計時間です。

同期ログの詳細。

データリテンション

同期ログデータは、すべての行レベルのペイロードとエラー詳細を含め、最大30日間保持されます。30日以上経過したログは自動的に削除されます。

同期実行のメタデータ（処理された行数など）は、少なくとも12か月間保持されます。

同期ログのフィルタリング

同期ログテーブルにフィルターをかけると、特定の実行を見つけることができます。利用可能なフィルターには以下が含まれます。

  • ジョブ開始日: あらかじめ定義された範囲（「過去30日間」など）またはカスタムの日付範囲を選択します。
  • ステータス: 1つ以上の同期ステータスでフィルターします（例えば、ErrorとPartial Successステータスのみを表示します）。
  • 同期名: 特定の同期を名前で検索します。

特定の同期を調査するには、同期ログテーブルから該当する実行IDを選択します。実行詳細ページでは、同期の行単位の詳細なログを確認できます。

実行概要

このセクションでは、選択された実行の概要を示します。これには開始時刻、終了時刻、実行時間、およびソースから読み込まれた行の総数が含まれます。また、成功した行数とエラーが発生した行数のカウントも提供します。

この実行で処理された行

このテーブルは同期処理中に処理されたデータについて行単位の可視性を提供し、個々のレコードを検証できるようにします。

  • 検索: 実行結果の中から特定のユーザーを検索するには、ユーザーIDで検索バーを使用できます。
  • 利用可能な詳細:
    • UPDATED_AT: その特定の行のUPDATED_ATカラムからのタイムスタンプです。
    • ID: レコードをBrazeユーザープロファイルに照合するために使用されるユーザー識別子（external_id、email、alias_nameなど）です。
    • ステータス: その行の個別処理ステータス（SuccessまたはError）です。
    • ソースペイロード: データペイロードを表示するリンクです。
    • エラー理由: ステータスがErrorの場合、この列には行の同期が失敗した理由を説明するメッセージが表示されます。

ペイロードの表示

特定の行についてBrazeに送信された正確なデータを確認するには、ソースペイロード列でView payloadを選択します。これにより、そのユーザーに対して処理された生のJSONペイロードが表示されます。

同期ログ内の特定の行に対するペイロードの例。

同期ログのエクスポート

Export rowsを選択すると、同期実行の行レベルログをエクスポートできます。次に、エクスポート方法を選択します。

  • エラーのある行: Errorステータスの行のみを含むファイルをダウンロードします。
  • すべての行: 実行中に処理されたすべての行を含むファイルをダウンロードします。

ログはダッシュボードから直接エクスポートできません。エクスポートが生成された後、ログエクスポートファイルをダウンロードするためのリンクが記載されたメールが届きます。

通知

CDI同期のステータスについて最新情報を得るために、メール通知を設定できます。これらの設定は同期を作成する際に構成され、いつでも更新できます。

エラー通知

同期レベルのエラー通知を受け取るには、少なくとも1つのメールアドレスの連絡先が必要です。これらのアラートは、同期ジョブ全体が実行または完了に失敗した場合、または認証情報の期限切れやソーステーブルの欠落など、ユーザーの介入が必要なエラーが同期中に発生した場合に送信されます。

追加の通知には以下が含まれます。

  • 行エラー: 同期処理において、一定割合の行の更新に失敗した場合にアラートを受け取ります。
  • 失敗閾値（%）: アラートをトリガーする行の失敗率を指定します。例えば、これを1に設定すると、同期実行でエラーが発生した行が1%以上ある場合に通知が送信されます。
  • 同期成功: 同期が正常に完了した際に通知を受け取ります。
  • 行が変更されなくても通知する: 同期処理が正常に完了し、新規または更新された行がゼロ件であっても通知を受け取ります。
New Stuff!