Background job failure monitor: 実装から決定まで
プロンプトを実装の概要として扱います。有用な成果物は、コピーされたコードだけではなく、信頼できる答えを生成するレビューされたイベント コントラクトです。
- 1
境界を設定する
Instrument the point where job_started becomes final.
- 2
契約書を作成する
Start with job_started, job_completed, job_failed and keep every field typed, bounded, and privacy-reviewed.
- 3
フィクスチャを実行する
集計結果に依存する前に、既知の成功、失敗、再試行、および空の結果のケースを実行してください。
- 4
質問に答えてください
繰り返し失敗しているジョブはどれですか?
テンプレートとユースケースの比較
このテンプレートでイベントを追加する
測定目標がすでに明確な場合は、このテンプレートをコピーします。一致するユースケース ガイドを使用して、イベントの境界、成功の定義、および結果の SQL がサポートする必要がある決定を確認します。
テンプレート
これをコーディングエージェントに貼り付けます
交換する YOUR_API_KEY、フローをローカルで実行し、生成されたイベントとダッシュボードを確認します。
バックグラウンドジョブ失敗モニター
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 本体、または顧客コンテンツをログに記録しないでください。キャプチャするイベント
検証チェックリスト
完全なインストルメンテーション パスが後に残すもの
イベント
合成イベントは、安定した名前とフィールド タイプで目的のテーブルに到達します。
クエリ
最初の SQL クエリは、明示的な時間枠を使用して妥当な行を返します。
ビュー
ダッシュボードでは実際のフィールドが使用され、変更を説明するのに十分なコンテキストが含まれています。
安全性
プロンプト、本文、資格情報、署名、およびプライベート コンテンツの編集がチェックされました。
イベントスキーマの例
このワークフローのイベントスキーマ
クエリまたはスニペットを運用環境に適用する前に、行粒度、出力境界、必要なタイプ、プライバシー クラス、サンプル ペイロード、および検証チェックリストを確認してください。
関連製品の機能
このワークフローを続行します アラート
レビューされた信頼性クエリを、所有するしきい値と応答のワークフローにプロモートします。
関連する SQL レシピ
その他のSQL例
このワークフローの構造化フィールドに対してクエリを実行し、結果の例を検査して、有用な回答をダッシュボードまたはアラートに変換します。
バックグラウンドジョブの再試行と失敗率を測定する
どのバックグラウンド ジョブが再試行を最も多く消費するか、または依然として失敗するのはどれですか?
レシピを開くSQL で停止したバックグラウンド ジョブを見つける
開始されたが、最終イベントを生成しなかったジョブはどれですか?
レシピを開く配信不能キューの増加を測定する
デッドレター ジョブを解決するよりも早く追加しているキューはどれですか?
レシピを開く欠落した Cron スケジュールの検出
スケジュールされたジョブは、文書化された間隔よりも遅く実行されましたか?
レシピを開くバックグラウンドジョブの再試行ストームを検出する
現在、再試行に最も多くの時間を費やしている職種はどれですか?
レシピを開くその他のテンプレート