본문으로 건너뛰기
sigiro
Esc
↑↓이동↵열기⌘J미리보기
이 페이지에서

텔레메트리 테이블 열

현재 DuckDB 열 이름, 유형, 단위 및 1.0 이전 호환성.

다음은 src/schema.rs에서 생성하는 쿼리 가능한 7개 sigiro_* 테이블입니다. 유형은 DuckDB SQL 유형이며 선언된 NOT NULL을 표시합니다. 쿼리에서는 lake. 접두사와 짧은 테이블 이름을 모두 사용합니다. 이는 현재 스키마의 참고 자료이며 런타임 스키마 검색 API가 아닙니다.

1.0 이전 호환성: 열 이름, 유형, JSON 형태는 1.0 이전에 바뀔 수 있습니다. 이 문서는 DuckLake/Parquet 디스크 형식의 안정성, 자동 인플레이스 업그레이드 또는 다운그레이드 지원을 보장하지 않습니다. 저장소 형식 검증과 업그레이드 정책은 별도 작업 #200, 런타임 스키마 검색은 #13에서 다룹니다.

TIMESTAMP는 마이크로초 정밀도의 DuckDB 타임스탬프입니다. 숫자 에폭 시각(end_timestamp, observed_timestamp, 메트릭 start_timestamp)과 스팬 duration은 OTLP 나노초를 변환한 마이크로초입니다. 반면 events_json 및 exemplars_json 내부의 time_unix_nano는 나노초 그대로입니다. 메트릭 값과 히스토그램 경계의 단위는 전송자의 metric_unit, 프로파일 값은 unit에 따릅니다.

속성과 JSON 배열은 네이티브 JSON 열이 아닌 **JSON을 담은 VARCHAR**입니다. 속성 키는 json_extract_string(column, 'key')로 읽으세요. 키는 전송자마다 달라 이 목록에 포함되지 않습니다. DDL에서 nullable이라도 현재 수집 경로가 반드시 null을 쓰는 것은 아닙니다.

sigiro_spans

열 유형 단위 의미
timestamp TIMESTAMP NOT NULL µs precision 이벤트 또는 데이터 포인트 시각.
end_timestamp BIGINT NOT NULL epoch µs 스팬 종료 시각.
duration BIGINT NOT NULL µs 스팬 경과 시간.
trace_id VARCHAR — 추적 ID(16진 문자열).
span_id VARCHAR — 스팬 ID(16진 문자열).
parent_span_id VARCHAR — 부모 스팬 ID(16진 문자열).
trace_state VARCHAR — W3C 추적 상태.
service_name VARCHAR NOT NULL — OTel 리소스의 service.name.
service_namespace VARCHAR — OTel 리소스의 service.namespace.
service_instance_id VARCHAR — OTel 리소스의 service.instance.id.
span_name VARCHAR NOT NULL — 스팬 작업 이름.
span_kind INTEGER NOT NULL — OTLP 스팬 종류 열거값.
status_code INTEGER NOT NULL — OTLP 상태 코드 열거값.
status_message VARCHAR — 스팬 상태 메시지.
resource_attributes VARCHAR — 리소스 속성의 JSON 문자열.
scope_name VARCHAR — 계측 범위 이름.
scope_version VARCHAR — 계측 범위 버전.
scope_attributes VARCHAR — 범위 속성의 JSON 문자열.
span_attributes VARCHAR — 스팬 속성의 JSON 문자열.
events_json VARCHAR — 스팬 이벤트의 JSON 배열 문자열.
links_json VARCHAR — 스팬 링크의 JSON 배열 문자열.
dropped_attributes_count INTEGER count 버려진 스팬 속성 수.
dropped_events_count INTEGER count 버려진 스팬 이벤트 수.
dropped_links_count INTEGER count 버려진 스팬 링크 수.
flags INTEGER — OTLP 플래그 비트 필드.

sigiro_logs

열 유형 단위 의미
timestamp TIMESTAMP NOT NULL µs precision 이벤트 또는 데이터 포인트 시각.
observed_timestamp BIGINT NOT NULL epoch µs 로그 관측 시각.
trace_id VARCHAR — 추적 ID(16진 문자열).
span_id VARCHAR — 스팬 ID(16진 문자열).
event_name VARCHAR — 로그 이벤트 이름.
service_name VARCHAR NOT NULL — OTel 리소스의 service.name.
service_namespace VARCHAR — OTel 리소스의 service.namespace.
service_instance_id VARCHAR — OTel 리소스의 service.instance.id.
severity_number INTEGER NOT NULL — OTLP 심각도 번호.
severity_text VARCHAR NOT NULL — 심각도 레이블.
body VARCHAR — 로그 본문 문자열.
resource_attributes VARCHAR — 리소스 속성의 JSON 문자열.
scope_name VARCHAR — 계측 범위 이름.
scope_version VARCHAR — 계측 범위 버전.
scope_attributes VARCHAR — 범위 속성의 JSON 문자열.
log_attributes VARCHAR — 로그 속성의 JSON 문자열.
template_id UBIGINT — DRAIN 로그 템플릿 해시.
template_values VARCHAR — 원래 변수 토큰의 JSON 배열 문자열.
template_text VARCHAR — DRAIN 분류 로그 템플릿.

sigiro_metrics_gauge

열 유형 단위 의미
timestamp TIMESTAMP NOT NULL µs precision 이벤트 또는 데이터 포인트 시각.
start_timestamp BIGINT epoch µs 메트릭 데이터 포인트 시작 시각.
metric_name VARCHAR NOT NULL — 메트릭 이름.
metric_description VARCHAR — 메트릭 설명.
metric_unit VARCHAR — 전송자가 지정한 단위.
value DOUBLE NOT NULL metric_unit 게이지 데이터 포인트 값.
service_name VARCHAR NOT NULL — OTel 리소스의 service.name.
service_namespace VARCHAR — OTel 리소스의 service.namespace.
service_instance_id VARCHAR — OTel 리소스의 service.instance.id.
resource_attributes VARCHAR — 리소스 속성의 JSON 문자열.
scope_name VARCHAR — 계측 범위 이름.
scope_version VARCHAR — 계측 범위 버전.
scope_attributes VARCHAR — 범위 속성의 JSON 문자열.
metric_attributes VARCHAR — 데이터 포인트 속성의 JSON 문자열.
flags INTEGER — OTLP 플래그 비트 필드.
exemplars_json VARCHAR — 예시값의 JSON 배열 문자열.

sigiro_metrics_sum

열 유형 단위 의미
timestamp TIMESTAMP NOT NULL µs precision 이벤트 또는 데이터 포인트 시각.
start_timestamp BIGINT epoch µs 메트릭 데이터 포인트 시작 시각.
metric_name VARCHAR NOT NULL — 메트릭 이름.
metric_description VARCHAR — 메트릭 설명.
metric_unit VARCHAR — 전송자가 지정한 단위.
value DOUBLE NOT NULL metric_unit 합계 데이터 포인트 값.
service_name VARCHAR NOT NULL — OTel 리소스의 service.name.
service_namespace VARCHAR — OTel 리소스의 service.namespace.
service_instance_id VARCHAR — OTel 리소스의 service.instance.id.
resource_attributes VARCHAR — 리소스 속성의 JSON 문자열.
scope_name VARCHAR — 계측 범위 이름.
scope_version VARCHAR — 계측 범위 버전.
scope_attributes VARCHAR — 범위 속성의 JSON 문자열.
metric_attributes VARCHAR — 데이터 포인트 속성의 JSON 문자열.
flags INTEGER — OTLP 플래그 비트 필드.
exemplars_json VARCHAR — 예시값의 JSON 배열 문자열.
aggregation_temporality INTEGER NOT NULL — OTLP 집계 시간성 열거값.
is_monotonic BOOLEAN NOT NULL — 합계가 단조 증가하는지 여부.

sigiro_metrics_histogram

열 유형 단위 의미
timestamp TIMESTAMP NOT NULL µs precision 이벤트 또는 데이터 포인트 시각.
start_timestamp BIGINT epoch µs 메트릭 데이터 포인트 시작 시각.
metric_name VARCHAR NOT NULL — 메트릭 이름.
metric_description VARCHAR — 메트릭 설명.
metric_unit VARCHAR — 전송자가 지정한 단위.
count BIGINT NOT NULL samples 샘플 수.
sum DOUBLE metric_unit 기록된 값의 합.
min DOUBLE metric_unit 기록된 값의 최솟값.
max DOUBLE metric_unit 기록된 값의 최댓값.
bucket_counts VARCHAR NOT NULL samples 명시적 히스토그램 버킷 개수의 JSON 배열 문자열.
explicit_bounds VARCHAR NOT NULL metric_unit 명시적 히스토그램 경계의 JSON 배열 문자열.
service_name VARCHAR NOT NULL — OTel 리소스의 service.name.
service_namespace VARCHAR — OTel 리소스의 service.namespace.
service_instance_id VARCHAR — OTel 리소스의 service.instance.id.
resource_attributes VARCHAR — 리소스 속성의 JSON 문자열.
scope_name VARCHAR — 계측 범위 이름.
scope_version VARCHAR — 계측 범위 버전.
scope_attributes VARCHAR — 범위 속성의 JSON 문자열.
metric_attributes VARCHAR — 데이터 포인트 속성의 JSON 문자열.
flags INTEGER — OTLP 플래그 비트 필드.
exemplars_json VARCHAR — 예시값의 JSON 배열 문자열.
aggregation_temporality INTEGER NOT NULL — OTLP 집계 시간성 열거값.

sigiro_metrics_exp_histogram

열 유형 단위 의미
timestamp TIMESTAMP NOT NULL µs precision 이벤트 또는 데이터 포인트 시각.
start_timestamp BIGINT epoch µs 메트릭 데이터 포인트 시작 시각.
metric_name VARCHAR NOT NULL — 메트릭 이름.
metric_description VARCHAR — 메트릭 설명.
metric_unit VARCHAR — 전송자가 지정한 단위.
count BIGINT NOT NULL samples 샘플 수.
sum DOUBLE metric_unit 기록된 값의 합.
min DOUBLE metric_unit 기록된 값의 최솟값.
max DOUBLE metric_unit 기록된 값의 최댓값.
scale INTEGER NOT NULL — 지수 히스토그램 스케일.
zero_count BIGINT NOT NULL samples 영 버킷 개수.
zero_threshold DOUBLE metric_unit 영 버킷 임계값.
positive_offset INTEGER — 양수 버킷 인덱스 오프셋.
positive_bucket_counts VARCHAR samples 양수 버킷 개수의 JSON 배열 문자열.
negative_offset INTEGER — 음수 버킷 인덱스 오프셋.
negative_bucket_counts VARCHAR samples 음수 버킷 개수의 JSON 배열 문자열.
service_name VARCHAR NOT NULL — OTel 리소스의 service.name.
service_namespace VARCHAR — OTel 리소스의 service.namespace.
service_instance_id VARCHAR — OTel 리소스의 service.instance.id.
resource_attributes VARCHAR — 리소스 속성의 JSON 문자열.
scope_name VARCHAR — 계측 범위 이름.
scope_version VARCHAR — 계측 범위 버전.
scope_attributes VARCHAR — 범위 속성의 JSON 문자열.
metric_attributes VARCHAR — 데이터 포인트 속성의 JSON 문자열.
flags INTEGER — OTLP 플래그 비트 필드.
exemplars_json VARCHAR — 예시값의 JSON 배열 문자열.
aggregation_temporality INTEGER NOT NULL — OTLP 집계 시간성 열거값.

sigiro_profiles

열 유형 단위 의미
profile_id VARCHAR — 프로파일 ID.
trace_id VARCHAR — 추적 ID(16진 문자열).
span_id VARCHAR — 스팬 ID(16진 문자열).
service_name VARCHAR NOT NULL — OTel 리소스의 service.name.
timestamp TIMESTAMP NOT NULL µs precision 이벤트 또는 데이터 포인트 시각.
profile_type VARCHAR — 프로파일 샘플 유형.
stack_trace VARCHAR[] — 순서대로 해석된 스택 프레임.
value BIGINT unit 이 값 유형의 샘플 값.
unit VARCHAR — 프로파일 샘플 유형의 단위.
resource_attributes VARCHAR — 리소스 속성의 JSON 문자열.

이 페이지가 도움이 되었나요?