Docs Menu
Docs Home
/ /

AWS S3 버킷 으로 로그 내보내기

Atlas cluster를 구성하여 매분 시스템 로그를 AWS S3 버킷으로 내보낼 수 있습니다.M10+

이 통합을 통해 다음을 수행할 수 있습니다.

  • S3 버킷으로 내보낼 MongoDB 로그 파일을 지정합니다. Atlas 다음 로그 유형 내보내기를 지원합니다.

    • mongod

    • mongos

    • mongod-audit

    • mongos-audit

  • 10 최대 개의 내보내기 경로를 설정하여 여러 AWS S3 버킷으로 로그를 동시에 내보낼 수 있습니다.

  • MRAP ARN과의 통합을 구성하여 S 멀티 리전 액세스 포인트(MRAP)로 로그를 보냅니다. 현재는 Atlas 관리 API 사용해서만 MRAP ARN을 구성할 수 있습니다. MRAP 별칭은 지원되지 않습니다.3

중요

로그에는 민감한 정보(PII 포함)가 포함될 수 있습니다. 사용자는 AWS S3 버킷에 로그를 저장 하고 처리할 책임이 있습니다. 로그를 내보내기 전에 Atlas 특정 정보를 수정하도록 하려면 로그 수정 편집 참조하세요.

로그를 AWS S3 버킷으로 내보내려면 Atlas Project Owner Organization Owner 에 대한 또는 액세스 있어야 합니다.

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

  • 네트워크 문제 또는 재시도로 인해 AWS S3 버킷에 중복 로그 항목이 발생할 수 있습니다.

다음이 필요합니다.

  • 최대 세션 기간이 12 시간으로 설정하다 AWS 리소스 에 대한 Atlas 액세스 부여하는 sts:AssumeRole이 포함된 AWS IAM 역할 .

  • 기존 AWS S3 버킷.

  • MongoDB 7.0 이상을 실행 M10+ Atlas cluster .

로그를 AWS S3 버킷으로 내보내려면 다음 단계를 완료하세요.

1
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 사이드바에서 Project Settings를 클릭합니다.

프로젝트 설정 페이지가 표시됩니다.

2

Integrations 탭을 클릭합니다.

프로젝트 통합 페이지가 표시됩니다.

3
4
  1. Authorize an AWS IAM Role 드롭다운에서 ARN을 선택합니다.ARN을 추가하려면 통합 AWS 액세스 설정을 참조하세요.

  2. Next를 클릭합니다.

5
  1. Bucket Name 필드 에 AWS 계정에 표시되는 S3 버킷의 이름을 입력합니다.

  2. Prefix 필드 에 S 버킷의3 콘텐츠를 구성할 디렉토리 이름을 입력합니다. 예시 들어 를 logs/ 입력하면 logs 내보낸 로그를 저장 버킷에 3 디렉토리 생성됩니다.

  3. Log Type에서 내보낼 로그 유형을 선택합니다.

    • MongoDB Logs ()mongodb.gz 각 서버 프로세스 에서 기록하는 진단 로그입니다. 서버 스타트업 및 종료, 구성, 연결, 느린 쿼리, 복제, 샤딩 활동 및 기타 운영 이벤트를 기록 .mongod

    • MongoDB Audit Logs ()mongodb-audit-log.gz 인증 시도, 권한 부여 검사, 역할 변경 및 기타 보안 관련 작업과 같은 시스템 이벤트 조치를 추적 에서 내보낸 감사 로그입니다. 이러한 로그는 기본 MongoDB 로그 와 별개입니다.mongod

    • MongoDB Router Logs ()mongos.gz 샤딩된 클러스터 의 각 라우터 프로세스 에서 기록하는 진단 로그입니다. 샤드에 대한 쿼리 라우팅, 샤딩 메타데이터 새로 고침, 일반 프로세스 진단과 같은 라우터별 동작을 캡처합니다.mongos

    • MongoDB Router Audit Logs ()mongos-audit-log.gz 라우터 프로세스에서 방출되는 로그를 감사하여 샤딩된 배포서버 에서 라우터의 관점에서 동일한 종류의 감사된 시스템 이벤트를 기록합니다.mongos

    자세한 학습 은 MongoDB 로그 보기 및 다운로드를 참조하세요.

  4. (선택 사항) S3 버킷의 로그를 암호화하려면 필드 에 AWS Key Management Service( KMS ) 키 ARN을 KMS Key 입력합니다.자세한 학습 은 AWS KMS 로 고객 키 관리하기를 참조하세요.

  5. Next를 클릭합니다.

6
  1. 를 클릭하여 Atlas 에서 생성한 액세스 정책을 복사하고 파일 이름으로 로컬에AtlasS3LogExportPolicy 저장합니다:.

  2. Atlas 에서 생성한 CLI 명령을 클릭하여 복사한 다음 터미널에서 명령을 실행 액세스 정책을 AWS IAM 역할 에 연결합니다.

  3. 내보내기를 활성화하기 전에 Validate 를 클릭하여 구성과 자격 증명 올바른지 확인합니다.

7

Atlas 외부 싱크로 로그 내보내기를 중지하는 경우 알림을 받으려면 프로젝트 수준 경고 구성합니다.

1
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 탐색 모음에서 Alerts 아이콘을 클릭합니다.

  4. Project 헤더 아래의 Alerts 을 클릭합니다.

Project Alerts(프로젝트 경고) 페이지가 표시됩니다.

2
3

Condition/Metric 드롭다운 메뉴에서 Log export is unable to export logs on this host 을(를) 선택합니다.

4
  1. Add Notification Method 섹션의 역할 목록에서 선택합니다.

  2. Add Notifier 드롭다운 메뉴에서 다음 표에 설명된 옵션 중에서 선택합니다.

    알림 옵션
    설명

    Atlas Project

    프로젝트에서 특정 역할을 맡은 사용자에게 이메일 또는 문자 메시지로 경고를 전송합니다.

    Atlas Project는 기본 경고 수신자입니다. 경고가 전송되는 역할과 경고가 전달되는 방법을 구성할 수 있습니다. 두 번째 Atlas Project를 수신자로 추가할 수 없습니다.

    Atlas Project는 현재 수신자 목록에 없는 경우에만 Add 목록의 옵션으로 사용할 수 있습니다.

    1. Select Role(s) 확인란에서 경고를 수신해야 하는 프로젝트 역할을 선택하거나 프로젝트의 모든 사용자가 경고를 수신하도록 All Roles를 선택합니다.

    2. Account 페이지에서 각 Atlas 프로젝트 사용자 용으로 구성된 휴대폰 번호로 이러한 경고를 보내려면 SMS 를 선택합니다.

    3. Account 페이지에서 각 Atlas 프로젝트 사용자 용으로 구성된 이메일 주소로 이러한 경고를 보내려면 Email 을 선택합니다. Email 디폴트로 체크됩니다.

    Atlas 조직.

    조직에서 특정 역할을 가진 사용자에게 이메일 또는 문자 메시지로 경고를 보냅니다.

    1. Select Role(s) 확인란에서 경고를 수신해야 하는 조직 역할을 선택하거나 조직의 모든 사용자가 경고를 수신하도록 All Roles를 선택합니다.

    2. Account 페이지에서 각 Atlas 조직 사용자 용으로 구성된 휴대폰 번호로 이러한 경고를 보내려면 SMS 를 선택합니다.

    3. Account 페이지에서 각 Atlas 조직 사용자 용으로 구성된 이메일 주소로 이러한 경고를 보내려면 Email을 선택합니다. 기본적으로 Email이 선택되어 있습니다.

    Atlas user

    지정된 Atlas 사용자에게 이메일 또는 문자 메시지로 경고를 보냅니다.

    1. Account 페이지에서 Atlas 사용자 용으로 구성된 휴대폰 번호로 이러한 경고를 보내려면 SMS 선택합니다.

    2. Account 페이지에서 각 Atlas user용으로 구성된 이메일 주소로 이러한 경고를 보내려면 Email을 선택합니다. Email이 기본값으로 선택되어 있습니다.

    이메일

    이메일 주소로 경고를 전송합니다.

    SMS

    휴대폰 번호로 경고를 보냅니다. Atlas는 모든 구두점과 문자를 제거하고 숫자만 사용합니다. 미국 또는 캐나다 이외의 국가에 거주하는 경우 011국가 코드를 포함하세요. Atlas는 미국 기반의 Twilio를 사용하여 문자 메시지를 보냅니다. 미국 이외의 전화 번호를 사용하는 경우 대신 Google Voice 전화 번호를 사용하세요.

    예를 들어 뉴질랜드 휴대폰 번호로 알림을 보내려면 전화번호 앞에 01164 를 입력합니다.

    Slack

    Slack 채널 로 경고 보냅니다. 채널 이름과 API 토큰 또는 봇 토큰을 입력합니다. API 토큰을 만들려면 https://api.slack.com/web Slack 계정의 페이지입니다. Slack 의 Bot 사용자에 대해 자세히 학습 https://api.slack.com/bot-users를 참조하세요.

    애플리케이션 프로그램 인터페이스(API, Application Programming Interface) 혹은 통합 키가 필요한 알림을 생성한 후 다음과 같은 경우 키가 부분적으로 수정된 것으로 표시됩니다.

    • Atlas UI를 통해 경고를 보거나 편집합니다.

    • Atlas 관리 API를 통해 알림에 대한 경고를 쿼리합니다.

    PagerDuty

    PagerDuty 계정으로 경고 를 보냅니다. PagerDuty 서비스 키만 입력합니다. PagerDuty에서 직접 에스컬레이션 규칙 및 경고 할당을 정의하세요.

    사용자는 PagerDuty 대시보드에서만 PagerDuty 경고를 확인할 수 있습니다.

    모든 새 PagerDuty 키는 이벤트 API v2를 사용합니다.

    이벤트 API v1 키가 있는 경우 Atlas에서 해당 키를 계속 사용할 수 있습니다.

    애플리케이션 프로그램 인터페이스(API, Application Programming Interface) 혹은 통합 키가 필요한 알림을 생성한 후 다음과 같은 경우 키가 부분적으로 수정된 것으로 표시됩니다.

    • Atlas UI를 통해 경고를 보거나 편집합니다.

    • Atlas 관리 API를 통해 알림에 대한 경고를 쿼리합니다.

    Datadog

    Datadog 계정에 Datadog 이벤트로 경고를 보냅니다.

    경고가 처음 열리면 Atlas는 "오류" 이벤트로 경고를 전송합니다. 후속 업데이트는 "정보" 이벤트로 전송됩니다. 경고가 닫히면 Atlas에서 "성공" 이벤트를 전송합니다.

    1. API Key Validate Datadog API Key 아래에 있는 DataDog API 키를 입력하고 클릭합니다.

    2. API 리전을 입력합니다.

      Atlas는 Atlas UI에서 다음과 같은 Datadog 리전을 지원합니다.

      • US1

      • US3

      • US5

      • EU1

      • AP1

      Datadog은 US1 디폴트로 사용합니다.

      Datadog 리전에 대해 자세히 알아보려면 Datadog 사이트를 참조하세요.

      애플리케이션 프로그램 인터페이스(API, Application Programming Interface) 혹은 통합 키가 필요한 알림을 생성한 후 다음과 같은 경우 키가 부분적으로 수정된 것으로 표시됩니다.

      • Atlas UI를 통해 경고를 보거나 편집합니다.

      • Atlas 관리 API를 통해 알림에 대한 경고를 쿼리합니다.

    3. (선택 사항) 데이터베이스 지표 추적을 활성화 하려면 Send Database MetricsOn로 전환합니다.

    4. (선택 사항) 컬렉션 지연 시간 지표 추적을 활성화 하려면 Send Collection Latency MetricsOn로 전환합니다.

    5. (선택 사항) 쿼리 형태 지표 추적을 활성화 하려면 Send Query Shape MetricsOn로 전환합니다.

    6. Save를 클릭합니다.

    VictorOps

    VictorOps 계정으로 경고를 보냅니다.

    VictorOps의 영숫자 API 키를 입력하여 경고에 대한 VictorOps 엔드포인트를 통합합니다. API 키에 대시를 추가하여 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 형식에 매칭합니다. 예를 들어, 489f7he7-790b-9896-a8cf-j4757def1161입니다. 선택적 라우팅 키를 입력하여 특정 VictorOps 그룹에 경고를 라우팅합니다. VictorOps 구성을 테스트하려면 Post Test Alert을(를) 클릭하세요. VictorOps에서 직접 에스컬레이션 및 라우팅 규칙을 정의하세요.

    이 옵션은 승인이 필요한 경고에만 사용할 수 있습니다. Atlas에서 해당 타사 모니터링 서비스로부터 정보성 경고를 받을 수 있습니다. 그러나 이러한 경고는 외부 서비스 내에서 해결해야 합니다. VictorOps 대시보드에서 VictorOps 경고를 승인합니다.

    애플리케이션 프로그램 인터페이스(API, Application Programming Interface) 혹은 통합 키가 필요한 알림을 생성한 후 다음과 같은 경우 키가 부분적으로 수정된 것으로 표시됩니다.

    • Atlas UI를 통해 경고를 보거나 편집합니다.

    • Atlas 관리 API를 통해 알림에 대한 경고를 쿼리합니다.

    Opsgenie

    Opsgenie 계정으로 경고를 보냅니다. Opsgenie API 키만 입력합니다. Opsgenie에서 직접 에스컬레이션 규칙 및 경고 할당을 정의하세요.

    이 옵션은 승인이 필요한 경고에만 사용할 수 있습니다. Atlas에서 해당 타사 모니터링 서비스로부터 정보성 경고를 받을 수 있습니다. 그러나 이러한 경고는 외부 서비스 내에서 해결해야 합니다. Opsgenie 대시보드에서 Opsgenie 경고을 승인합니다.

    애플리케이션 프로그램 인터페이스(API, Application Programming Interface) 혹은 통합 키가 필요한 알림을 생성한 후 다음과 같은 경우 키가 부분적으로 수정된 것으로 표시됩니다.

    • Atlas UI를 통해 경고를 보거나 편집합니다.

    • Atlas 관리 API를 통해 알림에 대한 경고를 쿼리합니다.

    마이크로소프트 팀즈

    Microsoft Teams 채널에 적응형 카드 로 경고를 보냅니다.

    Microsoft Teams 채널에 경고 알림을 전송하려면 Microsoft Teams 수신 웹훅 (webhook)을 생성해야 합니다. 웹훅 (webhook)을 생성한 후 자동으로 생성된 URL을 사용하여 Atlas에서 Microsoft Teams 통합을 구성할 수 있습니다.

    통합을 설정하려면 Integrate with Microsoft Teams 참조합니다.

    Microsoft Teams 알림에 대한 경고를 보거나 편집할 때 URL이 부분적으로 편집된 상태로 표시됩니다.

    웹후크

    프로그래밍 방식 처리를 위해 엔드포인트로 HTTP POST 요청을 전송합니다. 요청 본문에는 Atlas 관리 API 경고 리소스와 동일한 형식을 사용하는 JSON 문서가 포함되어 있습니다.

    이 옵션은 Integrations 페이지에서 Webhook 설정을 구성한 경우에만 사용할 수 있습니다.

    웹후크 알림에 대한 경고를 보거나 편집할 때 URL은 부분적으로 편집된 상태로 표시되고 비밀번호는 완전히 편집된 상태로 표시됩니다.

    1. Webhook URL 필드에 웹후크 기반 알림의 대상 URL을 지정합니다.

    2. (선택 사항) 비밀번호를 사용하여 웹후크 연동을 설정한 경우 Webhook Secret 필드에 웹후크 기반 알림에 대한 인증 비밀번호를 지정합니다.

  3. Recurrence 섹션에서 로그 내보내기 실패 조건이 60 분 이상 지속될 때 경고가 트리거하다 되고 문제가 해결될 때까지 10080 분(7 일)마다 다시 전송되도록 경고 를 설정하다 .

    이렇게 하면 로그 내보내기 실패가 장기간 지속되는 경우 알림을 받으면서 일시적인 문제에 대한 과도한 알림 방지할 수 있습니다.

5

경고 구성에 대한 자세한 내용은 경고 구성을 참조하세요.

돌아가기

로그 검토 및 다운로드

이 페이지의 내용