Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

ディープリンク

View as MarkdownEdit this pageReport an issueSet up docs MCP

ClickStack ページは、URL クエリパラメータを使用したディープリンクで開けます。これにより、外部システム (アラート通知、ランブック、CI ジョブ、チャットメッセージなど) から特定の検索、ダッシュボード、またはパネルに直接移動できます。

このページの例では <YOUR_CLICKSTACK_URL> を使用しています。これを ClickStack の URL に置き換えてください。たとえば、ローカルのオープンソースデプロイメントの場合は http://localhost:8080、ClickHouse Cloud の Managed ClickStack の場合は https://hyperdx.clickhouse.cloud を使用します。

主要なログ／トレース検索ビューです。検索構文の詳細については、Searchを参照してください。

パラメータ フォーマット 説明
source string 検索対象のログソース。ログソース ID またはログソースの名前 (例: Logs) を指定できます。このページでサポートされるのは Log および Trace のログソースのみです。
where string Lucene または SQL 構文で記述するフィルターのクエリテキスト (whereLanguageを参照) 。
whereLanguage lucene sql
select string 結果テーブルに表示する SQL カラム／式のリスト。
filters {"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[] whereに加えて適用する構造化ファセットフィルター。
orderBy string 結果テーブルの SQL ソート式。
mode results delta
isLive true false
traceId string 指定したトレース ID のトレースウォーターフォールビューに直接移動します。
from, to エポックミリ秒 絶対時間範囲。省略した場合、デフォルトで直近 15 分間が使用されます。

保存済み検索は、/search/<savedSearchId>から直接開くこともできます。

例: 時間範囲を指定して Logs ログソース内の checkout サービスのエラーを検索する

<YOUR_CLICKSTACK_URL>/search?source=Logs&from=1735689600000&to=1735693200000&where=level:error&filters=[{"type":"sql","condition":"ServiceName IN ('checkout')"}]

例: トレースのウォーターフォールビューを直接開く

<YOUR_CLICKSTACK_URL>/search?source=Traces&traceId=ba7217967eb90d040b7eb39f97ecc5c4

保存済み検索 — /search/list

保存済み検索の一覧。

パラメータ フォーマット 説明
tag string このタグが付いた保存済み検索に一覧を絞り込みます。

例: production タグが付いた保存済み検索を一覧表示する

<YOUR_CLICKSTACK_URL>/search/list?tag=production

ダッシュボード — /dashboards/<dashboardId>

保存済みのダッシュボードです。<dashboardId>を省略して (/dashboards) 、一時的な未保存のダッシュボードを開くことができます。ダッシュボードの作成について詳しくは、ダッシュボードを参照してください。

パラメータ フォーマット 説明
from, to エポックミリ秒 すべてのタイルに適用される時間範囲です。省略した場合は、直近15分がデフォルトになります。
where 文字列 すべてのタイルに適用されるダッシュボードレベルのフィルタークエリテキストです。
whereLanguage lucene sql
filters {"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[] 構造化されたダッシュボードフィルター値です。ServiceNameフィルターのドロップダウンで2つの項目を選択します。
granularity auto 30 second
highlightedTileId 文字列 特定のタイルまでスクロールして強調表示します。alertからリンクする場合に便利です。

例: 1 つのタイルを強調表示した状態で、指定した時間範囲のダッシュボードを開く

アラート通知から、発火したタイルに直接リンクする際に便利です。

<YOUR_CLICKSTACK_URL>/dashboards/64f1c2a1e8b9f3a1b0d2e5c7?from=1735689600000&to=1735693200000&highlightedTileId=chart-1

ダッシュボード一覧 — /dashboards/list

パラメータ フォーマット 説明
tag string タグでダッシュボード一覧を絞り込みます。

例: infra タグが付いたダッシュボードを一覧表示する

<YOUR_CLICKSTACK_URL>/dashboards/list?tag=infra

Chart Explorer — /chart

アドホックな共有可能チャートビルダー。

パラメータ フォーマット 説明
config JSON 完全なチャート設定 (ログソース、select、where、チャートタイプなど) 。通常は手動で記述するのではなく、アプリ内の「Share」リンクから生成されます。
from, to エポックミリ秒 時間範囲。省略した場合、デフォルトでは直近15分間になります。

例: 指定した時間範囲の p99 レイテンシチャート設定を開く

<YOUR_CLICKSTACK_URL>/chart?granularity=auto&from=1785759381784&to=1785762981785&config={"name":"","select":[{"aggFn":"quantile","aggCondition":"","aggConditionLanguage":"lucene","valueExpression":"Duration","level":0.99,"alias":"p99"}],"where":"","whereLanguage":"lucene","displayType":"line","alignDateRangeToGranularity":true,"source":"68814eb5d40a9d0449afc1f2","connection":"68814b6fd40a9d0449afbe78","groupBy":"ServiceName"}

アラート — /alerts

アラートの作成と管理について詳しくは、Alertsを参照してください。

パラメータ フォーマット 説明
search string アラート名または説明を対象とするフリーテキストフィルター。
tag string タグでフィルタリングします。
creator string アラート作成者の名前でフィルタリングします。

例: on-call タグ付きのアラートを一覧表示する

<YOUR_CLICKSTACK_URL>/alerts?tag=on-call

セッションリプレイ — /sessions

セッションリプレイの閲覧と再生。機能の詳細については、セッションリプレイを参照してください。

パラメータ フォーマット 説明
sessionSource string セッションログソースの ID または名前。
where string セッションリストに対するフィルタークエリテキスト。
whereLanguage lucene sql
from, to エポックミリ秒 セッションリストの時間範囲。省略した場合、直近 15 分間がデフォルトです。
sid string ID で特定のセッションを開きます。
sfrom, sto エポックミリ秒 開いたセッションの時間ウィンドウ (sid とともに使用) 。

例: 指定した期間内のセッションリプレイを閲覧する

<YOUR_CLICKSTACK_URL>/sessions?from=1735689600000&to=1735693200000

例: 記録された時間範囲で特定のセッションリプレイを開く

<YOUR_CLICKSTACK_URL>/sessions?sid=6712abf0e4b0f2a1c3d4e5f6&sfrom=1735689600000&sto=1735690200000

サービスマップ — /service-map

機能の詳細については、サービスマップを参照してください。

パラメータ フォーマット 説明
source string トレースログソースの ID または名前。
samplingFactor integer トレースサンプリングの除数 (1 = トレース全体の 100%、2 = 50%、4 = 25% など) 。
from, to エポックミリ秒 時間範囲。省略した場合、直近 15 分間がデフォルトになります。

例: 時間範囲を指定してサービスマップを表示する

<YOUR_CLICKSTACK_URL>/service-map?from=1735689600000&to=1735693200000

サービス — /services

サービスごとの HTTP、データベース、エラーのダッシュボード。

パラメータ フォーマット 説明
tab http database
source string トレースログソース ID。
service string 選択したサービス名。
where string フィルター用のクエリテキスト。
whereLanguage lucene sql
filters {"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[] ダッシュボードのフィルターバーの値。
from, to エポックミリ秒 時間範囲。省略した場合は直近 15 分間がデフォルトです。

例: 指定した期間のサービスのデータベースダッシュボードを表示する

<YOUR_CLICKSTACK_URL>/services?tab=database&service=checkout&from=1735689600000&to=1735693200000

例: サービスのエラーダッシュボードを表示する

<YOUR_CLICKSTACK_URL>/services?tab=errors&service=payments

Kubernetes — /kubernetes

パラメータ フォーマット 説明
logSource, metricSource string ログおよびメトリクスのログソース ID。いずれか一方のみを指定した場合、もう一方は相関付けられたログソースがデフォルトで使用されます。
tab 例: pods, nodes, namespaces アクティブなサブビュー。
q string リソースリスト用の Lucene クエリ。
podName, nodeName, namespaceName string 特定のポッド、ノード、またはネームスペースの詳細パネルを開きます。
from, to エポックミリ秒 時間範囲。省略した場合、直近 15 分間がデフォルトで使用されます。

例: 特定のポッドの詳細パネルを開く

<YOUR_CLICKSTACK_URL>/kubernetes?tab=pods&podName=checkout-7d9f8b5c-2xk9p

Notebooks — /notebook/<notebookId>

例: 指定した Cloud サービスで特定の notebook を開く

<YOUR_CLICKSTACK_URL>/notebook/64f1c2a1e8b9f3a1b0d2e5c7?chcServiceId=abc123
Navigation