
- クエリの実行先となる ClickHouse 接続 を選択します。
- 必要に応じて ログソース を選択します。これにより、
$__filtersマクロを介してダッシュボードレベルのフィルタをグラフに適用できるようになります。 - エディタで SQL クエリを記述し、クエリパラメータとマクロを使ってダッシュボードの時間範囲、フィルタ、変数と連携させます。
- play ボタンをクリックして結果をプレビューし、続けて Save をクリックします。
{paramName:Type} を使用します。
使用できるパラメータは、チャートの種類によって異なります。
折れ線グラフ チャートおよび 積み上げ棒グラフ チャート:
Table、Pie、および Number チャート:
マクロは、よく使われる ClickHouse SQL の式に展開されるショートカットです。
$__ というプレフィックスが付き、クエリが ClickHouse に送信される前に置換されます。
これらのマクロは、ダッシュボードの開始時刻または終了時刻を表す ClickHouse の式を返します。引数はありません。
これらのマクロは、カラムをダッシュボードの時間範囲で絞り込む
WHERE 句のフラグメントを生成します。
$__timeFilter(TimestampTime) の展開例:
SELECT 句および GROUP BY 句で使用します。利用できるのは、折れ線グラフ と Stacked-bar の可視化のみです。
$__timeInterval(TimestampTime) の展開例:
グラフでログソースが選択されており、ダッシュボードフィルタが有効な場合、
$__filters は対応する SQL の WHERE 条件に展開されます。ログソースが選択されていない場合、またはフィルタが適用されていない場合は、(1=1) に展開されるため、WHERE 句に含めても常に安全です。
$__filters によって適用されるのは、ブロードキャストフィルタ条件が有効なフィルタのみです。変数として公開されているフィルタは、以下で説明するように明示的に参照します。
ダッシュボードフィルタが変数として利用可能な場合、選択された値をクエリ内の任意の場所で参照できます。これらのマクロは、少なくとも1つの変数を宣言しているダッシュボードに属するタイルでのみ使用できます。
変数の値は、オプションのフォーマットを指定して
$name または ${name} として直接補間することもできます。指定できる形式は ${name:sqlstring} (デフォルト) 、${name:csv}、${name:regex} です。デフォルト形式では、何も選択されていない場合、直接参照は NULL としてレンダリングされます。そのため、述語が必要な箇所では、可能な限り上記のマクロを使用してください。
ClickStack は、カラムの型に基づいて、クエリ結果のカラムをグラフ要素に自動的に対応付けます。対応付けのルールは、グラフの種類によって異なります。
すべての結果カラムが、そのままテーブルのカラムとして表示されます。
必要な system table へのアクセス権以下の例を play-clickstack.clickhouse.com 上で実行する場合は、
otel_v2.otel_logs または otel_v2.otel_traces を指定する必要があります。ts(DateTime) は、x軸のタイムスタンプとして使用されます。count(数値) は、系列の値としてプロットされます。ServiceName(文字列) は、サービスごとに別々の線として表示されます。
ServiceName の service 変数と SeverityText の severity 変数を含む dashboard では、このクエリにより、グラフは現在選択されている service に絞り込まれ、選択した重要度は除外されます。どちらのマクロも対応する変数が未選択の場合は 1=1 に展開されるため、閲覧者が値を選択するまでグラフはフィルタリングされずに表示されます。
request_count(数値) は各スライスの大きさを決定します。ServiceName(文字列) は各スライスのラベルを表します。
total_errors が表示されます。
- SQL ベースの可視化は
readonlyモードを有効にして実行されるため、SELECTクエリのみ実行できます。 - SQL ベースの可視化では、SQL クエリは必ず 1 つだけ指定する必要があります。複数クエリには対応していません。
- SQL エディタでは、クエリパラメータとマクロの両方でオートコンプリート候補が表示されます。
- SQL ベースの可視化にダッシュボードフィルタを適用するには、ログソースを選択する必要があります。正しくフィルタリングするには、ログソースをクエリ対象のテーブルに一致させる必要があります。
- ダッシュボード変数にはログソースは不要です。値はタイル自体のログソースではなく、ダッシュボードのフィルタドロップダウンから取得されます。
- ダッシュボード変数を参照する SQL タイルのアラートは、ダッシュボードで選択された値ではなく、すべての変数が空の状態で評価されます。