API 성능 병목 조사

Zero가 Axiom에서 TP95 데이터를 가져와 가장 느린 엔드포인트를 드러내고, 패턴을 식별하며, Slack 메시지 하나로 발견 사항이 담긴 GitHub 이슈를 생성합니다.

Zero가 연결합니다:

Zero가 제공하는 것

API 성능 병목 조사 — sample output from Zero — screenshot 1

무엇이 문제인가

TP95 급등이 항상 당신을 호출하지는 않습니다. 그것은 메트릭 대시보드에 가만히 자리 잡은 채, 팀이 출시에 집중하는 동안 조용히 사용자 경험을 저하시킵니다. Zero는 어떤 엔드포인트의 성능이든 필요할 때 쉽게 확인하게 해줍니다 - 최근 7일의 TP95 데이터를 가져오고, 어떤 요청이 느린지 확인하며, 아무것도 누락되지 않도록 GitHub 이슈를 자동으로 접수합니다.

Zero가 해결하는 방법

1단계: 도구 연결하기

Axiom

필수

Axiom이 필요합니다. Zero는 엔드포인트 경로와 기간으로 필터링된 요청 이벤트를 위해 당신의 Axiom 데이터셋을 조회합니다.

연결

GitHub

선택

GitHub는 선택 사항입니다. Zero는 요청 시 발견 사항으로 이슈를 생성하며, 본문에 메트릭 표를 삽입합니다.

연결

2단계: Zero에게 요청하기

@Zero check Axiom for the POST /api/zero/runs endpoint - show me the TP95 for the last 7 days and flag any events over 5s. POST /api/zero/runs 엔드포인트에 대해 Axiom을 확인해 줘 - 최근 7일의 TP95를 보여주고 5s를 넘는 이벤트를 모두 표시해 줘.

사용해 보기

Zero가 해당 엔드포인트에 대해 Axiom 조회

Zero는 지정된 엔드포인트의 모든 요청 이벤트를 해당 기간에 걸쳐 가져와, 하루 단위로 TP50, TP95, TP99를 계산합니다.

Zero가 느린 이벤트를 드러냄

Zero는 임계값(기본값: 5초)을 넘는 이벤트를 필터링하고, 시간대와 에러 패턴별로 그룹화하며, 유력한 근본 원인을 식별합니다.

발견 사항이 담긴 GitHub 이슈 생성

Zero는 메트릭 표, 느린 이벤트 목록, 근본 원인 분석이 담긴 구조화된 GitHub 이슈를 접수합니다 - 엔지니어링 팀이 바로 조치할 수 있도록 준비된 상태로요.

3단계: 한 걸음 더 나아가기

배정 및 우선순위 지정

이슈를 적절한 엔지니어에게 라우팅

@Zero assign the Axiom issue to Ethan and add the label performance, priority-high. Axiom 이슈를 Ethan에게 배정하고 performance, priority-high 라벨을 추가해 줘.

사용해 보기

정기 모니터링 예약

핵심 엔드포인트에 대한 주간 TP95 체크 설정

@Zero every Monday at 9am, pull the last 7 days of TP95 for /api/zero/runs and post to #dev. File a GitHub issue only if TP95 exceeds 3s. 매주 월요일 오전 9시에 /api/zero/runs의 최근 7일 TP95를 가져와서 #dev에 게시해 줘. TP95가 3s를 초과할 때만 GitHub 이슈를 접수해 줘.

사용해 보기

특정 느린 이벤트 조사

단일 이상치 이벤트 파고들기

@Zero pull the full trace for the 6,857ms event on Apr 12 from Axiom and tell me where the time is spent. Axiom에서 4월 12일 6,857ms 이벤트의 전체 트레이스를 가져와서 시간이 어디에 쓰이는지 알려줘.

사용해 보기

더 나은 결과를 위한 팁

●프롬프트에 임계값을 명시하세요 - 'flag events over 3 seconds' - 그러면 Zero의 발견 사항이 일반적인 컷오프가 아니라 당신의 SLO에 맞춰집니다.

●배포 직후에 엔드포인트를 확인하도록 Zero에게 요청해, 대규모로 사용자에게 영향을 주기 전에 회귀를 잡아내세요.

●Daily Error Triage와 결합해 완전한 아침 건강 체크를 하세요: Sentry의 에러와 Axiom의 성능을 하나의 브리프로.