매분 시스템 로그를 OpenTelemetry(OTel)로 내보내도록 M10+ Atlas cluster를 구성할 수 있습니다.
이 통합을 통해 다음을 수행할 수 있습니다.
OTel 엔드포인트로 내보낼 MongoDB 로그 파일을 지정합니다. Atlas 다음 로그 유형 내보내기를 지원합니다.
mongodmongosmongod-auditmongos-audit
최대 10 개의 내보내기 경로를 설정하여 여러 OTel 엔드포인트로 로그를 동시에 내보낼 수 있습니다.
중요
로그에는 민감한 정보(PII 포함)가 포함될 수 있습니다. 사용자는 OTel 엔드포인트에 로그를 저장 하고 처리할 책임이 있습니다. To have Atlas 특정 정보를 수정하도록 하려면 MongoDB 지원팀에 문의 .
필요한 액세스 권한
로그를 OTel 엔드포인트로 내보내려면 Atlas 에 대한 Project Owner 또는 Organization Owner 액세스 있어야 합니다.
고려 사항
각 Atlas 호스팅하다 일반적으로 하루에 1 GB 의 로그를 생성합니다. 로그를 내보내면 데이터 전송 비용 발생합니다. 정확한 데이터 전송 비용 대상, 리전 및 cloud 제공자 에 따라 다릅니다.
네트워크 문제 또는 재시도로 인해 OTel 엔드포인트에 중복 로그 항목이 발생할 수 있습니다.
Atlas OTLP 엔드포인트에 연결할 때 TLS를 시행하며 공용 CA(인증 기관)에서 서명한 인증서를 요구합니다. 자체 서명된 인증서는 지원되지 않습니다.
전제 조건
다음이 필요합니다.
기존 O텔 엔드포인트.
엔드포인트 URL 및 포트입니다.
인증 구성.
MongoDB 7.0 이상을 실행하는
M10+Atlas 클러스터.
절차
로그를 OTel 엔드포인트로 내보내려면 다음 단계를 완료하세요.
Atlas 에서 Project Settings 페이지로 이동합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
사이드바에서 아이콘을 Project Overview 옆에 있는 클릭합니다.
프로젝트 설정 페이지가 표시됩니다.
Atlas OTel 엔드포인트에 연결합니다.
OTLP Endpoint 필드 에 OTel 제공자 계정에 표시되는 OTel 엔드포인트의 URL 을 입력합니다.
OTLP Header 필드에 OTel 엔드포인트가 인증 에 필요한 헤더와 값을 입력합니다.
Log Type에서 내보낼 로그 유형을 선택합니다.
MongoDB Logs 각 서버 프로세스 에서 기록하는 진단
mongod로그입니다. 서버 스타트업 및 종료, 구성, 연결, 느린 쿼리, 복제, 샤딩 활동 및 기타 운영 이벤트를 기록 .MongoDB Audit Logs 인증 시도, 권한 부여 확인, 역할 변경 및 기타 보안 관련 작업과 같은 시스템 이벤트 조치를 추적 에서 내보낸 감사 로그입니다. 이러한 로그는 기본 MongoDB 로그 와 별개입니다.
mongodMongoDB Router Logs 샤딩된 클러스터 의 각 라우터 프로세스 에서 기록하는 진단 로그입니다. 샤드에 대한 쿼리 라우팅, 샤딩 메타데이터 새로 고침, 일반 프로세스 진단과 같은 라우터별 동작을 캡처합니다.
mongosMongoDB Router Audit Logs 라우터 프로세스에서 방출하는 로그를
mongos감사하여 샤딩된 배포서버 에서 라우터의 관점에서 동일한 종류의 감사된 시스템 이벤트를 기록합니다.Events 통합 수명 주기 이벤트 및 로그 내보내기 상태 변경과 같은 Project Activity Feed의 이벤트입니다. 자세히 학습 외부 도구로 활동 피드 이벤트 내보내기를 참조하세요.
MongoDB 로그에 대해 자세히 학습 MongoDB 로그 보기 및 다운로드를 참조하세요.
내보내기를 활성화하기 전에 Validate 를 클릭하여 구성과 자격 증명 올바른지 확인합니다.
Save를 클릭합니다.
조직 활동 피드 이벤트 내보내기
조직 수준 OpenTelemetry 통합은 데이터베이스 로그가 아닌 활동 피드 이벤트를 내보냅니다. 조직 이벤트 내보내기는 OTel 호환 대상만 지원합니다.
필요한 액세스 권한
조직 이벤트를 내보내려면 Atlas 에 대한 Organization Owner 액세스 있어야 합니다.
절차
조직 이벤트를 OTel 엔드포인트로 내보내려면 다음 단계를 완료하세요.
Atlas 에서 Organization Settings 페이지로 이동합니다.
아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.
사이드바에서 Organization Settings를 클릭합니다.
조직 설정 페이지가 표시됩니다.
로그 내보내기 실패에 대한 경고
Atlas 모든 프로젝트에 대해 활성화된 기본값 경고를 통해 로그 내보내기가 실패하거나 복구할 때 자동으로 알림을 보냅니다.
기본 경고
다음 경고는 외부 로그 싱크가 있는 모든 프로젝트에 대해 기본값 으로 활성화됩니다.
이러한 경고는 정보 제공용으로, 경고 조건이 충족되면 Atlas 즉시 Project Owner 역할 있는 모든 사용자에게 이메일 알림 보내고 Project Activity Feed에 경고 기록합니다. 이러한 경고는 Project Alerts 페이지의 Open Alerts 또는 Closed Alerts 탭에는 표시되지 않습니다. Project Alerts 설정에서 알림 수신자와 방법을 사용자 지정할 수 있습니다. 정보 경고 수명 주기에 대해 자세히 학습 경고 워크플로를 참조하세요.
활동 피드 이벤트
경고 외에도 Atlas 다음 정보 이벤트를 Project Activity Feed에 기록합니다.
Log export has recovered. Queued logs are ready to resume sending.
Log export has recovered. Queued logs are now being sent.
All queued logs have been delivered to sink.
이러한 이벤트를 보려면 활동 피드 보기를 참조하세요.
경고 알림 구성에 대한 자세한 내용은 경고 구성을 참조하세요.