cx-search-dashboard

ダッシュボード検索スキル

このスキルでは、cx dashboards CLI コマンドを使って、セマンティック検索またはフィールドベース検索で既存の Coralogix ダッシュボードやウィジェットを見つけます。新しいダッシュボードを作成する前に、重複を避けるため、必ず最初に検索してください。

CLI コマンド

コマンド	目的	主なフラグ
cx dashboards search "<description>"	自然言語での説明に基づいてダッシュボードを検索	--limit
cx dashboards query-search --description "<text>"	説明に一致するクエリを持つウィジェットを検索	--limit
cx dashboards query-search --field "<field-path>"	特定のフィールドを参照するすべてのウィジェットを検索	--limit
cx dashboards catalog -o json	すべてのダッシュボードを一覧表示	-
cx dashboards get <id> -o json	ダッシュボードの定義全体を取得	-

出力形式： 機械可読形式で出力するには、末尾に -o json または -o toon を追加します。

各コマンドを使用する場面

目的	コマンド
サービスやトピックに関するダッシュボードがすでに存在するか確認する	cx dashboards search
関心のあるトピックを対象とするクエリを持つウィジェットを検索する	cx dashboards query-search --description
特定のフィールドパスを参照するクエリを持つウィジェットを検索する	cx dashboards query-search --field
すべてのダッシュボードを閲覧する	cx dashboards catalog

例

サービスのダッシュボードを検索する

cx dashboards search "payment service error rate"
cx dashboards search "kubernetes node cpu"

特定のトピックを対象とするクエリを持つウィジェットを検索する

cx dashboards query-search --description "http 5xx error rate"
cx dashboards query-search --description "p99 latency over time"

特定のフィールドを参照するすべてのウィジェットを検索する

cx dashboards query-search --field '$d.http.status_code'
cx dashboards query-search --field '$d.kubernetes.pod.name'

これにより、すでに使用されているクエリのパターンがわかります。新しいウィジェットを追加する際に、既存の手法を再利用するのに役立ちます。

見つけたダッシュボードを確認して複製する

# Get full JSON of a dashboard you found
cx dashboards get <dashboard-id> -o json > dashboard.json
# Modify it, then create a copy
cx dashboards create --from-file dashboard.json

主な原則

• 作成前に検索する — 重複を避けるため、新しいダッシュボードを作成する前に必ず cx dashboards search を実行してください
• フィールド検索で調べる — cx dashboards query-search --field を使うと、そのフィールドがすでにどのようにクエリされているかがわかります。再利用可能な PromQL や DataPrime のパターンを見つける最も手早い方法です
• 説明検索はあいまい検索です — 結果は完全一致ではなく類似度順に表示されます。最初の検索で役立つ結果が得られない場合は、いくつかの異なる表現を試してください
• 確認には cx dashboards get を使う — 関連するダッシュボードやウィジェットが見つかったら、JSON 全体を取得してクエリの構造を確認してください

関連スキル

• cx-dashboards — Coralogix ダッシュボードをゼロから構築してデプロイします
• cx-telemetry-querying — ダッシュボードを検索する前に、利用可能なテレメトリのフィールドやメトリクスを調べます