Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

딥 링크

View as MarkdownEdit this pageReport an issueSet up docs MCP

URL 쿼리 매개변수를 사용한 딥 링크로 ClickStack 페이지를 열면 외부 시스템(알림 알림, 런북, CI job, chat 메시지 등)에서 특정 검색, 대시보드 또는 패널로 바로 이동할 수 있습니다.

이 페이지의 예시에서는 <YOUR_CLICKSTACK_URL>을 사용합니다. 이를 ClickStack URL로 바꾸십시오. 예를 들어 로컬 open source 배포에서는 http://localhost:8080을 사용하고, ClickHouse Cloud의 관리형 ClickStack에서는 https://hyperdx.clickhouse.cloud을 사용합니다.

기본 로그/트레이스 검색 보기입니다. 검색 구문에 관한 자세한 내용은 검색을 참조하십시오.

매개변수 포맷 설명
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 epoch 밀리초 절대 시간 범위입니다. 생략하면 최근 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) 임시 저장되지 않은 대시보드가 열립니다. 대시보드 구축에 관한 자세한 내용은 Dashboards를 참조하십시오.

매개변수 포맷 설명
from, to epoch 밀리초 모든 타일에 적용되는 시간 범위입니다. 생략하면 최근 15분이 기본값으로 적용됩니다.
where 문자열 모든 타일에 적용되는 대시보드 수준의 필터 쿼리 텍스트입니다.
whereLanguage lucene sql
filters {"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[] ServiceName 필터 드롭다운에서 두 항목을 선택하는 구조화된 대시보드 필터 값입니다.
granularity auto 30 second
highlightedTileId 문자열 특정 타일로 스크롤하여 강조 표시합니다. 알림에서 연결할 때 유용합니다.

예시: 특정 시간 범위에서 하나의 타일을 강조 표시한 대시보드 열기

알림 알림에서 해당 알림을 발생시킨 타일로 바로 연결할 때 유용합니다.

<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 전체 차트 구성(source, select, where, 차트 유형 등)입니다. 일반적으로 직접 작성하는 대신 앱 내의 "Share" 링크를 통해 생성됩니다.
from, to epoch 밀리초 시간 범위입니다. 생략하면 기본값으로 최근 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

알림 생성 및 관리에 대한 자세한 내용은 알림을 참조하십시오.

매개변수 포맷 설명
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 epoch 밀리초 세션 목록의 시간 범위입니다. 생략하면 최근 15분이 기본값으로 사용됩니다.
sid string ID로 특정 세션을 엽니다.
sfrom, sto epoch 밀리초 열린 세션의 시간 윈도우입니다(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 epoch 밀리초 시간 범위입니다. 생략하면 최근 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 epoch 밀리초 시간 범위입니다. 생략하면 최근 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 epoch 밀리초 시간 범위입니다. 생략하면 최근 15분으로 기본 설정됩니다.

예시: 특정 파드의 상세 정보 패널 열기

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

노트북 — /notebook/<notebookId>

예시: 특정 Cloud 서비스에서 지정된 노트북 열기

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