OpenTelemetry インテグレーション
Timestamp) 、log level (SeverityText) 、message body (Body) などでデフォルトの OTel カラム名を使用している場合は、変更は不要です。
HTTP または ネイティブプロトコルGrafana は HTTP またはネイティブプロトコルのいずれかで ClickHouse に接続できます。後者にはわずかなパフォーマンス上の利点がありますが、Grafana ユーザーが発行する集計クエリでは、その差を体感できることはほとんどありません。一方、HTTP プロトコルは通常、プロキシや内部確認を行いやすいという利点があります。
ログ
Query Type: Log を選択し、Run Query をクリックできます。クエリビルダーはログを一覧表示するクエリを生成し、たとえば次のように表示されるようにします。
logs が選択されていれば、結果はログとして表示されます。ログの表示に必要なカラムは こちら に記載されています。
ログからトレースへ
トレース
Query Type: Traces を選択して Run Query をクリックすると、次のようなクエリが生成されて実行されます (内容は設定したカラムによって異なります。以下は OTel の使用を前提としています) 。
duration やその他のカラムでのフィルタリングは、SQL を記述しなくても行えます。
より複雑なクエリを記述したい場合は、SQL エディタ に切り替えることができます。
トレースの詳細を表示する
View Trace リンクから関連するスパンを表示できます。これにより、必要な構造でスパンを取得するために次のクエリ (OTel のカラムを前提) が実行され、結果はウォーターフォール形式で表示されます。
上記のクエリでは、トレース ID のルックアップに materialized view
otel_traces_trace_id_ts が使用されている点に注目してください。詳しくは、クエリの高速化 - ルックアップに materialized view を使用するを参照してください。トレースからログへ
View Logs を選択します。すると、デフォルトの OTel カラムを前提として、次のクエリが実行されます。
ダッシュボード
時系列
time という名前の datetime と数値カラムを返す場合、自動的に折れ線グラフを表示します。例:
複数系列チャート
- フィールド 1:
timeというエイリアスを持つ datetime フィールド - フィールド 2: グループ化する値。これは String である必要があります。
- フィールド 3+: メトリックの値
地理データの可視化
latitude と longitude のカラムがあることを前提に、geohashEncode 関数を使ってオブザーバビリティデータを可視化できます。これにより、Grafana Geo Mapチャートと互換性のあるジオハッシュが生成されます。クエリ例と可視化例を以下に示します。