콘텐츠로 건너뛰기
Telemetry
이벤트 추적 템플릿

API 오류 및 대기 시간 모니터

요청 볼륨, 상태 코드, 경로 대기 시간, 실패한 엔드포인트 및 고객에게 영향을 미치는 API 사고를 관찰하세요.

검토자 Telemetry 제품 팀 . 이벤트 이름, 권장 필드, 쿼리로 답할 질문, 제외할 데이터를 확인했습니다. 이 페이지의 검토 담당자

이를 통해 풀리는 질문
  • p95 대기 시간으로 인해 가장 느린 경로는 무엇입니까?
  • 증가된 오류로 인해 영향을 받는 고객은 누구입니까?
  • 트래픽이 감소하거나 급증한 곳은 어디입니까?
템플릿 증거 경로

API error and latency monitor: 구현에서 결정까지

프롬프트를 구현 개요로 간주하세요. 유용한 아티팩트는 코드만 복사되는 것이 아니라 신뢰할 수 있는 답변을 생성하는 검토된 이벤트 계약입니다.

  1. 1

    경계를 설정하세요

    Instrument the point where api_request_started becomes final.

  2. 2

    계약 생성

    Start with api_request_started, api_request_completed, api_request_failed and keep every field typed, bounded, and privacy-reviewed.

  3. 3

    픽스처 실행

    집계 결과에 의존하기 전에 알려진 성공, 실패, 재시도 및 빈 결과 사례를 연습해 보세요.

  4. 4

    질문에 답하세요

    p95 대기 시간으로 인해 가장 느린 경로는 무엇입니까?

템플릿과 사용 사례

이 템플릿으로 이벤트 추가하기

측정 목표가 이미 명확한 경우 이 템플릿을 복사하세요. 일치하는 사용 사례 가이드를 사용하여 이벤트 경계, 성공 정의 및 결과 SQL이 지원해야 하는 결정을 검토하세요.

읽기 API 신뢰성 모니터링

템플릿

이것을 코딩 에이전트에 붙여넣으세요.

바꾸기 YOUR_API_KEY, 로컬에서 흐름을 실행한 다음 생성된 이벤트 및 대시보드를 확인합니다.

api-error-monitor

API 오류 및 대기 시간 모니터

text
API 요청 처리에 Telemetry를 추가하세요.

/skill.md와 다음 Telemetry API 키를 사용하세요: YOUR_API_KEY

중요한 API 요청마다 다음 필드를 기록하세요:
route_template, method, status_code, status, latency_ms, user_id, team_id, request_size_bytes, response_size_bytes, error_type, feature.

요청량, 오류율, p50 지연 시간, p95 지연 시간, 실패가 가장 많은 엔드포인트를 보여 주는 차트를 만드세요. 5xx 급증, 느린 p95 지연 시간, 트래픽 급감에 대한 알림을 추가하세요.

요청 본문, 쿠키, 인증 헤더, 비밀, 원시 사용자 콘텐츠는 기록하지 마세요.

캡처할 이벤트

api_request_startedapi_request_completedapi_request_failedapi_rate_limitedapi_timeout

검증 체크리스트

완전한 계측 단계가 남기는 것

이벤트

합성 이벤트는 안정적인 이름과 필드 유형을 사용하여 의도한 테이블에 도달합니다.

쿼리

첫 번째 SQL 쿼리는 명시적인 시간 범위를 사용하여 그럴듯한 행을 반환합니다.

조회수

대시보드는 실제 필드를 사용하며 변경 사항을 설명하기에 충분한 컨텍스트를 포함합니다.

안전

프롬프트, 본문, 자격 증명, 서명 및 비공개 콘텐츠에 대한 수정 여부를 확인했습니다.

이벤트 스키마 예제

쿼리 또는 스니펫을 프로덕션에 적용하기 전에 행 그레인, 방출 경계, 필수 유형, 개인 정보 보호 클래스, 예제 페이로드 및 유효성 검사 체크리스트를 검토하세요.

관련 제품 기능

이 워크플로를 다음에서 계속하세요. 알림

검토된 신뢰성 쿼리를 소유한 임계값 및 응답 워크플로로 승격합니다.

관련 SQL 레시피

더 많은 SQL 예제

이 워크플로의 구조화된 필드에 대해 쿼리를 실행하고, 예제 결과를 검사하고, 유용한 답변을 대시보드 또는 알림으로 전환하세요.

모든 레시피 찾아보기
API 신뢰성초보자

경로별 API 요청 처리량 계산

분당 가장 많은 요청을 처리하는 API 경로는 무엇입니까?

레시피 열기
API 신뢰성중급

API 429 속도 제한 복구 측정

HTTP 429를 수신하는 요청이 재시도 후에 성공적으로 복구됩니까?

레시피 열기
인프라고급

사고 감지 및 복구 시간 계산

각 서비스가 사고를 감지하고 복구하는 데 얼마나 걸리나요?

레시피 열기
API 신뢰성초보자

경로별 API 오류율 계산

요청이 20건 이상인 API 경로 중 5xx 오류율이 가장 높은 경로는 무엇인가요?

레시피 열기
API 신뢰성중급

p50, p95 및 p99 API 대기 시간 계산

꼬리 지연 시간이 가장 긴 엔드포인트는 무엇입니까?

레시피 열기
API 신뢰성초보자

경로별 API 시간 초과 비율 계산

사용자에게 영향을 미칠 만큼 자주 시간 초과되는 API 경로는 무엇입니까?

레시피 열기
API 신뢰성중급

종속성 비교 p95 대기 시간

꼬리 지연 시간과 실패율이 가장 낮은 다운스트림 종속성은 무엇입니까?

레시피 열기
API 신뢰성중급

SLO에 대한 API 가용성 측정

각 서비스가 일일 가용성 목표를 충족했나요?

레시피 열기
API 신뢰성중급

API 오류 예산 소진율 계산

API는 99.9% 가용성 예산을 얼마나 빨리 소모합니까?

레시피 열기
API 신뢰성초보자

고객 영향에 따른 순위 오류 지문

어떤 오류 그룹이 대부분의 고객 계정에 영향을 미치나요?

레시피 열기
API 신뢰성초보자

기능 출시 오류율 비교

기능 플래그 출시는 제어 코호트보다 안정성이 낮습니까?

레시피 열기
API 신뢰성중급

계획에 따른 사고 고객 영향 측정

각 계획에서 사고로 인해 영향을 받은 계정은 몇 개입니까?

레시피 열기
쿼리 예제 모음API 신뢰성 SQL인프라 SQL

더 많은 템플릿