콘텐츠로 건너뛰기
Telemetry
Telemetry 문서

첫 이벤트를 보내고 첫 대시보드를 만드세요.

프로덕션 계측, SDK, API, 구조화된 이벤트 설계, DataFusion SQL, 대시보드, 알림 및 문제 해결을 통해 첫 번째 이벤트에서 Telemetry를 알아보세요.

검토자 Telemetry 제품 팀 . 주제, 탐색 구조, 출처, 프로덕션에서 Telemetry를 사용하는 방법을 확인했습니다. 이 페이지의 검토 담당자

98

문서 페이지

5

학습 섹션

사람을 위한 HTML, 에이전트을 위한 Markdown

사이트에서 각 문서를 읽거나 원본 Markdown 버전을 코딩 에이전트에 전달하세요.

목표별로 선택

결정 또는 구현 경계부터 시작하세요.

AI 및 에이전트 워크플로 모니터링

기본적으로 원시 프롬프트를 저장하지 않고도 모델 사용, 비용, 대기 시간, 도구, 검색 품질 및 검토된 제품 결과를 연결합니다.

누락된 이벤트나 결과 문제 해결하기

계측을 변경하기 전에 수집, 스키마, 쿼리, 알림 및 다운스트림 전달 실패를 분리하세요.

시작하기

키를 생성하고, 첫 번째 이벤트를 전송 및 확인하고, SQL을 작성하고, 초기 프로덕션 체크리스트를 완료합니다.

빠른 시작

구조화된 이벤트를 보내고, 해당 테이블을 검사하고, SQL로 쿼리하고, 결과를 대시보드 또는 알림로 전환합니다.

페이지 읽기

첫 번째 구조화된 이벤트 보내기

쓰기 범위 API 키를 생성하고, 하나의 합성 구조화된 이벤트를 전송하고, 프로덕션에 계속 유용한 이벤트 이름과 필드를 선택합니다.

페이지 읽기

이벤트 수집 및 스키마 확인

계측을 확장하기 전에 테스트 이벤트가 의도한 유형, 타임스탬프, 식별자 및 개인 정보 보호 경계가 포함된 예상 테이블에 도달했는지 확인하세요.

페이지 읽기

첫 번째 Telemetry SQL 쿼리 작성

검증된 구조적 이벤트 테이블을 쿼리하고, 볼륨 및 오류율을 계산하고, 원시 행을 검사하고, 알려진 합성 픽스처에 대해 결과를 검증합니다.

페이지 읽기

첫 번째 대시보드 및 알림 만들기

검증된 쿼리를 집중된 대시보드 위젯으로 승격하고 명시적인 소유자, 기간 및 대응 작업이 포함된 임계값 알림을 제공합니다.

페이지 읽기

프로덕션 계측 체크리스트

프로덕션 롤아웃 전에 이벤트 소유권, 스키마 안정성, 민감한 데이터 경계, 자격 증명, 오류 동작, 보존, 쿼리, 대시보드 및 알림을 검토하세요.

페이지 읽기

API 키 및 인증

신뢰할 수 없는 클라이언트에 대한 수집 또는 쿼리 액세스를 노출하지 않고 Telemetry API 키를 생성, 범위 지정, 저장, 회전 및 취소합니다.

페이지 읽기

팀, 작업 영역, 구성원 및 역할

분석을 팀 작업공간으로 구성하고, 구성원을 초대하고, 관리자 및 구성원 역할을 이해하고, 데이터를 공유하기 전에 액세스를 검토하세요.

페이지 읽기

사용량, 청구 및 요금제 한도

스토리지 및 쿼리 기간 사용량을 검토하고, 무료 요금제 시행을 이해하고, 현재 가격을 비교하고, 안전하게 업그레이드를 계획하세요.

페이지 읽기

SDK 및 HTTP

명시적인 전달 및 자격 증명 경계가 있는 서버 측 JavaScript, Python, Rust, Go, Ruby, PHP 또는 cURL을 사용합니다.

JavaScript 및 TypeScript SDK

Telemetry JavaScript SDK를 설치하고, 구조화된 이벤트를 보내고, 입력된 SQL 쿼리를 실행하고, 전달을 확인하고, 프로덕션 실패 모드를 처리합니다.

페이지 읽기

Python SDK

동기식 및 비동기식 Telemetry Python 클라이언트를 사용하여 이벤트, 쿼리 데이터, 행 일괄 처리를 보내고 프로덕션 납품을 안전하게 처리합니다.

페이지 읽기

Rust SDK

차단 Telemetry Rust 클라이언트를 초기화하고, 구조화된 JSON 이벤트를 보내고, SQL을 쿼리하고, 안전한 프로덕션 전달 동작을 설계합니다.

페이지 읽기

Go SDK

Telemetry Go 클라이언트를 초기화하고, 구조화된 이벤트를 보내고, SQL을 쿼리하고, 전달을 확인하고, 안전한 프로덕션 시간 제한 및 재시도를 설계합니다.

페이지 읽기

Ruby HTTP 통합

구조화된 이벤트를 보내고, SQL을 실행하고, Net::HTTP 시간 초과를 구성하고, 스키마를 확인하고, Ruby에서 Telemetry API 오류를 안전하게 처리합니다.

페이지 읽기

PHP HTTP 통합

구조화된 이벤트를 보내고, SQL을 실행하고, cURL 시간 초과를 구성하고, 스키마를 확인하고, PHP에서 Telemetry API 오류를 안전하게 처리합니다.

페이지 읽기

cURL 및 HTTP API 예

cURL을 사용하여 이벤트를 보내고, 스키마를 검사하고, SQL을 실행하고, Parquet를 내보내고, Telemetry HTTP 오류를 안전하게 처리하세요.

페이지 읽기

자바 HTTP 통합

공유 HttpClient, 제한된 시간 초과, 안전한 JSON 및 명시적인 오류 처리를 통해 Java에서 구조화된 Telemetry 이벤트 및 SQL 쿼리를 보냅니다.

페이지 읽기

.NET HTTP 통합

IHttpClientFactory, 제한된 시간 초과, 형식화된 페이로드 및 명시적 오류 처리를 사용하여 .NET에서 구조화된 Telemetry 이벤트 및 SQL 쿼리를 보냅니다.

페이지 읽기

개념 및 SQL 패턴

안정적인 이벤트 계약을 설계하고, 스키마 및 카디널리티를 제어하고, 재사용 가능한 DataFusion SQL 패턴을 사용하세요.

Telemetry 아키텍처

Telemetry가 이벤트를 검증 및 버퍼링하고, Parquet를 S3에 저장하고, SQL 쿼리에 대한 최신 데이터와 기록 데이터를 결합하는 방법을 알아보세요.

페이지 읽기

대시보드 만들기

Explore 및 SQL 쿼리 결과에서 집중적인 Telemetry 대시보드를 구축한 다음 빠른 운영 결정을 위해 위젯을 정렬하세요.

페이지 읽기

스키마 진화

Telemetry가 이벤트 필드가 추가되거나 유형이 변경됨에 따라 적응하는 방법과 분석 중단 없이 스키마를 발전시키는 방법을 알아보세요.

페이지 읽기

파티션 열 선택

파티션 열을 사용하여 선택적 Telemetry 쿼리가 더 적은 양의 데이터를 검색하도록 합니다.

페이지 읽기

중첩된 JSON 쿼리하기

안정된 점으로 구분된 열 이름을 사용하여 Telemetry의 최상위 및 중첩 JSON 필드를 쿼리합니다.

페이지 읽기

타임스탬프 작업

타임스탬프를 일관되게 저장하고 SQL을 사용하여 시간 간격을 추출, 버킷, 비교 및 측정합니다.

페이지 읽기

CamelCase와 snake_case

snake_case가 Telemetry 이벤트 데이터에 대해 더 간단하고 이식성이 뛰어난 SQL 열 이름을 생성하는 이유를 이해합니다.

페이지 읽기

구조화된 이벤트와 텍스트 로그

구조화된 이벤트와 텍스트 로그를 각각 언제 사용해야 하는지, SQL에서 어떻게 다른지, 텔레메트리 중복을 방지하는 방법을 포함하여 비교하세요.

페이지 읽기

로그, 메트릭, 추적 및 구조화된 이벤트

중복된 데이터를 수집하지 않고 디버깅, 추세, 요청 경로 및 비즈니스 워크플로에 적합한 옵저버빌리티 신호를 선택하세요.

페이지 읽기

이벤트 스키마 디자인

안정적인 SQL, 대시보드, 알림 및 스키마 발전을 위해 안정적인 이벤트 이름과 타입이 지정된 필드를 만듭니다.

페이지 읽기

높은 카디널리티 필드

SQL, 대시보드 및 파티션에서 사용자 ID, 요청 ID, URL 및 기타 카디널리티가 높은 이벤트 필드를 의도적으로 사용하십시오.

페이지 읽기

구조화된 이벤트에 대한 상관 ID

민감한 데이터와 불안정한 조인을 피하면서 안전한 상관 관계 식별자를 사용하여 요청, 작업, 웹후크 및 추적을 연결하세요.

페이지 읽기

이벤트에서 민감한 데이터 수정

허용 목록 및 경계 수준 제어를 통해 비밀, 개인 데이터 및 원시 고객 콘텐츠가 구조화된 이벤트에 입력되는 것을 방지합니다.

페이지 읽기

DataFusion SQL Telemetry에 대한 참조

시간 필터, 조건부 집계, 백분위수, 창, 조인 및 안전 비율을 사용하여 Telemetry 이벤트 테이블에 대한 실용적인 DataFusion SQL을 작성합니다.

페이지 읽기

이벤트 전달, 멱등성 및 중복 처리

재시도, 중복 전달, 안정적인 이벤트 ID 및 측정 가능한 수집 실패를 위한 구조적 이벤트 생성자를 설계합니다.

페이지 읽기

일괄 처리, 역압 및 정상적인 종료

안전한 배치 크기, 바인딩된 텔레메트리 대기열을 선택하고, 과부하를 처리하고, 애플리케이션 종료 중에 보류 중인 이벤트를 플러시하거나 유지합니다.

페이지 읽기

구조화된 Telemetry에 대한 이벤트 샘플링 전략

비율, 백분위수, 사고 조사 또는 고객 영향 분석을 무효화하지 않고 텔레메트리 볼륨을 줄입니다.

페이지 읽기

이벤트 분석을 위한 다중 테넌트 ID 모델링

ID 의미 체계를 혼합하거나 개인 데이터를 노출하지 않고 계정, 사용자, 세션, 익명 방문자 및 테넌트 경계를 모델링합니다.

페이지 읽기

알림

탐색 및 쿼리 결과의 단일 계열 시간 차트에서 이해 가능한 임계값 알림을 생성합니다.

페이지 읽기

이벤트 데이터 유형 및 Null 허용 여부

SQL을 손상시키지 않고 스키마가 발전할 수 있도록 안정적인 문자열, 숫자, 부울, 타임스탬프 및 중첩 이벤트 필드를 선택하세요.

페이지 읽기

데이터 보존 및 삭제

구조화된 이벤트 데이터에 대한 테이블 보존, 선택적 삭제, 전체 테이블 제거 및 검증을 계획합니다.

페이지 읽기

정식 와이드 이벤트

SQL, 디버깅, 대시보드 및 에이전트 분석에 필요한 컨텍스트를 사용하여 하나의 완성된 작업 단위를 캡처하는 정식 와이드 이벤트를 설계합니다.

페이지 읽기

SQL 조건부 집계

COUNT, SUM, AVG와 함께 CASE 표현식을 사용하여 구조화된 이벤트 데이터의 비율, 세그먼트, 운영 결과를 계산하세요.

페이지 읽기

이벤트 데이터에 대한 SQL 시간 버킷팅

date_trunc 또는 date_bin를 사용하여 구조화된 이벤트를 전체 UTC 간격으로 그룹화한 다음 부분 버킷 실수 없이 비율과 볼륨을 비교합니다.

페이지 읽기

지연 시간 및 분포에 대한 SQL 백분위수

DataFusion SQL에서 대략적인 p50, p95 및 p99 값을 계산하고 볼륨이나 분포 형태를 숨기지 않고 꼬리 대기 시간을 해석합니다.

페이지 읽기

이벤트 분석을 위한 SQL 창 기능

LAG, ROW_NUMBER 및 프레임 집계를 사용하여 기간을 비교하고, 이벤트를 중복 제거하고, 행 세부 정보를 잃지 않고 롤링 기준선을 계산합니다.

페이지 읽기

구조적 이벤트를 위한 SQL 중복 제거

이벤트 ID를 정의하고 ROW_NUMBER를 사용하여 유효한 재시도나 반복적인 사용자 작업을 실수로 축소하지 않고 중복 전달을 제거합니다.

페이지 읽기

SQL 퍼널 분석

조건부 마일스톤, 명시적 순서, 코호트 창, 검토 가능한 전환 분모를 사용하여 계정 수준 제품 퍼널을 구축하세요.

페이지 읽기

SQL 코호트 유지 분석

코호트 날짜, 활동 창, ID 및 불완전한 기간을 명시적으로 유지하면서 시작 마일스톤 이후 사용자 또는 계정이 복귀하는지 여부를 측정합니다.

페이지 읽기

프로덕션 가이드

완전한 제품, 안정성, AI, 청구, 데이터베이스, 보안 및 보고 워크플로우를 구현합니다.

구조화된 로깅 가이드

SQL을 사용하여 안전하게 수집하고 쿼리하기 쉬우며 대시보드, 디버깅 및 제품 결정에 유용한 구조화된 애플리케이션 이벤트를 설계하세요.

페이지 읽기

애플리케이션 Telemetry: 실용 가이드

구조화된 이벤트, 로그, 지표 및 추적을 안정적인 SQL, 대시보드 및 알림에 연결하는 애플리케이션 텔레메트리을 설계합니다.

페이지 읽기

OpenAI API 모델 및 기능별 비용 추적

모델, 기능, 팀 및 결과별로 OpenAI API 비용을 추적하세요. 프로덕션 준비가 완료된 이벤트 형태와 SQL 쿼리를 복사한 다음 견적을 송장에 맞게 조정하세요.

페이지 읽기

구조화된 이벤트 및 SQL을 사용하여 AI 에이전트 평가

AI 에이전트 평가 이벤트를 설계하고, 품질과 비용 및 안정성을 결합하고, 검토 가능한 SQL 및 명시적 분모를 사용하여 릴리스를 비교합니다.

페이지 읽기

구조화된 이벤트를 통한 AI 에이전트 보안 모니터링

제한된 이벤트와 검토 가능한 SQL을 통해 에이전트 도구 승인, 정책 거부, 사람 승인 및 최종 결과를 모니터링합니다.

페이지 읽기

OpenTelemetry GenAI 추적을 결과 이벤트에 연결

프롬프트, 도구 페이로드 또는 전체 범위를 복사하지 않고도 OpenTelemetry 생성 AI 추적을 컴팩트 Telemetry 결과 이벤트와 상호 연결합니다.

페이지 읽기

수익 A/B 테스트

실험 변형 전반에 걸쳐 노출된 방문자당 수익을 비교하고 트래픽 불균형으로 인한 오해 없이 상승도를 정량화합니다.

페이지 읽기

웹사이트 가동 시간 모니터링

예약된 하트비트 검사를 기록하여 가동 시간을 측정하고, 사고를 조사하고, 반복되는 오류에 대해 알림합니다.

페이지 읽기

대기열 작업자 옵저버빌리티

대기열 깊이와 꼬리 대기 시간을 함께 모니터링하여 백로그, 작업자 멈춤, 사용자에게 표시되는 처리 지연을 감지합니다.

페이지 읽기

분포 시각화

백분위수를 사용하면 단일 평균으로 숨길 수 있는 일반적인 값, 롱테일, 고가치 고객 세그먼트를 확인할 수 있습니다.

페이지 읽기

SQL로 전환율 측정

반복되는 이벤트를 이중으로 계산하지 않고도 이탈 지점을 찾을 수 있도록 퍼널 이정표를 측정하고 사용자 수준 전환율을 계산합니다.

페이지 읽기

웹서버 오류 분석

상태, 경로, 릴리스 및 요청 컨텍스트를 캡처하여 오류 급증으로 인해 일반 개수 대신 특정 회귀가 발생하도록 합니다.

페이지 읽기

프로파일링 코드 실행

단계 기간과 실행 컨텍스트를 기록하여 병목 현상을 찾고, 실행을 비교하고, 성능 작업의 우선 순위를 지정합니다.

페이지 읽기

쿼리 결과 내보내기

동기식 JSON 또는 비동기식 JSON 및 Parquet 내보내기를 선택하고, 안전하게 폴링하고, 다운스트림 보고를 위해 쿼리 컨텍스트를 보존합니다.

페이지 읽기

알림 전달 및 문제 해결

시끄러운 페이지를 만들지 않고도 Telemetry 알림 쿼리, 시간 버킷, 임계값, 수신자, 평가 기록 및 이메일 전달을 확인합니다.

페이지 읽기

이벤트 수집 문제 해결

HTTP 응답, API 키 범위, 페이로드 형태, 테이블 정규화, 타임스탬프, 스키마, 재시도 및 최신성을 확인하여 누락되거나 거부된 Telemetry 이벤트를 진단합니다.

페이지 읽기

SQL 쿼리 문제 해결

API 응답, 테이블 스키마, DataFusion 구문, 필드 유형, 기간, 조인, 속도 및 비동기 내보내기 상태를 확인하여 Telemetry SQL을 체계적으로 디버그합니다.

페이지 읽기

SQL을 통한 사고 대응

반복 가능한 SQL 워크플로를 사용하여 사고 범위를 지정하고, 영향을 받는 경로 및 릴리스를 식별하고, 타임라인을 구축하고, 구조화된 이벤트의 복구를 확인합니다.

페이지 읽기

SQL을 통한 데이터베이스 신뢰성 모니터링

안전한 애플리케이션 수준 데이터베이스 이벤트를 계측하고 SQL을 사용하여 느린 쿼리 지문, 풀 경합, 롤백, 잠금, 복제 지연 및 마이그레이션을 조사합니다.

페이지 읽기

임시 로그에서 구조화된 이벤트 및 SQL로 마이그레이션

프로덕션 워크플로우를 자유 형식 로그 검색에서 제한된 구조적 이벤트, 테스트된 SQL, 대시보드 및 알림로 한 번에 위험한 컷오버 없이 이동합니다.

페이지 읽기

SQL을 사용한 프런트엔드 안정성 모니터링

유형의 브라우저 성능 이벤트를 계측하고 SQL을 사용하여 원시 페이지 콘텐츠를 수집하지 않고 경로 및 릴리스별로 핵심 웹 바이탈을 비교합니다.

페이지 읽기

브라우저 Telemetry 프록시 및 코어 웹 바이탈

Telemetry API 키를 노출하지 않고 속도가 제한된 서버 프록시를 통해 개인 정보 보호를 고려한 브라우저 이벤트 및 핵심 웹 바이탈을 수집합니다.

페이지 읽기

이벤트 추적 계획 및 거버넌스

명시적인 그레인, 소유권, 필드, 개인 정보 보호, 유효성 검사, 보존 및 다운스트림 SQL 종속성을 포함하는 이벤트 추적 계획을 만듭니다.

페이지 읽기

CI에서 Telemetry 계측 테스트

구조화된 이벤트 계약, 개인 정보 보호 경계, 배달 실패 및 SQL을 테스트하면 프로덕션 데이터를 보내거나 라이브 API에 의존하지 않고 CI가 생성됩니다.

페이지 읽기

OpenTelemetry와 함께 Telemetry 사용

안전한 상관 관계 ID 및 명시적인 신호 경계가 있는 OpenTelemetry 추적, 메트릭 및 로그 옆에 Telemetry 결과 이벤트를 사용하세요.

페이지 읽기

Kubernetes SQL을 통한 신뢰성 모니터링

구조화된 Kubernetes 워크로드 이벤트와 SQL을 사용하여 컨테이너 재시작, 준비 상태 손실, 롤아웃 변경 사항 및 애플리케이션 영향을 조사합니다.

페이지 읽기

SQL을 사용한 보안 감사 분석

제한된 권한 있는 작업 이벤트를 설계하고 SQL을 사용하여 비밀을 노출하지 않고 거부, 실패 및 사람 검토 대기열을 검토합니다.

페이지 읽기

SQL을 사용한 제품 여정 분석

주문한 제품 이정표를 모델링하고 SQL을 사용하여 명시적인 계산 규칙을 ​​통해 세션 여정 완료 및 단계별 중단을 측정합니다.

페이지 읽기

Telemetry 비용 및 볼륨 관리

텔레메트리 수집 계약을 변경하기 전에 이벤트 수, 페이로드 바이트, 거부율, 보존 및 카디널리티를 측정하십시오.

페이지 읽기

SQL을 통한 고객 영향 분석

사건을 개인 정보 보호 계정 영향 이벤트에 연결하고 SQL을 사용하여 계획에 따라 영향을 받는 계정, 영향을 받는 공유 및 영향 기간을 계산합니다.

페이지 읽기

SQL을 사용한 RAG 평가

RAG 평가 이벤트를 버전화하고 SQL을 사용하여 검색 관련성, 근거 있는 답변, 대기 시간 및 파이프라인 릴리스 전체의 비용을 비교합니다.

페이지 읽기

SQL을 사용한 기능 출시 분석

안정적인 기능 할당, 릴리스 컨텍스트, 요청 볼륨, 오류 및 대기 시간을 사용하여 SQL와 제어 및 출시 코호트를 비교합니다.

페이지 읽기

옵저버빌리티 및 이벤트 분석을 위한 SQL

구조화된 이벤트가 SQL 지원 옵저버빌리티 데이터가 되는 방법, 어떤 이벤트 계약이 작동하는지, 이를 쿼리하는 방법, SQL이 로그, 메트릭 및 추적을 보완해야 하는 위치를 알아보세요.

페이지 읽기

예약된 SQL 보고서를 Slack으로 보내기

일정에 따라 Telemetry SQL 쿼리를 실행하고, 결과를 간결한 Slack 메시지로 형식화하고, 웹훅 자격 증명을 보호하고, 배달 실패를 관찰 가능하게 만듭니다.

페이지 읽기

LogQL, KQL 및 SPL 쿼리를 SQL로 마이그레이션

언어나 데이터 모델이 동일하다고 가정하지 않고 일반적인 LogQL, Kusto 쿼리 언어 및 Splunk SPL 분석 패턴을 검토 가능한 SQL로 변환합니다.

페이지 읽기

엔드 투 엔드 SaaS 옵저버빌리티 데모

구조화된 이벤트를 내보내는 소규모 Node.js SaaS 워크플로를 실행하고, SQL로 결과 테이블을 쿼리하고, 하나의 이벤트 계약을 안정성, 제품 및 비용 보기로 전환합니다.

페이지 읽기

벤치마크 Telemetry 수집 및 쿼리 성능

재현 가능하고 제한된 Telemetry API 벤치마크를 실행하고, 서비스 동작에서 클라이언트 타이밍을 분리하고, 테스트 조건을 게시하고, 지원되지 않는 성능 주장을 피하세요.

페이지 읽기

SQL을 사용한 SLI, SLO 및 오류 예산 모니터링

SQL을 사용하여 요청 기반 서비스 지표를 정의하고, SLO 규정 준수 및 오류 예산 소모를 계산하고, 검토 가능한 안정성 알림을 구축하세요.

페이지 읽기

SQL에서 시작하지 않고 구조화된 이벤트 탐색

이벤트 샘플을 검사하고, 입력된 필터를 적용하고, 필드를 집계하고, 차트를 작성하고, 검토된 탐색 결과를 대시보드 또는 알림로 승격합니다.

페이지 읽기

AI 지원 SQL: 쿼리 생성, 검토 및 검증

집중적인 이벤트 질문을 편집 가능한 DataFusion SQL로 전환한 다음 스키마 가정, 계산 논리, 개인 정보 보호 경계 및 결과 유효성을 검토합니다.

페이지 읽기

저장된 쿼리, 기록, 즐겨찾기 및 공동 작업

팀 작업공간에서 검토된 SQL을 구성하고, 쿼리 기록을 보존하고, 개인 즐겨찾기를 사용하고, 안정적인 결과를 공유 대시보드 및 알림로 승격합니다.

페이지 읽기

보안 모바일 Telemetry 프록시

앱 바이너리에서 수집 키를 유지하는 인증된 서버 프록시를 통해 React Native, Swift, Kotlin 및 Flutter 이벤트를 라우팅합니다.

페이지 읽기

Telemetry가 SQL 알림을 평가하는 방법

Telemetry가 저장된 SQL을 평가하고, 포인트를 선택하고, 값을 집계하고, 상태 전환을 기록하고, 이메일 전달을 시도하는 방법을 알아보세요.

페이지 읽기