SQL から開始せずに構造化イベントを探索する
Explore は、空白の SQL エディターで始める必要がなく、1 つの構造化イベント テーブルをサンプル ビュー、グループ化された結果、またはチャートに変換します。これは、新しいインスツルメンテーションの検証、限定された運用上の質問の調査、最初のダッシュボードまたはアラートの作成に役立ちます。
生成された SQL は表示されたままになります。コントロールを別の分析言語ではなくクエリ ビルダーとして扱います。結果を検査し、生成されたクエリを確認し、質問に結合、いくつかの一般的なテーブル式、または再利用可能なメトリクス定義が必要な場合は、クエリ ワークスペースに移動します。
探索操作の操作フロー図。実行し、SQLと結果を確認してから、ダッシュボードへの追加またはアラートの作成を行います。 コントロールの変更は「実行」を押すと反映されます。
サンプルイベントから始める
イベント テーブルを選択し、集計を追加する前に最近の行を検査します。確認します:
- このテーブルは、完了したリクエストやエージェントの実行など、1 つの明確な作業単位を表します。
- タイムスタンプは、意図された発生時刻とタイムゾーンを使用します。
- 数値フィールドは、数値に見える文字列ではなく数値です。
- カテゴリ フィールドは安定した制限された値を使用します。
- ルート、リリース、テナント、および相関フィールドには、予想どおりに値が入力されます。
- 機密性の高い値は存在しないか、プライバシー ポリシーに従って変換されます。
グラフでは、NULL、混合単位、重複配信、予期せぬまばらなフィールドが非表示になることがあります。サンプルは、誤解を招く率やパーセンタイルになる前に、これらの問題を明らかにします。
焦点を絞った結果を構築する
Explore は、サンプルと表の結果に加えて、折れ線グラフ、棒グラフ、積み上げ面グラフをサポートします。質問に答える最小のビューを選択してください。
- テーブルと時間範囲を選択します。
- 次のような安定したフィールド用のフィルターを追加します。
environment,service,outcome、またはルート テンプレート。 - 選択してください
count,sum,average,min,max、またはパーセンタイル集計。 - 集計に数値フィールドが必要な場合は、数値フィールドを選択します。
- 結果を説明するのに役立つ制限された次元によってのみ系列を分割します。
- 生成された SQL と返された行数を検査します。
ネストされた構造化フィールドは、テーブル スキーマに存在する場合にフィルターできます。生の URL や任意のオブジェクト コンテンツよりも、明示的な列とルート テンプレートを優先します。
質問例
| 質問 | 推奨されるコントロール |
|---|---|
| リリース後に API の障害が増加しましたか? | イベントを時間ごとにカウントし、失敗した結果をフィルタリングし、リリースごとに分割します |
| どのジョブキューが最も頻繁に再試行されていますか? | イベントをカウントし、複数の試行をフィルタリングし、キューごとに分割します |
| 1 つの機能に対してモデルのコストが上昇していますか? | 時間ごとの推定コストの合計を、制限された機能名で分割したもの |
| ブラウザのパフォーマンスは変わりましたか? | Web Vital のパーセンタイルを選択し、指標でフィルターし、リリースごとに分割します |
ボリュームはレートとパーセンタイルの隣に置いてください。 3 つのイベントに基づく重大な変化は、300 万に基づく同じ変化のように解釈されるべきではありません。
生成された SQL を確認します。
結果を保存する前に、生成されたクエリが以下であることを確認してください。
- 意図した時間フィールドと環境をフィルタリングします。
- レートに正しい分母を使用します。
- null を意図的に処理します。
- 決定と同じ粒度のグループ。
- 高カーディナリティ識別子によって分割されません。
- 比較が歪む可能性がある場合、不完全な最新のタイム バケットは除外されます。
配信の重複排除、テーブルの結合、結合前の事前集計、複数のコホートの比較、または SQL でのメトリクスの文書化が必要な場合は、クエリで結果を開きます。 Explore は意図的に 1 つのテーブルの調査を中心にしています。
結果を促進する
チームメイトが同じ回答を繰り返し必要とする場合は、レビュー済みの Explore 結果をダッシュボードに追加します。ウィジェットに意思決定指向の名前を付け、関連する時間範囲とフィルターを保持し、任意のパーセンテージまたはパーセンタイルの近くにボリューム ビューを配置します。
いくつかの代表的なウィンドウを確認した後でのみ、アラートを作成してください。所有者、しきい値、評価ウィンドウ、および応答アクションを定義します。まばらな、または不完全な最新データから構築されたしきい値はノイズを生成します。
検証チェックリスト
- 既知のフィールド値を持つ合成イベントを送信します。
- サンプル ビューでその正確なイベントを見つけます。
- それを含むフィルターを追加してから、それを除外するフィルターを追加します。
- カウントまたは合計を手動で既知のフィクスチャと比較します。
- 生成された SQL を確認します。
- 結果を保存し、ターゲット ダッシュボードまたはアラート フローから再度開きます。
- 別の対象チーム メンバーがタイトル、フィルター、単位、および応答アクションを解釈できることを確認します。
続けて 最初のTelemetry SQLクエリを書く, ダッシュボードの作成、または アラート.