# 트레이스

Source: https://instatus.com/help/ko/observability/traces

트레이스는 하나의 요청을 그 요청이 거치는 모든 서비스에 걸쳐 따라간 것입니다. 각 단계는 스팬입니다. HTTP 호출, 데이터베이스 쿼리, 다른 서비스 호출 등이죠. 트레이스로 느린 요청이 어디서 시간을 썼는지, 실패한 요청이 어디서 깨졌는지 알 수 있습니다.

상태 페이지에서 **Observability** → **트레이스**를 여세요. 각 행이 하나의 요청입니다.

![시간에 따른 요청 소요 시간과 요청당 한 행이 보이는 트레이스 탐색기](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [찾기](https://instatus.com/help/ko/observability/traces#느리거나-실패한-요청-찾기) | status:error, duration:>1s, service: |
| [열기](https://instatus.com/help/ko/observability/traces#트레이스-열기) | 행을 클릭해 워터폴 보기 |
| [수정](https://instatus.com/help/ko/observability/traces#실패한-요청-고치기) | 코딩 에이전트용 수정 프롬프트 복사 |
| [로그](https://instatus.com/help/ko/observability/traces#트레이스-열기) | 요청의 로그로 이동 |

트레이스는 앱이 보내기 시작하면 도착합니다. [설정 프롬프트를 복사할](https://instatus.com/help/ko/observability/send-logs#방법-1-프롬프트-복사) 때 **트레이스**를 선택하거나 자동 계측을 사용하세요.

## 차트 읽기

각 점은 요청 하나로, 발생 시각과 소요 시간에 따라 놓입니다. 빨간 점은 실패한 요청입니다. 차트 위에는 다음이 있습니다:

- **트레이스 수**: 검색으로 찾은 요청 수.
- **오류**: 실패한 요청 수와 비율.
- **p50**, **p95**, **p99**: 요청의 절반, 95%, 99%가 이 값보다 빨랐습니다.

차트에서 드래그하면 그 시간대를 확대합니다.

## 느리거나 실패한 요청 찾기

[로그](https://instatus.com/help/ko/observability/logs#필터) 페이지처럼 검색창을 사용하세요. 트레이스용 필터는 다음과 같습니다:

| 필터          | 찾는 것                                               |
| --------------- | --------------------------------------------------- |
| `status:error`  | 실패한 요청                                |
| `duration:>1s`  | 1초보다 느린 요청. `>500ms`, `<100ms`도 가능 |
| `service:api`   | 한 서비스가 처리한 요청                     |
| `span.name:`    | `GET /v1/users`처럼 특정 이름의 스팬    |
| 모든 속성   | `http.route:`나 `http.response.status_code:` 등 |

자유 텍스트는 스팬 이름을 검색합니다. **루트 스팬**는 기본으로 켜져 있어 요청마다 한 번씩 표시됩니다. 끄면 모든 스팬을 따로 볼 수 있습니다.

다운로드 버튼으로 목록을 CSV로 내보낼 수 있습니다.

## 트레이스 열기

행을 클릭하세요. 트레이스가 열리고 모든 스팬이 타임라인에, 자신을 호출한 스팬 아래에 들여 쓰여 표시됩니다. 긴 막대가 시간이 걸린 곳입니다.

![세 서비스를 거치는 트레이스로, 워터폴 아래쪽에 Okta로의 느린 호출이 있음](https://instatus.com/help/observability/trace-waterfall.png)

이 예에서 페이지 로드에 842 ms가 걸립니다. 워터폴을 보면 이유가 보입니다. `web`이 `api`를 호출하고, `api`가 `sso`를 호출하고, `sso`가 Okta를 468 ms 기다립니다.

- 스팬을 클릭하면 라우트, 상태 코드, 데이터베이스 쿼리 같은 속성이 보입니다.
- **이 스팬의 로그 N개**는 그 스팬 동안 기록된 로그를 엽니다.
- 상단의 **로그 N개**는 요청의 모든 로그를 모든 서비스에 걸쳐 엽니다.
- **트레이스 ID 복사**는 ID를 복사해 공유하거나 `trace_id:`로 검색할 수 있게 합니다.
- **↑** **↓** 또는 **J** **K**로 이전·다음 트레이스로 이동하고, **Esc**로 닫습니다.

## 실패한 요청 고치기

실패한 스팬은 빨간색입니다. **오류만**를 쓰면 성공한 스팬이 숨겨져 긴 트레이스에서도 실패가 눈에 띕니다.

![실패한 스팬이 빨간색으로 표시되고 수정 프롬프트 복사 버튼이 있는 실패한 요청](https://instatus.com/help/observability/trace-error.png)

**수정용 프롬프트 복사**는 실패한 요청의 설명(스팬, 오류, 속성)을 복사합니다. 앱 프로젝트에서 코딩 에이전트에 붙여 넣으면 원인을 찾는 데 필요한 정보가 모두 담깁니다.

- [메트릭](https://instatus.com/help/ko/observability/metrics): 무엇이 바뀌었는지, 가장 큰 변화부터 확인
- [로그](https://instatus.com/help/ko/observability/logs): 로그를 검색, 필터링하고 실시간으로 확인
