保存されたクエリ、履歴、お気に入り、コラボレーション
保存されたクエリにより、調査が再利用可能なチーム成果物に変わります。 Telemetry は、チーム ワークスペース内でクエリを整理し、クエリ履歴を保存し、各ユーザーが最も頻繁に使用するクエリをお気に入りにできるようにします。
SQL を保存しても、メトリックは正しくなりません。他の人や自動化されたワークフローが依存する前に、イベントの粒度、フィルター、分母、単位、時間境界を確認します。
ワークスペースを選択してください
ワークスペースを使用して、関連する分析をサービス、製品分野、運用ワークフロー、またはチームごとにグループ化します。ワークスペースはネストできるため、すべてのクエリを 1 つのフラット リストに強制的に入れることなく、より集中的なコレクションを広い領域に含めることができます。
構造をスキャンできるほど浅く保ちます。実際的な取り決めは次のようになります。
reliability
api
background-jobs
product
activation
retention
ai
model-cost
agent-quality
チームのメンバーシップは、ワークスペースと保存されたクエリを表示するユーザーを制御します。 「personal」などのワークスペース名は、組織または所有権を表します。そのワークスペースがプライベートになるわけではありません。すべてのチーム メンバーがチームのワークスペース分析にアクセスできるため、クエリに特定の対象者を対象とした識別子や操作の詳細が含まれている場合は、別のチームを使用します。
クエリに名前を付けて保存します
ドラフトから開始し、代表的な時間範囲に対してクエリを実行し、結果を検査します。保管する準備ができたら:
- 決定を所有するワークスペースに保存します。
- 必要に応じて、結果、スコープ、および単位を使用して名前を変更します。
- レートやパーセンタイルの横にボリュームを確保してください。
- 保存されたバージョンがレビューされた後でのみ、結果をダッシュボードに追加します。
好む API error rate by route — production 終わった query 14 または incident query。名前は、すべての結果を開かなくてもクエリを検索して解釈できるようにする必要があります。
クエリ履歴を理解する
変更を保存するとクエリ履歴が作成されます。履歴エントリを使用して、SQL がどのように進化したかを確認し、編集により結果が予期せず変更された場合に以前のロジックを回復します。
共有クエリを大幅に変更する前に、次のことを行ってください。
- 新旧のメトリック定義に注目してください。
- 同じ固定ウィンドウで両方のバージョンを比較します。
- クエリを使用するダッシュボード、アラート、またはレポートを特定します。
- 消費者が変更を確認するまで以前のバージョンを保存します。
- 意味が変わった場合は、ダッシュボードの説明テキストを更新します。
クエリによって規制されたレポート、アクセス決定、または正確な財務調整が行われる場合、履歴は広範な監査証跡やコード レビュー プロセスの代わりにはなりません。
お気に入りを個人用ショートカットとして使用する
お気に入りは、個人ごとのナビゲーション補助です。クエリをお気に入りにしても、そのワークスペース、権限、SQL、または他のチーム メンバーのステータスは変更されません。共有クエリを複製することなく、アクティブなインシデント ビュー、週次レビュー、または定期的な製品の質問にお気に入りを使用します。
安定した成果を推進
保存されたクエリは次のようになります。
- ダッシュボードのグラフまたは結果テーブル。
- 明示的なしきい値と所有者を持つアラート。
- 反復可能なエクスポート。
- より深い調査への出発点となります。
保存したクエリを検査可能な分析定義として保持します。応答指示と所有権をダッシュボードまたはアラートの横に配置して、ハンドオフ中に成果物が理解できるようにします。
コラボレーションチェックリスト
保存したクエリを広く共有する前に、次のことを確認してください。
- すべてのチーム メンバーは、ワークスペースとクエリの対象読者です。
- タイトルには結果と単位が記載されています。
- SQL は、文書化されたフィールドとカウント ルールを使用します。
- 代表的なフィクスチャまたは既知の間隔がチェックされています。
- 機密性の高い生の識別子は、広範なダッシュボードから省略されます。
- 重要な変更は、前の履歴エントリと比較されます。
- すべてのアラートには、所有者、評価ウィンドウ、および応答アクションがあります。
続けて ダッシュボードの作成, アラート、または チーム、ワークスペース、メンバー.