本文へ移動
Telemetry
キュー、cron ジョブ、インポート、非同期ワーカーを実行しているチーム向け

バックグラウンドジョブの監視

構造化イベントを使用して、ジョブのスループット、再試行、失敗、デッドレター、キューの状態、および p95 の継続時間を確認します。

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

SQL で失敗したジョブを監視するプロンプトをコピーする
なぜこれが機能するのか
  • ジョブ名、キュー、ワーカー、顧客アカウントごとに繰り返される失敗を見つけます。
  • 顧客の問題になる前に、停止したジョブを捕捉し、ループを再試行します。
  • サポートとエンジニアリングに、非同期作業のクエリ可能な履歴を 1 つ提供します。
ユースケースの証拠パス

Background job monitoring: 実装から決定まで

完全な background job monitoring 測定ループは、1 つの所有ワークフロー、制限されたイベント コントラクト、制御されたフィクスチャ、および誰かが行動できる質問を接続します。

  1. 1

    境界を設定する

    job_started、job_completed、job_failed、および job_retried をログに記録します。

  2. 2

    結果を把握する

    Begin with job_started, job_completed, job_failed and document the grain of each event.

  3. 3

    行を証明する

    停止したジョブ、繰り返される失敗、配信不能メッセージの作成に関するアラートを追加します。

  4. 4

    決断を下す

    どのジョブが最も頻繁に失敗または再試行されますか?

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

測定するものを選ぶ

ユースケース ガイドを使用して、結果、イベントの境界、分析の質問を選択します。短いコピーアンドペースト実装の概要の準備ができたら、一致するテンプレートを開きます。

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

エージェントプロンプト

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

交換する YOUR_API_KEY サインアップ後、エージェントに製品フローを実行して最初のイベントを確認するように依頼します。

エージェントプロンプト

Background job monitoring セットアップ プロンプト

text
Telemetry を使用してバックグラウンド ジョブと非同期ワーカーを計測します。

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

job_started、job_completed、および job_failed イベントを job_name、queue_name、試行、status、duration_ms、scheduled_at、で記録してください。 started_at、completed_at、item_count、retry_count、および error_type。

ジョブごとのスループット、ジョブごとの失敗、p95 の期間、再試行量、最も古い保留中のジョブ、配信不能イベントを表示するダッシュボードを作成します。停止したジョブと繰り返される失敗に対するアラートを追加します。

セットアップ手順

  1. 1job_started、job_completed、job_failed、および job_retried をログに記録します。
  2. 2キュー、ジョブ名、試行時間、期間、項目数、エラーの種類が含まれます。
  3. 3スループット、失敗、再試行、および p95 の継続時間に関するダッシュボードを構築します。
  4. 4停止したジョブ、繰り返される失敗、配信不能メッセージの作成に関するアラートを追加します。

キャプチャするイベント

job_startedjob_completedjob_failedjob_retrieddead_letter_createdcron_tick_failed

これにより解き明かされる質問

  • どのジョブが最も頻繁に失敗または再試行されますか?
  • どのキューが遅れているのでしょうか?
  • バックグラウンド作業の失敗によって影響を受けるのはどの顧客ですか?

イベントスキーマの例

このワークフローのイベントスキーマ

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

非同期の信頼性11 フィールド

background_job_completed

論理ジョブごとに 1 つの最終結果。

スキーマを見る

関連製品の機能

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

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

探索 アラートお客様の事例を読む

関連する SQL レシピ

その他のSQL例

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

すべてのレシピを参照する
バックグラウンドジョブ初心者

バックグラウンドジョブの再試行と失敗率を測定する

どのバックグラウンド ジョブが再試行を最も多く消費するか、または依然として失敗するのはどれですか?

レシピを開く
バックグラウンドジョブ中級者

SQL で停止したバックグラウンド ジョブを見つける

開始されたが、最終イベントを生成しなかったジョブはどれですか?

レシピを開く
バックグラウンドジョブ初心者

ジョブごとのキュー待ち時間の測定

ワーカーが開始するまでに最も長く待機するジョブはどれですか?

レシピを開く
バックグラウンドジョブ中級者

配信不能キューの増加を測定する

デッドレター ジョブを解決するよりも早く追加しているキューはどれですか?

レシピを開く
バックグラウンドジョブ中級者

欠落した Cron スケジュールの検出

スケジュールされたジョブは、文書化された間隔よりも遅く実行されましたか?

レシピを開く
バックグラウンドジョブ中級者

バックグラウンドジョブの再試行ストームを検出する

現在、再試行に最も多くの時間を費やしている職種はどれですか?

レシピを開く
クエリ例のコレクションバックグラウンドジョブ SQL

顧客の証拠

関連する顧客事例

"Telemetry は、ログのダンプとイベントの追跡に最適です。それは簡単で、SQL ワークベンチは高速であり、事前にスキーマについて心配する必要はありません。 REST API 上で SQL を実行すると、データを取得してレポートを Slack に直接ダンプできます。これはセントリーが私にしてくれたことの要点です。"

プレム・ヴィスワナタン, SwiftCX

顧客事例を読む

次のステップ

エージェントが使用する API キーを作成します

プロンプトの実行、テスト イベントの送信、最初のダッシュボードの確認には無料プランで十分です。

即時パックSQL で失敗したジョブを監視する

関連ページ

暗号化とオンチェーンの自動化の監視

インデックス付きイベント、エージェントのアクション、トランザクションコスト、ウォレットのワークフロー、ツール呼び出し、失敗した自動化ジョブを追跡します。

ページを開く

Claude Code 可観測性

Claude Code に、テレメトリを別個のクリーンアップ プロジェクトではなく実装パスの一部にするプロンプトを表示します。

ページを開く

Codex 計測プロンプト

Codex に製品の残りの部分を計測し、イベントを検証し、カバレッジ ギャップを要約するよう求める、焦点を絞ったプロンプト。

ページを開く