상태 모니터링

번역일: 2026-04-04

요약

Teleport는 정상 상태를 확인하고 트래픽 처리 준비 여부를 검증하기 위한 상태 확인 메커니즘을 제공합니다. Teleport's diagnostic HTTP endpoints are disabled by default.

Teleport는 정상 상태를 확인하고 트래픽 처리 준비 여부를 검증하기 위한 상태 확인 메커니즘을 제공합니다. 이는 Kubernetes 프로브와 같은 도구로 Teleport 프로세스의 상태를 모니터링하는 데 사용할 수 있습니다.

상태 모니터링 활성화#

Teleport's diagnostic HTTP endpoints are disabled by default. You can enable them via:

Ensure you can connect to the diagnostic endpoint

Verify that Teleport is now serving the diagnostics endpoint:

```code
$ curl http://127.0.0.1:3000/healthz
```

이제 여러 엔드포인트에서 모니터링 정보를 수집할 수 있습니다.

http://127.0.0.1:3000/healthz 엔드포인트는 프로세스가 실행 중인 경우 {"status":"ok"} 본문과 HTTP 200 OK 상태 코드로 응답합니다.

이는 Teleport 프로세스가 아직 실행 중인지 확인하기에 적합한 간단한 검사입니다.

http://127.0.0.1:3000/readyz 엔드포인트는 /healthz와 유사하지만, 응답에 프로세스 상태에 대한 정보가 포함됩니다.

응답 본문은 다음 형식의 JSON 객체입니다:

{ "status": "a status message here"}

Teleport 컴포넌트가 하트비트 절차를 실행하지 못하면 성능 저하 상태에 진입합니다. Teleport는 하트비트가 성공적으로 완료되면 이 상태에서 회복을 시작합니다.

첫 번째 성공적인 하트비트는 Teleport를 회복 중 상태로 전환합니다.

두 번째 연속 성공적인 하트비트는 Teleport를 정상 상태로 전환합니다.

Teleport 하트비트는 정상 상태에서 약 60초마다 실행되며, 실패한 하트비트는 약 5초마다 재시도됩니다. 즉, 하트비트 타이밍에 따라 연결이 복원된 후 /readyz가 다시 정상을 보고하기까지 60-70초가 걸릴 수 있습니다.

응답의 상태 코드는 다음 중 하나입니다:

HTTP 200 OK: Teleport가 정상적으로 작동 중
HTTP 503 Service Unavailable: Teleport가 연결 오류를 만나 성능 저하 상태로 실행 중. Teleport 하트비트가 실패하면 발생합니다.
HTTP 400 Bad Request: Teleport가 초기 시작 단계에 있거나 성능 저하 상태에서 회복을 시작했습니다.

동일한 상태 정보는 /metrics 엔드포인트의 process_state 메트릭을 통해서도 확인할 수 있습니다.