클러스터 모니터링 및 문제 진단

Teleport 배포를 모니터링하고 문제를 진단하는 방법을 안내합니다.

Teleport는 정상 상태를 확인하고 트래픽을 처리할 준비가 되었는지 검증하기 위한 헬스 체크 메커니즘을 제공합니다. 메트릭, 추적, 프로파일링은 클러스터 성능과 응답성을 추적하는 심층 데이터를 제공합니다. 헬스 모니터링 활성화 # Teleport 인스턴스의 상태를 모니터링하는 방법입니다. Teleport의 진단 HTTP 엔드포인트는 기본적으로 비활성화되어 있습니다. 다음을 통해 활성화할 수 있습니다: Command line 진단 엔드포인트가 수신 대기할 로컬 주소로 `--diag-addr` 플래그를 설정하여 `teleport` 인스턴스를 시작합니다: ```code $ sudo teleport start --diag-addr=127.0.0.1:3000 ``` Config file `teleport` 인스턴스의 구성 파일(기본값 `/etc/teleport.yaml`)을 편집하여 다음을 포함시킵니다: ```yaml teleport: diag_addr: 127.0.0.1:3000 ``` 디버그 로그를 활성화하려면: ```yaml log: severity: DEBUG ``` 진단 엔드포인트에 연결할 수 있는지 확인하세요 이제 Teleport가 진단 엔드포인트를 제공하고 있는지 확인합니다: ```code $ curl http://127.0.0.1:3000/healthz ``` 이제 여러 엔드포인트에서 모니터링 정보를 수집할 수 있습니다. Kubernetes 프로브 등에서 Teleport 프로세스의 상태를 모니터링하는 데 사용할 수 있습니다. /healthz # http://127.0.0.1:3000/healthz 엔드포인트는 프로세스가 실행 중이면 {"status":"ok"} 본문과 HTTP 200 OK 상태 코드로 응답합니다. 이는 Teleport 프로세스가 아직 실행 중인지 확인하는 데 적합한 간단한 체크입니다. /readyz # http://127.0.0.1:3000/readyz 엔드포인트는 /healthz 와 유사하지만, 응답에 프로세스의 상태 정보가 포함됩니다. 응답 본문은 다음 형식의 JSON 객체입니다: { "status": "a status message here"} /readyz 와 하트비트 # Teleport 구성 요소가 하트비트 절차를 실행하지 못하면 저하 상태에 진입합니다. 하트비트가 성공적으로 완료되면 Teleport는 이 상태에서 회복을 시작합니다. 첫 번째 성공적인 하트비트는 Teleport를 회복 상태로 전환합니다. 두 번째 연속 성공적인 하트비트는 Teleport를 OK 상태로 전환합니다. Teleport 하트비트는 정상 상태일 때 약 60초마다 실행되며, 실패한 하트비트는 약 5초마다 재시도됩니다. 이는 하트비트 타이밍에 따라 연결이 복구된 후 /readyz 가 다시 정상 상태를 보고하기까지 60-70초가 걸릴 수 있음을 의미합니다. 상태 코드 # 응답의 상태 코드는 다음 중 하나일 수 있습니다: HTTP 200 OK: Teleport가 정상적으로 작동 중입니다 HTTP 503 Service Unavailable