2.2.6. 오류 처리
HTTP 끝점은 로그 수집기가 전달을 올바르게 처리할 수 있도록 특정 상태 코드를 반환해야 합니다.
| 상태 코드 | 의미 | 수집기 동작 |
|---|---|---|
|
| 성공 | 전송됨으로 표시된 로그 레코드, 재시도 큐에서 제거됨 |
|
| 잘못된 요청 | 로그 레코드 삭제(다시 시도되지 않음) - 잘못된 형식의 페이로드를 나타냅니다. |
|
| 무단/Forbidden | 기하급수적 백오프로 수집기 재시도 - 인증 정보 확인 |
|
| 너무 많은 요청 | 수집기 백오프 및 재시도 - 활성 속도 제한 |
|
| 서버 오류 | 기하급수적 백오프로 수집기 재시도 - 일시적인 실패 |
| 연결이 거부됨 | 네트워크/endpoint를 사용할 수 없음 | 기하급수 백오프를 사용하여 수집기 재시도 |
ClusterLogForwarder 출력 사양에서 재시도 제한 및 시간 초과 값을 구성하여 전달 동작을 제어합니다.
systemd 저널의 다음 인프라 로그입니다.
{
"message": "Started container",
"systemd": {
"t": {
"SYSTEMD_UNIT": "kubelet.service"
}
},
"SYSLOG_IDENTIFIER": "kubelet",
"hostname": "ip-10-0-1-42.ec2.internal",
"@timestamp": "2024-01-15T10:30:00.000Z"
}
로그 수집기는 이를 HTTP POST 요청으로 보냅니다.
POST /logs HTTP/1.1
Host: logs.example.com
Content-Type: application/json
Authorization: Bearer <secret>
User-Agent: Vector/0.28.0
{
"message": "Started container",
"systemd": {
"t": {
"SYSTEMD_UNIT": "kubelet.service"
}
},
"SYSLOG_IDENTIFIER": "kubelet",
"hostname": "ip-10-0-1-42.ec2.internal",
"@timestamp": "2024-01-15T10:30:00.000Z"
}