콘텐츠로 건너뛰기
Telemetry
Telemetry SQL 요리책

하나의 연결된 SaaS 텔레메트리 데이터베이스에서 SQL 알아보기

가입부터 활성화, 모델 사용, 백그라운드 작업, 청구, API 오류 및 데이터베이스 작업까지 계정을 추적하세요. 모든 강의는 동일한 합성 테이블에 대해 로컬로 실행되므로 조인, 릴리스 비교 및 ​​비즈니스 정의가 계속 표시됩니다.

검토자 Telemetry 제품 팀 에 . 합성 데이터 계약, 조인 그레인, 읽기 전용 SQL, 예상 결과 및 해석 경계. 표준 및 소유권 검토

첫 수업 시작DuckDB 시드 다운로드

15

연결된 테이블

10953

결정적 합성 행

18

SQL 수업 안내

데이터 세트 계약

15개의 테이블, 명시적인 비즈니스 조인 키

합성 account_id 상업적 맥락을 제품, 신뢰성, AI, 직업 및 청구 결과에 연결합니다. 보다 구체적인 식별자는 배포와 선언된 인시던트를 연결하는 동시에 각 워크플로 내부의 정보를 보존합니다. 고객 기록, 프롬프트, 페이로드 또는 자격 증명은 포함되지 않습니다.

accounts6 행

고객 영향 분석에 필요한 차원과 반복 수익을 갖춘 하나의 합성 SaaS 계정입니다.

계정당 한 행입니다.

account_id
보기 5 필드
account_id Utf8
안정적인 합성 계정 식별자입니다.
plan Utf8
샘플 창 끝에 상업 계획이 나와 있습니다.
region Utf8
대략적인 호스팅 또는 고객 지역.
signup_at Timestamp
계정이 샘플 코호트에 들어간 경우.
monthly_revenue_usd Float64
합성 정규화된 월별 반복 수익입니다.
product_events21 행

활성화, 채택 및 여정 분석을 위한 내구성 있는 계정 및 사용자 이정표입니다.

하나의 완성된 제품 마일스톤.

account_iduser_idsession_id
보기 9 필드
timestamp_utc Timestamp
마일스톤이 완료되었을 때.
event_id Utf8
중복 제거를 위한 안정적인 식별자입니다.
account_id Utf8
이벤트에 합성 계정에 참여합니다.
user_id Utf8
합성 행위자 식별자.
session_id Utf8
그룹은 방문 내에서 이벤트를 주문했습니다.
event_name Utf8
안정적인 제품 마일스톤 이름.
feature Utf8
이벤트를 담당하는 제품 표면.
status Utf8
최종 마일스톤 결과.
release Utf8
이벤트를 생성한 애플리케이션 릴리스입니다.
api_requests10 행

안정적인 경로, 릴리스, 대기 시간 및 고객 컨텍스트를 통해 API 요청 이벤트를 완료했습니다.

1개의 API 요청이 완료되었습니다.

account_idrequest_id
보기 7 필드
timestamp_utc Timestamp
요청이 완료되면
request_id Utf8
안정적인 요청 상관 식별자입니다.
account_id Utf8
요청을 합성 계정에 조인합니다.
route_template Utf8
원시 식별자가 없는 제한된 경로 모양입니다.
status_code Int64
최종 HTTP 응답 상태.
latency_ms Float64
엔드투엔드 요청 기간.
release Utf8
요청을 처리하는 애플리케이션 릴리스입니다.
llm_requests11 행

정규화된 공급자 사용량, 예상 비용, 재시도 및 검토된 제품 결과 필드입니다.

공급자가 별도의 행으로 재시도하는 것을 포함하여 하나의 완료된 모델 요청입니다.

account_idrequest_id
보기 12 필드
timestamp_utc Timestamp
공급자 요청이 완료된 경우.
request_id Utf8
안정적인 모델 요청 식별자입니다.
account_id Utf8
모델 사용을 합성 계정에 조인합니다.
feature Utf8
모델을 사용한 제품 워크플로우.
provider Utf8
정규화된 모델 공급자.
model Utf8
요청 시 캡처된 공급자 모델 식별자입니다.
input_tokens Int64
공급자가 보고한 입력 토큰 수입니다.
output_tokens Int64
공급자가 보고한 출력 토큰 수입니다.
estimated_cost_usd Float64
버전이 지정된 가격 책정 규칙에 따른 예상 요청 비용입니다.
status Utf8
최종 공급자 요청 결과입니다.
retry_count Int64
이 논리 작업에 대한 자동 공급자 재시도 횟수입니다.
accepted Boolean
사용자가 결과 출력을 수락했는지 또는 저장했는지 여부입니다.
job_runs7 행

대기열 및 실행 타이밍이 포함된 시도 수준의 백그라운드 작업 결과입니다.

논리적 백그라운드 작업을 한 번 시도합니다.

account_idjob_id
보기 9 필드
timestamp_utc Timestamp
시도가 최종 결과에 도달했을 때.
job_id Utf8
재시도에 의해 공유되는 논리적 작업 식별자입니다.
account_id Utf8
합성 계정에 작업 영향을 결합합니다.
job_name Utf8
제한된 작업자 작업 이름입니다.
status Utf8
시도 결과.
attempt Int64
단일 인덱스 시도 횟수입니다.
queue_wait_ms Float64
실행 전 대기 시간입니다.
duration_ms Float64
작업자 실행 시간.
error_type Utf8
제어된 실패 범주 또는 성공 시 null입니다.
billing_events5 행

제품 동작과 신뢰성을 상업적 맥락에 연결하기 위한 합성 구독 결과입니다.

하나의 완료된 청구 수명주기 이벤트입니다.

account_idevent_id
보기 6 필드
timestamp_utc Timestamp
결제 이벤트가 완료되었을 때.
event_id Utf8
안정적인 공급자 이벤트 식별자입니다.
account_id Utf8
이벤트에 합성 계정에 참여합니다.
event_name Utf8
정규화된 청구 수명주기 결과.
amount_usd Float64
합성 표준화된 양입니다.
status Utf8
최종 청구 이벤트 결과.
users24 행

개인 데이터 없이 역할, 라이프사이클, 채택 분석을 위한 합성 사용자입니다.

합성 사용자당 한 행입니다.

user_idaccount_id
보기 5 필드
user_id Utf8
안정적인 합성 사용자 식별자.
account_id Utf8
합성 사용자를 소유한 계정입니다.
role Utf8
세분화에 사용되는 대략적인 제품 역할입니다.
created_at Timestamp
합성 사용자가 계정에 가입한 경우.
is_admin Boolean
사용자가 계정을 관리할 수 있는지 여부입니다.
releases12 행

릴리스 전후의 서비스 동작을 비교하기 위한 배포 차원입니다.

서비스 릴리스당 한 행입니다.

releaseservice
보기 5 필드
release Utf8
서비스 이벤트에서 내보낸 버전입니다.
service Utf8
배포를 받는 서비스입니다.
deployed_at Timestamp
UTC 배포 시간.
owner_team Utf8
서비스를 담당하는 합성팀입니다.
change_type Utf8
거친 릴리스 분류.
incidents2 행

영향을 받은 계정, 오류 규모 및 복구를 측정하기 위한 사고 창을 선언했습니다.

선언된 사건당 하나의 행입니다.

incident_idservice
보기 6 필드
incident_id Utf8
안정적인 합성 사고 식별자입니다.
service Utf8
주요 영향을 받는 서비스입니다.
started_at Timestamp
선언된 영향 기간이 시작됩니다.
resolved_at Timestamp
선언된 영향 기간이 종료됩니다.
severity Utf8
합성 운영 심각도.
root_cause_category Utf8
대략적이고 민감하지 않은 원인 분류입니다.
service_events10800 행

현실적인 추세, 백분위수, 릴리스 및 사고 분석을 위한 30일 서비스 이벤트 사실표입니다.

하나의 완료된 요청 또는 백그라운드 작업.

account_idreleaseserviceincident_id
보기 11 필드
timestamp_utc Timestamp
UTC 완료 타임스탬프입니다.
event_id Utf8
중복 제거를 위한 안정적인 이벤트 식별자입니다.
account_id Utf8
작업의 영향을 받는 합성 고객 계정입니다.
service Utf8
작업을 완료한 서비스입니다.
event_name Utf8
작업 완료 시 안정적인 이벤트 이름입니다.
status Utf8
최종 성공 또는 오류 결과.
latency_ms Int64
밀리초 단위의 엔드투엔드 작업 대기 시간입니다.
release Utf8
작업에 대한 서비스 릴리스가 활성화되었습니다.
incident_id Utf8
이벤트가 영향을 받는 기간에 있을 때 사건이 선언되었습니다.
region Utf8
대략적인 합성 계정 영역.
error_type Utf8
낮은 카디널리티 실패 카테고리 또는 성공 시 null입니다.
database_operations16 행

쿼리 지문, 릴리스, 대기 시간 및 SQLSTATE 결과를 사용하여 표준화된 데이터베이스 작업.

하나의 완료된 데이터베이스 작업입니다.

account_idservicerelease
보기 12 필드
timestamp_utc Timestamp
작업 완료 시간(UTC)입니다.
operation_id Utf8
안정적인 작업 식별자입니다.
account_id Utf8
작업을 시작한 계정입니다.
service Utf8
쿼리를 발행하는 애플리케이션 서비스입니다.
database_name Utf8
논리적 데이터베이스 이름입니다.
query_fingerprint Utf8
정규화된 쿼리 계열.
operation Utf8
SQL 작동 유형.
status Utf8
작업 결과.
duration_ms Int64
밀리초 단위의 엔드투엔드 기간입니다.
rows_affected Int64
반환되거나 변경된 행입니다.
release Utf8
애플리케이션 출시.
sqlstate Utf8
작업이 실패했을 때의 SQLSTATE 코드입니다.
database_pool_samples12 행

특정 시점 연결 풀 압력, 대기 시간 및 획득 시간 초과.

하나의 연결 풀 샘플.

servicedatabase_namerelease
보기 11 필드
timestamp_utc Timestamp
UTC 기준 샘플 시간입니다.
service Utf8
응용 서비스.
pool_name Utf8
연결 풀 이름.
database_name Utf8
대상 데이터베이스.
active_connections Int64
체크아웃된 연결.
idle_connections Int64
유휴 연결이 가능합니다.
max_connections Int64
풀 연결 제한.
acquire_wait_ms Int64
연결 획득 대기.
timed_out Boolean
획득 시간이 초과되었는지 여부.
region Utf8
배포 지역.
release Utf8
애플리케이션 출시.
database_lock_events6 행

차단된 작업군과 차단한 작업군을 포함해 해결된 잠금 대기 및 교착 상태.

1개의 데이터베이스 잠금 대기가 관찰되었습니다.

servicedatabase_namerelease
보기 11 필드
timestamp_utc Timestamp
UTC 기준 관측 시간을 기다립니다.
database_name Utf8
영향을 받은 데이터베이스.
service Utf8
차단된 애플리케이션 서비스.
blocked_operation Utf8
차단된 쿼리 계열.
blocking_operation Utf8
차단 쿼리 계열.
lock_type Utf8
데이터베이스 잠금 클래스.
wait_ms Int64
잠금 대기가 관찰되었습니다.
resolved Boolean
대기가 해결되었는지 여부.
deadlock Boolean
대기가 교착 상태가 되었는지 여부.
transaction_id Utf8
차단된 거래 식별자입니다.
release Utf8
애플리케이션 출시.
replication_samples12 행

운영 데이터베이스, CDC 및 검색에 대한 복제본 및 다운스트림 소비자 지연.

복제 소비자 샘플 1개.

consumer_namerelease
보기 8 필드
timestamp_utc Timestamp
UTC 기준 샘플 시간입니다.
consumer_name Utf8
복제본 또는 다운스트림 소비자.
source_type Utf8
복제 메커니즘.
region Utf8
소비자 지역.
lag_seconds Int64
복제 지연이 관찰되었습니다.
backlog_bytes Int64
적용되지 않은 백로그(바이트)입니다.
status Utf8
소비자 건강 분류.
release Utf8
애플리케이션 출시.
migration_runs9 행

실패 및 롤백을 포함한 애플리케이션 데이터베이스 마이그레이션 실행.

한 번의 마이그레이션 실행.

servicedatabase_namerelease
보기 8 필드
timestamp_utc Timestamp
마이그레이션 완료 시간(UTC)입니다.
migration_id Utf8
마이그레이션 식별자.
service Utf8
소유 서비스.
database_name Utf8
대상 데이터베이스.
release Utf8
애플리케이션 출시.
status Utf8
마이그레이션 결과.
duration_ms Int64
마이그레이션 기간.
error_type Utf8
실패 클래스(존재하는 경우)

가입하기 전에 줄이세요

계정 및 수익 컨텍스트를 추가하기 전에 요청, 시도 또는 마일스톤을 비즈니스 단위로 축소하세요.

건설에 의한 합성

데이터세트는 결정적이고 버전이 지정되어 있으며 추세와 백분위수를 파악하기에 충분히 큽니다. 고객 벤치마크보다는 논리를 보여줍니다.

통역은 수업의 일부입니다.

모든 쿼리에는 분모, 비즈니스 결정 및 결과가 뒷받침할 수 없는 주장이 명시됩니다.

SQL 방언 호환성

DuckDB의 프로토타입, DataFusion 테스트를 거친 구문과 함께 제공

브라우저 랩에서는 DuckDB를 사용하므로 데이터가 페이지를 벗어나지 않습니다. Telemetry 프로덕션 쿼리는 Apache DataFusion를 사용합니다. 수업은 의도적으로 공유 SQL 표면 내에 유지됩니다. 기능이 다를 경우 대시보드나 알림을 저장하기 전에 아래 제작 양식을 사용하세요.

사용 사례브라우저 연구실Telemetry / DataFusion안내
시간 버킷date_trunc('일', timestamp_utc)date_trunc('일', timestamp_utc)공유 구문; 버킷을 UTC로 유지합니다.
조건부 개수SUM(CASE WHEN … THEN 1 ELSE 0 END)SUM(CASE WHEN … THEN 1 ELSE 0 END)공유 구문 및 명시적 분모.
대략적인 p95approx_quantile(latency_ms, 0.95)approx_percentile_cont(latency_ms, 0.95)기능 이름은 엔진마다 다릅니다.
안전분할값 / NULLIF(합계, 0)값 / NULLIF(합계, 0)공유 구문; 정수 나누기가 중요할 때 캐스팅됩니다.
DataFusion SQL 참조검증 제품군 보기
기초초보자

일일 제품 활동 요약

사용자는 매일 어떤 마일스톤을 완료하고 있나요?

하나의 이벤트 테이블로 시작하고 내구성 있는 제품 이정표를 UTC 날짜로 그룹화하고 모든 시도와 별도로 성공적인 볼륨을 유지합니다.

데이터 세트와 쿼리는 이 브라우저에 남아 있습니다.

Published expected result

일일 성공적인 제품 이정표

activity_dayeventssuccessful_eventsactive_accounts
2026-07-01221
2026-07-02442
2026-07-03322
2026-07-04441
2026-07-05332
2026-07-06221
2026-07-08111
2026-07-09111
2026-07-12111

쿼리를 읽는 방법

  • UTC 날짜는 클라이언트가 제공한 날짜 레이블 대신 이벤트 타임스탬프에서 파생됩니다.
  • 이벤트 볼륨과 개별 활성 계정은 서로 다른 질문에 답하므로 둘 다 계속 표시됩니다.
  • 상태 조건은 실패한 통합 시도가 완료된 마일스톤으로 계산되는 것을 방지합니다.

SQL이 내릴 수 없는 결정

  1. 1재시도 및 반복되는 마일스톤을 계속 표시할지 여부를 결정합니다.
  2. 2이를 채택으로 처리하기 전에 내부, 테스트 또는 봇 계정을 제외하세요.
  3. 3최근 날짜를 비교할 때는 전체 시간 버킷을 사용하세요.

이 강의에서 계속

SQL 시간 버킷팅조건부 집계

연구실에서 자체 이벤트 계약으로 이동

분석 그레인과 조인 논리를 유지한 다음 합성 테이블을 안정적인 이벤트 이름과 개인정보 보호가 승인된 식별자로 바꿉니다. 쿼리를 대시보드나 알림로 승격하기 전에 이를 소유한 팀과 함께 임계값과 상업적 정의를 검증하세요.

테스트 방법론이벤트 스키마 가이드이벤트 스키마 찾아보기대시보드 예시나만의 이벤트 활용

데이터 세트 사용 및 출처

Telemetry는 학습, 테스트, 내부 평가 및 예제를 위한 결정론적 합성 데이터세트를 만들었습니다. 이러한 목적으로 행, 스키마 및 SQL 단원을 복사하고 조정할 수 있습니다. 저작자는 높이 평가되지만 필수는 아닙니다. 데이터 세트에는 고객 기록이 포함되어 있지 않으며 성능 또는 비즈니스 결과 보증 없이 제공됩니다.

JSON 패키지DuckDB 시드 SQLaccounts.csvproduct_events.csvapi_requests.csvllm_requests.csvjob_runs.csvbilling_events.csv사용자.csvreleases.csvincidents.csvservice_events.csvdatabase_operations.csvdatabase_pool_samples.csvdatabase_lock_events.csvreplication_samples.csvmigration_runs.csv