- ClickHouse 구성 파일에 대한 이해
- 실행 중인 ClickHouse 서버
- (선택 사항) 실행 중인 로컬 Grafana 인스턴스
1
opentelemetry_span_log 시스템 테이블(system table)이 활성화되어 있는지 확인하세요
config.xml의 opentelemetry_span_log 섹션을 수정한 적이 없다면 이 단계는 건너뛰어도 됩니다.기본 ClickHouse config.xml 파일을 열고 다음 섹션을 찾으십시오:system.opentelemetry_span_log를 볼 수 없습니다.
ClickHouse 서버가 기본 설정 파일을 사용하지 않는 경우에도 이런 현상이 발생할 수 있습니다.다음과 유사한 내용이 있는지 서버 로그를 확인하십시오:2
OpenTelemetry 트레이싱 활성화
ClickHouse 서버가 실행 중인 상태에서 clickhouse client를 열고 다음 쿼리를 사용해 trace 수집을 활성화합니다:다음을 실행하면 이제 다음 실행:이 설정은 ClickHouse가 실행되는 쿼리에 대해 트레이스를 시작할 확률을 지정하며,
opentelemetry_span_log 시스템 테이블이 표시됩니다:1은 모든 실행되는 쿼리에 대해 트레이스가 활성화됨을 의미합니다.3
쿼리 ID 가져오기
다음 테스트용 쿼리 또는 추적하려는 쿼리를 실행하세요:쿼리 ID를 복사하세요:
4
트레이스 파일 생성
다음 쿼리를 실행하되, 이전 단계에서 얻은 쿼리 ID로 바꿔 입력하십시오:이렇게 하면 trace가
trace.json 파일에 기록됩니다.
기본적으로 이 파일은 clickhouse-client 또는 clickhouse-local 도구를 실행한 현재 작업 디렉터리에 생성됩니다.5
기본 제공 도구로 trace 시각화하기
다음 호스팅된 trace 시각화 도구를 사용하십시오: https://trace-visualizer.clickhouse.com/.
이전 단계의
trace.json 파일을 불러와 trace를 시각화하십시오.6
Grafana를 사용해 트레이스 시각화하기
공식 ClickHouse plugin을 사용해 trace 데이터를 시각화하고 탐색하는 데는 Grafana를 권장합니다.
이 plugin은 Trace Panel을 사용해 trace를 시각화할 수 있도록 개선되었습니다.
이는 시각화와 Explore의 구성 요소로 모두 지원됩니다.Grafana를 ClickHouse plugin과 함께 설정하려면 “관측성을 위한 Grafana 및 ClickHouse 사용”에 설명된
단계를 따르십시오.그런 다음 Explore 탭에서 다음 쿼리를 실행할 수 있으며,
trace_id를 사용자 환경에 맞게 바꾸십시오:Query type을 Traces로 설정하십시오:“Run Query”를 클릭한 다음 트레이스 다이어그램을 살펴보십시오: