중요
이 페이지에 설명된 기능은 현재 공개 미리 보기 기간 동안 Atlas Infinite 클러스터에서 지원되지 않습니다. 공개 미리 보기에서 지원되는 기능은 공개 미리 보기 가용성을 참조하세요.
매분 시스템 로그를 외부 서비스로 내보내도록 M10+ Atlas cluster를 구성할 수 있습니다. 로그를 외부 서비스로 내보내면 중앙 집중식 로그 관리, 장기 보존, 기존 모니터링 및 관찰 도구와의 통합이 가능해집니다.
지원되는 로그 유형
Atlas 다음 로그 유형 내보내기를 지원합니다.
mongod로그mongos로그mongod-audit로그mongos-audit로그
내보낼 로그 유형을 지정하고 여러 대상으로 로그를 동시에 전송하도록 최대 10 개의 내보내기 경로를 구성할 수 있습니다.
중요
로그에는 민감한 정보(PII 포함)가 포함될 수 있습니다. 외부 서비스에서 로그를 저장 하고 처리할 책임은 사용자에게 있습니다. To have Atlas 특정 정보를 수정하도록 하려면 MongoDB 지원팀에 문의 .
고려 사항
로그를 내보내려면
M10+클러스터가 있어야 합니다. 무료 또는 공유 계층 클러스터에서는 로그 내보내기를 사용할 수 없습니다. 이 요구 사항은 모든 계층의 클러스터를 지원하는 활동 피드 이벤트 내보내기에는 적용되지 않습니다.로그 내보내기를 구성하려면
Project Owner또는Organization Owner액세스 있어야 합니다.각 Atlas 호스팅하다 일반적으로 하루에 1 GB 의 로그를 생성합니다. 로그를 내보내면 데이터 전송 비용 발생합니다. 정확한 데이터 전송 비용 대상, 리전 및 cloud 제공자 에 따라 다릅니다.
로그 송신은 클러스터의 리전 또는 클라우드 공급자와 관계없이 Amazon Web Services
us-east-1의 Atlas 제어 평면에서 시작됩니다. 클러스터가 AWSus-east-1에 있지 않은 경우, 인터넷 유출 비용 외에도 리전 간 또는 클라우드 간 데이터 전송 비용이 발생합니다. 데이터 전송 비용에 대해 자세히 알아보려면 데이터 전송 비용을 참조하세요.네트워크 문제 또는 재시도로 인해 외부 서비스에서 중복 로그 항목이 발생할 수 있습니다.
장애 처리 및 자동 복구
Atlas는 로그 내보내기 실패를 자동으로 처리하고 수동 개입 없이 복구합니다:
재시도 및 회로 차단기
외부 싱크로의 로그 전송이 실패하면 Atlas는 자동으로 지수적 백오프를 사용하여 기본값 최대 3 회 시도합니다. 재시도 지연은 1 초에서 시작됩니다. 시도 간 최대 10 초까지 두 배로 증가합니다.
5 회 연속 실패 후, 반복되는 요청으로 싱크가 과부하는 것을 방지하기 위해 회로 차단기가 열립니다. 회로 차단기는 테스트 쓰기 (write)를 시도하기 전에 5 분 동안 계속 열립니다. 테스트가 성공하면 일반 작업이 재개됩니다. 실패하면 회로 차단기가 다시 열립니다.
각 싱크 구성에는 고유의 독립적인 회로 차단기가 있으므로 특정 통합에서의 문제가 발생하더라도 다른 통합에 영향을 주지 않습니다.
데드 레터 큐(DLQ)
재시도 횟수가 소진되거나 오류를 재시도할 수 없는 경우(잘못된 자격 증명 등), Atlas가 실패한 로그 이벤트를 7일 동안 보유하는 데드 레터 큐(DLQ)에 대기열에 추가합니다. DLQ는 싱크가 사용 불가능한 동안 데이터 손실을 방지합니다.
경고
7 일보다 오래된 로그는 DLQ에서 영구적으로 삭제됩니다. 싱크를 7 일 이상 사용할 수 없는 경우 해당 로그를 복구할 수 없습니다.
연결이 복원되고 회로 차단기가 닫히면 Atlas가 DLQ에서 대기 중인 로그를 싱크로 자동으로 재생합니다. 별도의 수동 입력이 필요하지 않습니다.
경고
DLQ에 로그가 대기 중인 동안 싱크 구성을 수정하면, 대기 중인 로그는 다시 재생될 때 새 구성을 사용합니다. 예시, S3 버킷의 대상을 한 버킷에서 다른 버킷으로 변경하면 대기 중인 로그는 원래 대상이 아닌 새 버킷으로 전송됩니다.
모니터링 및 경고
Atlas는 ` 기본값 경고 `를 제공하여 다음과 같은 경우 ` Project Owner 사용자에게 이메일 알림을 자동으로 보냅니다.
로그 내보내기에서 다시 시도할 수 없는 오류가 발생합니다(DLQ에 대기 중인 로그).
여러 번 재시도한 후에도 로그 내보내기가 실패합니다(DLQ에 대기 중인 로그).
로그 내보내기 재생이 기록을 전달하지 못했습니다.
이러한 경고는 정보성이며, 따라서 프로젝트 활동 피드 에만 표시됩니다. 그리고 Project Alerts 페이지의 Open Alerts 또는 Closed Alerts 탭에는 표시되지 않습니다. 정보 경고 사이클에 대해 더 자세히 알아보려면, 경고 워크플로를 참조하세요.
가더해, 프로젝트 활동 피드에서 다음 정보성 이벤트를 로그합니다:
로그 내보내기가 복구되었습니다(대기 중인 로그가 다시 시작할 준비되었습니다).
로그 내보내기가 복구되었습니다(대기 중인 로그가 전송되고 있습니다).
대기 중인 모든 로그가 전송되었습니다.
프로젝트의 경고 설정에서 경고 수신자 및 알림 방법을 사용자 지정할 수 있습니다. 자세한 내용은 경고 구성을 참조하세요.
지원되는 내보내기 대상
다음 표에는 Atlas 로그 내보내기를 지원하는 외부 서비스가 요약되어 있습니다.
목적지 | 설명 |
|---|---|
| |
| |
실시간 로그 분석 및 대시보드를 위해 | |
| |
벤더 중립적인 관찰 가능성을 위해 | |
중앙 집중식 로그 검색 및 분석을 위해 |
지원되는 모든 대상에서 프로젝트 수준 활동 피드 이벤트를 내보낼 수 있습니다. 조직 수준 이벤트 내보내기는 OpenTelemetry만 지원합니다.