system.instrumentation

계측 지점을 포함하는 시스템 테이블

ClickHouse Cloud에서 쿼리하기

이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 모두 확인하려면 clusterAllReplicas 함수를 사용해야 합니다. 자세한 내용은 여기를 참조하십시오.

​

설명

LLVM의 XRay 기능에서 사용하는 계측 지점을 포함합니다.

가용성

system.instrumentation은 LLVM XRay 지원(USE_XRAY)으로 컴파일된 ClickHouse 빌드에만 존재합니다. 해당 지원이 없는 빌드에서는 이 테이블이 존재하지 않으며, 이에 대한 쿼리는 UNKNOWN_TABLE 오류로 실패합니다. 사용 중인 빌드에서 활성화되어 있는지는 다음과 같이 확인할 수 있습니다:

SELECT value FROM system.build_options WHERE name = 'USE_XRAY';

​

컬럼

• id (UInt32) — 계측 지점의 ID
• function_id (Int32) — ELF 바이너리의 xray_instr_map 섹션에서 함수에 할당된 ID
• function_name (LowCardinality(String)) — 함수를 계측할 때 사용되는 이름
• handler (LowCardinality(String)) — 함수의 계측 지점에 패치된 핸들러
• entry_type (Enum8(‘Entry’ = 0, ‘Exit’ = 1, ‘EntryAndExit’ = 2)) — 패치의 진입 유형
• symbol (LowCardinality(String)) — 완전한 디맹글링된 심볼 이름
• arguments (Array(Dynamic)) — 핸들러 호출에 사용되는 인수

​

예시

SELECT * FROM system.instrumentation FORMAT Vertical;

Row 1:
──────
id:            0
function_id:   231280
function_name: QueryMetricLog::startQuery
handler:       log
entry_type:    Entry
symbol:        DB::QueryMetricLog::startQuery(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&, std::__1::chrono::time_point<std::__1::chrono::system_clock, std::__1::chrono::duration<long long, std::__1::ratio<1l, 1000000l>>>, unsigned long)
arguments:     ['test']

Row 2:
──────
id:            1
function_id:   231280
function_name: QueryMetricLog::startQuery
handler:       profile
entry_type:    EntryAndExit
symbol:        DB::QueryMetricLog::startQuery(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&, std::__1::chrono::time_point<std::__1::chrono::system_clock, std::__1::chrono::duration<long long, std::__1::ratio<1l, 1000000l>>>, unsigned long)
arguments:     []

Row 3:
──────
id:            2
function_id:   231280
function_name: QueryMetricLog::startQuery
handler:       sleep
entry_type:    Exit
symbol:        DB::QueryMetricLog::startQuery(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&, std::__1::chrono::time_point<std::__1::chrono::system_clock, std::__1::chrono::duration<long long, std::__1::ratio<1l, 1000000l>>>, unsigned long)
arguments:     [0.3]

3 rows in set. Elapsed: 0.302 sec.

​

관련 항목

• SYSTEM INSTRUMENT — 계측 지점을 추가하거나 제거합니다.
• system.trace_log — 프로파일링 로그를 확인합니다.
• system.symbols — 계측 지점을 추가할 때 사용할 심볼을 확인합니다.