コンテンツにスキップ

エラー管理

DQSアプリケーションのエラーモニタータブは、スキャン処理中に発生するエラーを監視・解決するための専用インターフェースです。バッチの失敗、ストラテジーエラー、プラットフォームの問題をすべて一か所で完全に可視化できます。

Error Management Consoleは3ゾーンレイアウトを使用します:

  • フィルターサイドバー(左)— エラータイプ、ソースクラス、エラーメッセージ、時間範囲(From/To)、IPアドレスでエラーをフィルタリングします。Breakdownsセクションは、タイプ、ソース、またはその他の条件でエラーをグループ化し、迅速なトリアージのために各カテゴリの横にカウントを表示します。
  • エラーログテーブル(中央)— すべてのエラーをサマリー列とともにリスト表示するソート可能なテーブルです。直近24時間、直近7日間、および期限切れ間近の3つの時間ウィンドウにわたるエラーの合計数を表示します。任意の行をクリックすると詳細情報が表示されます。
  • アクションパネル(右)— ログの更新、ダウンロード可能なCSVエクスポートの作成、選択したエントリの削除、保持期間の設定が行えます。

フィルターサイドバー(左)、エラーログテーブル(中央)、アクションパネル(右)を示すError Management Console

テーブルの各エラー行には以下の列が表示されます:

説明
Error IDエラーログエントリの一意の識別子
Typeエラーカテゴリ(例:DML_FAILEDQUERY_FAILEDFIELD_INSERT_FAILEDBATCH_EXECUTE_FAILED
Message短いエラーの説明(省略表示 — 行をクリックすると全文を確認できます)
Sourceエラーを生成したApexクラス(例:DQS_ExportFileServiceDQS_DynamicQueryBuilder01
Event Timeエラーが発生した日時のタイムスタンプ

テーブルの上部には集計カウンター(Total ErrorsLast 24 HoursLast 7 DaysExpiring Soon)が表示され、ヘルス状況を一目で把握できます。

任意のエラー行をクリックすると、完全なコンテキストを含む詳細モーダルが開きます:

  • Error IDType(識別しやすいよう赤でハイライト)
  • Source — エラーの発生元となったApexクラス
  • uniqueIdentifier_01 — 関連するレコードまたはバッチ識別子
  • Insert Type — 操作がinsert、update、またはその他のDMLタイプであったかどうか
  • Event TimeFirst Event Time — エラー発生のタイムスタンプ
  • Message — Salesforceの例外タイプを含む完全なエラーメッセージ(例:System.AsyncExceptionSystem.DmlException
  • Stack Trace — デバッグ用の完全なApexスタックトレース

Error ID、タイプ、ソース、タイムスタンプ、完全なメッセージ、スタックトレースを示すエラー詳細モーダル

ソース
バッチ処理ガバナーリミット超過、クエリタイムアウト
ディメンションストラテジー無効な項目アクセス、ストラテジーロジック内のnullポインター
Platform Eventsイベント発行の失敗
スケジューリングCRON式の問題、権限エラー

DQSはDQS_Processing_Error__e Platform Eventsを使用して、リアルタイムでエラーを表示します。バッチ処理中にエラーが発生すると:

  1. エラーがキャッチされてログに記録されます
  2. Platform Eventが発行されます
  3. EMCがイベントを受信して表示します

これにより、サイレントなcatchブロックが可視化されたエラーレポートに置き換えられます。

エラーログは、設定された保持期間に基づいて自動的にパージされます。デフォルトの保持期間は7日です。

保持期間を変更するには、コンソール右側のアクションパネルにあるRetention Configurationセクションを使用します。Error Log Retention (days)フィールドに希望する日数を入力してSaveをクリックします。指定した期間より古いエラーログは自動的にパージされます。変更はMetadata APIを通じてデプロイされるため、反映まで少し時間がかかる場合があります。

Error Log Retention(days)フィールドが6日に設定されているRetention Configurationパネル

  • 新しいスキャン定義を設定した後はEMCを定期的に確認する
  • ケイパビリティ構成を変更した後にエラーをレビューする
  • エラーパターンを使用してシステム的な問題を特定する(例:項目アクセス権限)
  • Expiring Soonカウンターを使用して、自動パージされる前にエラーをレビューする
  • 長期的な分析が必要な場合は、期限切れになる前にエラーログをCSVにエクスポートする
  • 複数のスキャンにわたってプラットフォームエラーが続く場合はサポートに連絡する