ディープリンク

ClickStack ページは、URL クエリパラメータを使用したディープリンクで開けます。これにより、外部システム (アラート通知、ランブック、CI ジョブ、チャットメッセージなど) から特定の検索、ダッシュボード、またはパネルに直接移動できます。このページの例では <YOUR_CLICKSTACK_URL> を使用しています。これを ClickStack の URL に置き換えてください。たとえば、ローカルのオープンソースデプロイメントの場合は http://localhost:8080、ClickHouse Cloud の Managed ClickStack の場合は https://hyperdx.clickhouse.cloud を使用します。

例では、読みやすさのためクエリパラメータを URL エンコードせずに示しています。プログラムでリンクを構築する場合は、各クエリパラメータ値を URL エンコードしてください。

Managed ClickStack サービス ID パラメータClickHouse Cloud で Managed ClickStack を使用する場合、リンクをたどる認証済みユーザーが複数の ClickHouse Cloud サービスを使用する権限を持つときは、読み込む ClickHouse Cloud サービスを識別するため、リンクに ?chcServiceId= パラメータを含める必要があります。例: 特定の Cloud サービスを対象に Search を開く

https://hyperdx.clickhouse.cloud/search?chcServiceId=abc123

Search — `/search`

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

パラメータ	フォーマット	説明
`source`	string	検索対象のログソース。ログソース ID またはログソースの名前 (例: `Logs`) を指定できます。このページでサポートされるのは Log および Trace のログソースのみです。
`where`	string	Lucene または SQL 構文で記述するフィルターのクエリテキスト (`whereLanguage`を参照) 。
`whereLanguage`	`lucene`	`sql`	`where`の記述に使用するクエリ言語。
`select`	string	結果テーブルに表示する SQL カラム／式のリスト。
`filters`	`{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]`	`where`に加えて適用する構造化ファセットフィルター。
`orderBy`	string	結果テーブルの SQL ソート式。
`mode`	`results`	`delta`	`pattern`	アクティブな分析モード。`delta`はトレースログソースでのみ使用できます。
`isLive`	`true`	`false`	ライブテールが有効かどうか (デフォルトは`true`) 。
`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`	`where`の記述に使用するクエリ言語です。
`filters`	`{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]`	構造化されたダッシュボードフィルター値です。`ServiceName`フィルターのドロップダウンで2つの項目を選択します。
`granularity`	`auto`	`30 second`	`1 minute`	`5 minute`	`10 minute`	`15 minute`	`30 minute`	`1 hour`	`12 hour`	`1 day`	`7 day`	時系列タイルのバケットサイズです。`auto`は、選択した時間範囲に基づいてバケットサイズを決定します。
`highlightedTileId`	文字列	特定のタイルまでスクロールして強調表示します。alertからリンクする場合に便利です。

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

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

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

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

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

<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`	`where` の記述に使用するクエリ言語。
`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`	`errors`	表示するサービスダッシュボードのサブタブ。デフォルト: `http`
`source`	string	トレースログソース ID。
`service`	string	選択したサービス名。
`where`	string	フィルター用のクエリテキスト。
`whereLanguage`	`lucene`	`sql`	`where` の記述に使用するクエリ言語 (このページではデフォルトで `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>`

Managed ClickStack のみNotebooks は、Managed ClickStack のデプロイメントでのみ利用できます。機能の詳細については、AIノートブックを参照してください。

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

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

Get started

Features

Managing ClickStack

Guides

Integration partners

Search — `/search`

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

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

保存済み検索 — `/search/list`

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

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

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

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

Chart Explorer — `/chart`

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

アラート — `/alerts`

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

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

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

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

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

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

サービス — `/services`

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

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

Kubernetes — `/kubernetes`

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

Notebooks — `/notebook/<notebookId>`

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

​Search — /search

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

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

​保存済み検索 — /search/list

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

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

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

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

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

​Chart Explorer — /chart

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

​アラート — /alerts

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

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

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

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

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

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

​サービス — /services

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

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

​Kubernetes — /kubernetes

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

​Notebooks — /notebook/<notebookId>

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

Search — `/search`

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

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

保存済み検索 — `/search/list`

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

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

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

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

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

Chart Explorer — `/chart`

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

アラート — `/alerts`

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

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

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

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

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

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

サービス — `/services`

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

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

Kubernetes — `/kubernetes`

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

Notebooks — `/notebook/<notebookId>`

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