本文へ移動
Telemetry
ドキュメントを見る
ガイド更新日: 2026年7月30日Telemetry 編集チームと製品チームによるレビュー2 最小読み取り時間

コーディング エージェントでこのドキュメントを使用してください

Claude Code、Codex、Cursor、または別のコーディング エージェント用の集中プロンプト パックを開き、それをここで説明するワークフローに適応させます。

このページの内容
  1. クエリを手動で検証する
  2. 状態を確認する
  3. 評価履歴の検査
  4. 受信者とメール配信を確認する
  5. 騒音を安全に低減

アラートの配信とトラブルシューティング

アラートには、クエリ、評価ポイント、しきい値状態、通知配信という 4 つの独立した部分があります。電子メールの問題が、適格なデータを返さなかったクエリと混同されないように、この順序でチェックしてください。

探索操作の操作フロー図。実行し、SQLと結果を確認してから、ダッシュボードへの追加またはアラートの作成を行います。

探索操作の操作フロー図。実行し、SQLと結果を確認してから、ダッシュボードへの追加またはアラートの作成を行います。 コントロールの変更は「実行」を押すと反映されます。

クエリを手動で検証する

保存した Explore クエリまたは SQL クエリを開き、アラートで使用されているのと同じ時間範囲を実行します。アラートがシリーズを評価するときに、数値と時系列のタイムスタンプ列が返されることを確認します。

完全なバケットを使用してください。最新のポイントはまだ変更されている可能性があるため、有効にしてください 最後のデータポイントを無視する 部分的に満たされたバケットがしきい値を超える可能性がある場合。

状態を確認する

確認してください:

  • 平均、最大、合計、p95 などの集計
  • 最近のポイント数
  • 比較演算子
  • しきい値と単位
  • 評価間隔
  • クエリ内の最小トラフィックまたは分母の保護手段

エラー率アラートは、パーセンテージを計算する前に、失敗とリクエストの両方を返す必要があります。遅延アラートでは、値がミリ秒であるか秒であるかを示す必要があります。

評価履歴の検査

アラートの詳細ページを開いて、最近の評価ステータスとイベントを確認します。区別:

  • データが返されませんでした
  • クエリの実行に失敗しました
  • 評価されたポイントに違反しなかった
  • 違反が検出されました
  • 通知の配信を試行しました

クエリが失敗した場合は、クエリ ワークスペースでクエリを実行し、テーブル名、フィールド タイプ、SQL の互換性、および構成されたタイムスタンプ列を検査します。

受信者とメール配信を確認する

受信者のアドレスが最新のものであり、スペースやコピーアンドペーストのアーティファクトが含まれていないことを確認してください。スパム フィルタリングを確認し、構成された Telemetry 送信者からのメッセージを許可します。セットアップ中に制御されたテストしきい値を使用し、納品が確認された後に実稼働しきい値を復元します。

単にテストするためだけに実稼働アラートのしきい値を繰り返し引き下げないでください。ページングまたは収益ワークフローが影響を受ける可能性がある場合は、テストを複製するか一時的に分離します。

騒音を安全に低減

通知する前に、複数の完全なポイント、最小ボリューム、または絶対的な影響のしきい値が必要です。ライフサイクルの変更情報を定期レビューに送信します。明確な所有者と対応が必要な状況に対して即時アラートを予約します。

読む アラートを読み、各 SQL レシピ.

関連製品の機能

レビュー済みの SQL を所有するしきい値と応答のワークフローに昇格します。

所有権と技術リファレンス

Telemetry 編集チームがこの説明を所有しています。製品チームは動作、例、境界をレビューします。

編集基準を見直す