system.query_thread_log

설명

쿼리를 실행하는 스레드에 대한 정보가 포함됩니다. 예를 들어 스레드 이름, 스레드 시작 시간, 쿼리 처리 소요 시간 등이 있습니다.

로깅을 시작하려면:

query_thread_log 섹션에서 매개변수를 설정합니다.
log_query_threads를 1로 설정합니다.

데이터 플러시 주기는 query_thread_log 서버 설정 섹션의 flush_interval_milliseconds 매개변수에서 설정합니다. 강제로 플러시하려면 SYSTEM FLUSH LOGS 쿼리를 사용하십시오.

ClickHouse는 테이블에서 데이터를 자동으로 삭제하지 않습니다. 자세한 내용은 Introduction을 참조하십시오.

query_thread_log 테이블에 기록되는 쿼리 수를 줄이려면 log_queries_probability) 설정을 사용할 수 있습니다.

컬럼

hostname (LowCardinality(String)) — 쿼리를 실행한 서버의 호스트명입니다.
event_date (Date) — 스레드의 쿼리 실행이 완료된 날짜입니다.
event_time (DateTime) — 스레드의 쿼리 실행이 완료된 날짜 및 시간입니다.
event_time_microseconds (DateTime64(6)) — 스레드가 쿼리 실행을 마친 시점의 날짜와 시간으로, 마이크로초 정밀도를 지원합니다.
query_start_time (DateTime) — 쿼리 실행이 시작된 시간입니다.
query_start_time_microseconds (DateTime64(6)) — 마이크로초 단위 정밀도의 쿼리 실행 시작 시간입니다.
query_duration_ms (UInt64) — 쿼리 실행에 걸린 시간입니다.
read_rows (UInt64) — 읽은 행의 수입니다.
read_bytes (UInt64) — 읽은 바이트 수입니다.
written_rows (UInt64) — INSERT 쿼리의 경우 기록된 행 수입니다. 그 밖의 쿼리에서는 컬럼 값이 0입니다.
written_bytes (UInt64) — INSERT 쿼리에서는 기록된 바이트 수를 나타냅니다. 다른 쿼리에서는 컬럼 값이 0입니다.
memory_usage (Int64) — 이 스레드 컨텍스트에서 할당된 메모리 양과 해제된 메모리 양의 차이입니다.
peak_memory_usage (Int64) — 이 스레드 컨텍스트에서 할당된 메모리 양과 해제된 메모리 양의 차이의 최댓값입니다.
thread_name (LowCardinality(String)) — 스레드 이름.
thread_id (UInt64) — 내부 스레드 ID.
master_thread_id (UInt64) — 초기 스레드에 대한 OS 초기 ID.
current_database (LowCardinality(String)) — 현재 데이터베이스 이름입니다.
query (String) — 쿼리 문자열.
normalized_query_hash (UInt64) — 상수 등이 제거된 정규화된 쿼리의 해시입니다.
is_initial_query (UInt8) — 쿼리가 초기 쿼리인지 여부입니다. 가능한 값: 1 — 초기(최상위 수준) 쿼리, 0 — 분산 실행용 쿼리와 내부 서브쿼리를 포함하여 다른 쿼리에서 시작된 자식 쿼리입니다.
connection_address (IPv6) — 연결을 시작한 클라이언트의 IP 주소입니다. 프록시를 통해 연결한 경우 이 값은 프록시의 주소입니다.
connection_port (UInt16) — 연결이 설정된 클라이언트의 포트입니다. 프록시를 통해 연결된 경우에는 프록시의 포트가 됩니다.
user (LowCardinality(String)) — 현재 쿼리를 실행한 사용자의 이름입니다.
query_id (String) — 쿼리의 ID.
address (IPv6) — 쿼리를 보낼 때 사용된 IP 주소입니다. 프록시를 통해 연결되어 있고 auth_use_forwarded_address가 설정된 경우, 이 값은 프록시 주소가 아니라 클라이언트 주소가 됩니다.
port (UInt16) — 쿼리를 실행할 때 사용된 클라이언트 포트입니다. 프록시를 통해 연결되어 있고 auth_use_forwarded_address가 설정된 경우, 이 값은 프록시의 포트가 아니라 클라이언트의 포트입니다.
initial_user (LowCardinality(String)) — 동일한 쿼리 체인에서 초기 쿼리를 실행한 사용자의 이름입니다.
initial_query_id (String) — 동일한 쿼리 체인에서 초기 쿼리의 ID입니다.
initial_address (IPv6) — 동일한 쿼리 체인에서 초기 쿼리가 시작된 IP 주소입니다.
initial_port (UInt16) — 동일한 쿼리 체인에서 초기 쿼리가 시작된 클라이언트 포트입니다.
initial_query_start_time (DateTime) — 동일한 쿼리 체인에서 초기 쿼리의 시작 시간입니다.
initial_query_start_time_microseconds (DateTime64(6)) — 동일한 쿼리 체인에서 초기 쿼리의 시작 시간이며, 마이크로초 정밀도를 지원합니다.
authenticated_user (LowCardinality(String)) — 세션에서 인증된 사용자의 이름입니다.
interface (UInt8) — 쿼리가 시작된 인터페이스입니다. 가능한 값: 1 — TCP, 2 — HTTP.
is_secure (UInt8) — 연결이 보안되었는지 여부를 나타내는 플래그입니다.
os_user (LowCardinality(String)) — OS에서 clickhouse-client를 실행하는 사용자의 이름입니다.
client_hostname (LowCardinality(String)) — clickhouse-client 또는 다른 TCP 클라이언트가 실행되는 클라이언트 컴퓨터의 호스트명입니다.
client_name (LowCardinality(String)) — clickhouse-client 또는 다른 TCP 클라이언트의 이름입니다.
client_agent (LowCardinality(String)) — 환경 변수에서 감지한, 클라이언트를 호출한 AI 코딩 에이전트(예: claude-code, cursor)입니다. 에이전트가 감지되지 않으면 비어 있습니다.
client_revision (UInt32) — clickhouse-client 또는 다른 TCP 클라이언트의 버전입니다.
client_version_major (UInt32) — clickhouse-client 또는 다른 TCP 클라이언트의 주 버전입니다.
client_version_minor (UInt32) — clickhouse-client 또는 다른 TCP 클라이언트의 마이너 버전입니다.
client_version_patch (UInt32) — clickhouse-client 또는 다른 TCP 클라이언트 버전의 패치 버전입니다.
script_query_number (UInt32) — 다중 쿼리 스크립트에서의 순차적 쿌리 번호입니다.
script_line_number (UInt32) — 여러 쿼리로 구성된 스크립트에서 현재 쿼리가 시작되는 줄 번호입니다.
http_method (UInt8) — 쿼리를 시작한 HTTP 메서드입니다. 가능한 값: 0 - 쿼리가 TCP 인터페이스에서 시작되었습니다, 1 - GET 메서드가 사용되었습니다, 2 - POST 메서드가 사용되었습니다, 4 - PUT 메서드가 사용되었습니다, 5 - DELETE 메서드가 사용되었습니다, 6 - HEAD 메서드가 사용되었습니다.
http_user_agent (LowCardinality(String)) — HTTP 요청과 함께 전달되는 UserAgent 헤더입니다.
http_referer (String) — HTTP 쿼리와 함께 전달되는 HTTP 헤더 Referer입니다(쿼리를 보내는 페이지의 전체 주소 또는 일부 주소를 포함합니다).
forwarded_for (String) — HTTP 쿼리에서 전달되는 HTTP 헤더 X-Forwarded-For.
quota_key (String) — 쿼터 설정에서 지정한 'quota key'입니다.
distributed_depth (UInt64) — 쿼리가 서버 간에 몇 번 전달되었는지를 나타냅니다.
revision (UInt32) — ClickHouse 리비전입니다.
ProfileEvents (Map(LowCardinality(String), UInt64)) — 이 스레드의 다양한 메트릭을 측정하는 ProfileEvents입니다. 이에 대한 설명은 system.events 테이블에서 확인할 수 있습니다.

별칭:

ProfileEvents.Names — mapKeys(ProfileEvents)에 대한 별칭입니다.
ProfileEvents.Values — mapValues(ProfileEvents)에 대한 별칭입니다.

예시

 SELECT * FROM system.query_thread_log LIMIT 1 \G

Row 1:
──────
hostname:                      clickhouse.eu-central1.internal
event_date:                    2020-09-11
event_time:                    2020-09-11 10:08:17
event_time_microseconds:       2020-09-11 10:08:17.134042
query_start_time:              2020-09-11 10:08:17
query_start_time_microseconds: 2020-09-11 10:08:17.063150
query_duration_ms:             70
read_rows:                     0
read_bytes:                    0
written_rows:                  1
written_bytes:                 12
memory_usage:                  4300844
peak_memory_usage:             4300844
thread_name:                   TCPHandler
thread_id:                     638133
master_thread_id:              638133
query:                         INSERT INTO test1 VALUES
is_initial_query:              1
user:                          default
query_id:                      50a320fd-85a8-49b8-8761-98a86bcbacef
address:                       ::ffff:127.0.0.1
port:                          33452
initial_user:                  default
initial_query_id:              50a320fd-85a8-49b8-8761-98a86bcbacef
initial_address:               ::ffff:127.0.0.1
initial_port:                  33452
interface:                     1
os_user:                       bharatnc
client_hostname:               tower
client_name:                   ClickHouse
client_revision:               54437
client_version_major:          20
client_version_minor:          7
client_version_patch:          2
http_method:                   0
http_user_agent:
quota_key:
revision:                      54440
ProfileEvents:        {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'CompressedReadBufferBlocks':1,'CompressedReadBufferBytes':10,'IOBufferAllocs':1,'IOBufferAllocBytes':89,'ContextLock':15,'RWLockAcquiredReadLocks':1}

설명

컬럼

예시

관련 항목