本文へ移動
Telemetry
イベント記録のテンプレート

バックグラウンドジョブ失敗モニター

最初の実行から再試行と失敗に至るまで、キュー、cron、インポート、請求同期、および Webhook ジョブの健全性をキャプチャします。

レビュー者 Telemetry 製品チーム . イベント名、推奨項目、クエリで答える問い、除外するデータを確認しました. このページのレビュー担当

これにより解き明かされる質問
  • 繰り返し失敗しているジョブはどれですか?
  • どのキューが遅れているのでしょうか?
  • p95 の持続時間が最も悪いジョブ名はどれですか?
テンプレートの証拠パス

Background job failure monitor: 実装から決定まで

プロンプトを実装の概要として扱います。有用な成果物は、コピーされたコードだけではなく、信頼できる答えを生成するレビューされたイベント コントラクトです。

  1. 1

    境界を設定する

    Instrument the point where job_started becomes final.

  2. 2

    契約書を作成する

    Start with job_started, job_completed, job_failed and keep every field typed, bounded, and privacy-reviewed.

  3. 3

    フィクスチャを実行する

    集計結果に依存する前に、既知の成功、失敗、再試行、および空の結果のケースを実行してください。

  4. 4

    質問に答えてください

    繰り返し失敗しているジョブはどれですか?

テンプレートとユースケースの比較

このテンプレートでイベントを追加する

測定目標がすでに明確な場合は、このテンプレートをコピーします。一致するユースケース ガイドを使用して、イベントの境界、成功の定義、および結果の SQL がサポートする必要がある決定を確認します。

読み取り バックグラウンドジョブの監視

テンプレート

これをコーディングエージェントに貼り付けます

交換する YOUR_API_KEY、フローをローカルで実行し、生成されたイベントとダッシュボードを確認します。

job-failure-monitor

バックグラウンドジョブ失敗モニター

text
Telemetry を使用してバックグラウンド ジョブを計測します。

/skill.md とこの Telemetry API キーを使用します: YOUR_API_KEY

job_started、job_completed、job_failed、job_retried、および dead_letter_created を次のように記録します。
job_name、queue_name、試行、status、duration_ms、scheduled_at、started_at、completed_at、item_count、retry_count、 worker_name、error_type。

ジョブごとのスループット、ジョブごとの失敗、p95 の期間、再試行量、停止したジョブ、および最新の配信不能イベントに関するクエリとダッシュボードを作成します。

未処理のジョブ ペイロード、認証情報、Webhook 本体、または顧客コンテンツをログに記録しないでください。

キャプチャするイベント

job_startedjob_completedjob_failedjob_retrieddead_letter_created

検証チェックリスト

完全なインストルメンテーション パスが後に残すもの

イベント

合成イベントは、安定した名前とフィールド タイプで目的のテーブルに到達します。

クエリ

最初の SQL クエリは、明示的な時間枠を使用して妥当な行を返します。

ビュー

ダッシュボードでは実際のフィールドが使用され、変更を説明するのに十分なコンテキストが含まれています。

安全性

プロンプト、本文、資格情報、署名、およびプライベート コンテンツの編集がチェックされました。

イベントスキーマの例

クエリまたはスニペットを運用環境に適用する前に、行粒度、出力境界、必要なタイプ、プライバシー クラス、サンプル ペイロード、および検証チェックリストを確認してください。

関連製品の機能

このワークフローを続行します アラート

レビューされた信頼性クエリを、所有するしきい値と応答のワークフローにプロモートします。

関連する SQL レシピ

その他のSQL例

このワークフローの構造化フィールドに対してクエリを実行し、結果の例を検査して、有用な回答をダッシュボードまたはアラートに変換します。

すべてのレシピを参照する
クエリ例のコレクションバックグラウンドジョブ SQL

その他のテンプレート