AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

외부 서비스로 로그 내보내기

중요

이 페이지에 설명된 기능 현재 공개 미리 보기 중에 Atlas Infinite 클러스터에서 지원되지 않습니다. 공개 미리 보기에서 지원되는 기능은 공개 미리 보기 가용성을 참조하세요.

매분 시스템 로그를 외부 서비스로 내보내도록 M10+ Atlas cluster를 구성할 수 있습니다. 로그를 외부 서비스로 내보내면 중앙 집중식 로그 관리, 장기 보존, 기존 모니터링 및 관찰 도구와의 통합이 가능해집니다.

Atlas 다음 로그 유형 내보내기를 지원합니다.

내보낼 로그 유형을 지정하고 여러 대상으로 로그를 동시에 전송하도록 최대 10 개의 내보내기 경로를 구성할 수 있습니다.

중요

로그에는 민감한 정보(PII 포함)가 포함될 수 있습니다. 외부 서비스에서 로그를 저장 하고 처리할 책임은 사용자에게 있습니다. To have Atlas 특정 정보를 수정하도록 하려면 MongoDB 지원팀에 문의 .

  • 로그를 내보내려면 M10+ 클러스터 있어야 합니다. 무료 또는 공유 계층 클러스터에서는 로그 내보내기를 사용할 수 없습니다. 이 요구 사항은 모든 계층의 클러스터를 지원하는 활동 피드 이벤트 내보내기에는 적용 되지 않습니다.

  • 로그 내보내기를 구성하려면 Project Owner 또는 Organization Owner 액세스 있어야 합니다.

  • 각 Atlas 호스팅하다 일반적으로 하루에 1 GB 의 로그를 생성합니다. 로그를 내보내면 데이터 전송 비용 발생합니다. 정확한 데이터 전송 비용 대상, 리전 및 cloud 제공자 에 따라 다릅니다.

  • 로그 이그레스는 클러스터의 리전 이나 cloud 제공자 에 관계없이 AWS us-east-1의 Atlas 컨트롤 플레인에서 시작됩니다. 클러스터 가 AWS us-east-1에 속하지 않는 경우, 인터넷 이그레스 비용 외에 리전 간 또는 클라우드 간 데이터 전송 요금이 발생합니다. 데이터 전송 비용에 대해 자세히 학습 데이터 전송 비용을 참조하세요.

  • 네트워크 문제 또는 재시도로 인해 외부 서비스에서 중복 로그 항목이 발생할 수 있습니다.

Atlas 수동 개입 없이 로그 내보내기 실패를 자동으로 처리하고 복구합니다.

외부 싱크로의 로그 전송에 실패하면 Atlas 기본값 으로 최대 3 회까지 지수 백오프를 사용하여 자동으로 재시도합니다. 재시도 지연은 1 초에서 시작하여 시도 사이에 최대 10 초까지 두 배로 늘어납니다.

5 회 연속 실패 후, 반복되는 요청으로 싱크가 과부하는 것을 방지하기 위해 회로 차단기가 열립니다. 회로 차단기는 테스트 쓰기 (write)를 시도하기 전에 5 분 동안 계속 열립니다. 테스트가 성공하면 일반 작업이 재개됩니다. 실패하면 회로 차단기가 다시 열립니다.

각 싱크 구성에는 자체 독립적인 회로 차단기가 있으므로 한 통합의 문제가 다른 통합에 영향을 주지 않습니다.

재시도 횟수가 소진되거나 오류가 재시도할 수 없는 경우(예: 잘못된 자격 자격 증명), Atlas 실패한 로그 이벤트를 DLQ(데드 레터 대기열)에 7일의 보존 기간으로 대기열에 추가합니다. DLQ는 싱크를 사용할 수 없는 동안 데이터 손실을 방지합니다.

경고

7 일이 지난 로그는 DLQ에서 영구적으로 삭제됩니다. 싱크에 7 일 이상 액세스할 수 없는 경우 해당 로그를 복구할 수 없습니다.

연결이 복원되고 회로 차단기가 닫히면 Atlas가 DLQ에서 대기 중인 로그를 싱크로 자동으로 재생합니다. 별도의 수동 입력이 필요하지 않습니다.

경고

로그가 DLQ에 대기 중인 상태에서 싱크 구성을 수정하면 대기 중인 로그가 재생될 때 새 구성을 사용합니다. 예시 를 들어 S3 버킷 간에 대상을 변경하면 대기 중인 로그가 원래 대상이 아닌 새 버킷으로 전송됩니다.

Atlas 다음과 같은 경우 사용자에게 Project Owner 이메일 알림 자동으로 전송하는 기본값 경고를 제공합니다.

  • 로그 내보내기에서 재시도할 수 없는 오류가 발생했습니다(로그가 DLQ에 대기 중).

  • 여러 번 재시도한 후 로그 내보내기가 실패합니다(로그가 DLQ에 대기).

  • 로그 내보내기 재생이 레코드를 전송하지 못합니다.

이러한 경고는 정보 제공용으로, 프로젝트 활동 피드에만 표시되고 Project Alerts 페이지의 Open Alerts 또는 Closed Alerts 탭에는 표시되지 않습니다. 정보 경고 수명 주기에 대해 자세히 학습 경고 워크플로를 참조하세요.

또한 프로젝트 활동 피드는 다음과 같은 정보 이벤트를 기록합니다.

  • 로그 내보내기가 복구되었습니다(대기 중인 로그가 다시 시작할 준비되었습니다).

  • 로그 내보내기가 복구되었습니다(대기 중인 로그가 전송되고 있습니다).

  • 대기 중인 모든 로그가 전달되었습니다.

프로젝트의 경고 설정에서 경고 수신자 및 알림 방법을 사용자 지정할 수 있습니다. 자세한 내용은 경고 구성을 참조하세요.

다음 표에는 Atlas 로그 내보내기를 지원하는 외부 서비스가 요약되어 있습니다.

목적지
설명

mongod, mongos 및 감사 로그를 AWS S3 버킷으로 내보냅니다. 멀티 리전 액세스 포인트(MRAP)를 지원합니다.

mongod, mongos 및 감사 로그를 Azure Blob Storage 컨테이너 로 내보냅니다.

실시간 로그 분석 및 대시보드를 위해 mongod, mongos 및 감사 로그를 Datadog으로 내보냅니다.

mongod, mongos 및 감사 로그를 Google Cloud Storage 버킷으로 내보냅니다.

벤더 중립적인 관찰 가능성을 위해 mongod, mongos 및 감사 로그를 OpenTelemetry(OTel) 엔드포인트로 내보냅니다.

중앙 집중식 로그 검색 및 분석을 위해 mongod, mongos 및 감사 로그를 Splunk Cloud 또는 Splunk Enterprise로 내보냅니다.

지원되는 모든 대상은 프로젝트 수준 활동 피드 이벤트를 내보낼 수 있습니다. 조직 수준 이벤트 내보내기는 OpenTelemetry만 지원합니다.