/ /

활동 피드 이벤트를 외부 도구로 내보내기

Atlas 활동 피드에서 Datadog, Splunk, 고객 관리형 cloud 저장 및 모든 OpenTelemetry(OTel) 호환 대상을 포함한 외부 도구로 이벤트를 스트림 할 수 있습니다. 이벤트를 내보내면 중앙 감사 로깅, 장기 보존, 기존 모니터링 및 관찰 가능성 도구와의 통합이 가능해집니다.

다음 수준에서 이벤트 내보내기를 구성할 수 있습니다.

프로젝트: Project Activity Feed에서 이벤트를 내보냅니다.
조직: Organization Activity Feed에서 이벤트를 내보냅니다.

시스템 로그 내보내기와 달리 이벤트 내보내기에는 M10+ 클러스터 필요하지 않습니다. 이벤트 내보내기는 무료 및 공유 계층 클러스터를 포함한 모든 계층의 클러스터를 지원합니다.

지원되는 대상

사용 가능한 대상은 프로젝트 또는 조직 대해 통합을 구성하는지 여부에 따라 달라집니다. 프로젝트 이벤트 내보내기는 모든 로그 내보내기 대상을 지원합니다. 초기 출시하다 에서 조직 이벤트 내보내기는 OTel 호환 대상만 지원합니다.

목적지	프로젝트 이벤트	조직 이벤트
Amazon Web Services S3	예	No
Azure Blob 저장	예	No
Datadog	예	No
Google Cloud Platform Google Cloud Platform 스토리지	예	No
OpenTelemetry	예	예
Splunk	예	No

필요한 액세스 권한

프로젝트 에 대한 이벤트 내보내기를 구성하려면 프로젝트 에 대한 Project Owner 액세스 있어야 합니다.
조직 에 대한 이벤트 내보내기를 구성하려면 조직 에 대한 Organization Owner 액세스 있어야 합니다.

프로젝트 이벤트 내보내기 구성

프로젝트 수준 이벤트를 내보내려면 대상에 대한 구성 절차를 따르고 메시지가 표시되면 Log Type 아래에서 Events을 선택합니다.

동일한 통합에서 Events를 시스템 로그 유형과 결합하거나 로그 및 이벤트에 대한 별도의 통합을 생성할 수 있습니다.

조직 이벤트 내보내기 구성

조직 수준 통합은 이벤트만 내보내고 OTel과 호환되는 대상만 지원 . 조직 수준 통합을 구성하려면 조직 활동 피드 이벤트 내보내기를 참조하세요.

API 로 이벤트 내보내기 구성

이벤트 내보내기를 프로그래밍 방식으로 구성하려면 Atlas 관리 API 의 로그 통합 엔드포인트를 사용하세요. 이벤트를 내보내려면 logTypes를 EVENTS을 포함하도록 설정하다 .

메서드	엔드포인트	설명
`POST`	`/api/atlas/v2/groups/{groupId}/logIntegrations`	프로젝트 수준 로그 통합 한 개를 생성합니다.
`GET`	`/api/atlas/v2/groups/{groupId}/logIntegrations`	모든 프로젝트 수준 로그 통합을 반환합니다.
`GET`	`/api/atlas/v2/groups/{groupId}/logIntegrations/{id}`	프로젝트 수준 로그 통합 한 개를 반환합니다.
`PUT`	`/api/atlas/v2/groups/{groupId}/logIntegrations/{id}`	프로젝트 수준 로그 통합 한 개를 업데이트합니다.
`DELETE`	`/api/atlas/v2/groups/{groupId}/logIntegrations/{id}`	프로젝트 수준 로그 통합 한 개를 제거합니다.
`POST`	`/api/atlas/v2/orgs/{orgId}/logIntegrations`	하나의 조직 수준 로그 통합을 생성합니다.
`GET`	`/api/atlas/v2/orgs/{orgId}/logIntegrations`	모든 조직 수준 로그 통합을 반환합니다.
`GET`	`/api/atlas/v2/orgs/{orgId}/logIntegrations/{id}`	조직 수준 로그 통합 한 개를 반환합니다.
`PUT`	`/api/atlas/v2/orgs/{orgId}/logIntegrations/{id}`	조직 수준 로그 통합 한 개를 업데이트합니다.
`DELETE`	`/api/atlas/v2/orgs/{orgId}/logIntegrations/{id}`	조직 수준 로그 통합 한 개를 제거합니다.

참고

조직 수준 엔드포인트는 Atlas 관리 API 의 미리 보기 버전에서 사용할 수 있습니다. 이를 사용하려면 Accept 헤더를 application/vnd.atlas.preview+json로 설정하다 .

조직 수준 통합은 OTEL_LOG_EXPORT 통합 유형과 EVENTS 로그 유형만 지원 .

응답은 헤더 값을 수정합니다. 통합을 업데이트 때 수정된 값을 변경하지 않고 다시 보내면 저장된 값이 그대로 유지됩니다. 헤더 값을 변경할 때만 전체 헤더 값을 제공합니다.

예제: 프로젝트 이벤트 내보내기 통합 생성

다음 예시 활동 피드 이벤트를 내보내는 프로젝트 수준 OpenTelemetry 통합을 만듭니다.

curl --header "Authorization: Bearer {ACCESS-TOKEN}" \
     --header "Content-Type: application/json" \
     --header "Accept: application/vnd.atlas.2025-03-12+json" \
     --include \
     --request POST "https://cloud.mongodb.com/api/atlas/v2/groups/{PROJECT-ID}/logIntegrations?pretty=true" \
     --data '{
       "type": "OTEL_LOG_EXPORT",
       "logTypes": ["EVENTS"],
       "otelEndpoint": "https://otel-collector.example.com:4318/v1/logs",
       "otelSuppliedHeaders": [
         {
           "name": "Authorization",
           "value": "Bearer token123"
         }
       ]
     }'

예제: 조직 이벤트 내보내기 통합 생성

다음 예시 활동 피드 이벤트를 내보내는 조직 수준 OpenTelemetry 통합을 만듭니다.

curl --header "Authorization: Bearer {ACCESS-TOKEN}" \
     --header "Content-Type: application/json" \
     --header "Accept: application/vnd.atlas.preview+json" \
     --include \
     --request POST "https://cloud.mongodb.com/api/atlas/v2/orgs/{ORG-ID}/logIntegrations?pretty=true" \
     --data '{
       "type": "OTEL_LOG_EXPORT",
       "logTypes": ["EVENTS"],
       "otelEndpoint": "https://otel-collector.example.com:4318/v1/logs",
       "otelSuppliedHeaders": [
         {
           "name": "Authorization",
           "value": "Bearer token123"
         }
       ]
     }'

엔드포인트는 생성된 통합을 반환합니다.

{
  "id": "66d9f3e1a2b3c4d5e6f70819",
  "type": "OTEL_LOG_EXPORT",
  "logTypes": ["EVENTS"],
  "otelEndpoint": "https://otel-collector.example.com:4318/v1/logs",
  "otelSuppliedHeaders": [
    {
      "name": "Authorization",
      "value": "<redacted>"
    }
  ]
}

이벤트 형식

Atlas OTLP/ HTTP 통해 이벤트를 JSON 페이로드로 대상에 전달합니다. 내보낸 각 이벤트 는 OTLP 로그 기록 입니다. 레코드의 리소스 활동 피드 이벤트 스트림 식별하는 mongodb-atlas-events 로 설정하다 service.name 속성이 포함되어 있으므로 OTel 수집기가 다른 원격 분석과 이러한 이벤트를 별도로 라우팅할 수 있습니다. Atlas 내보낸 이벤트에서 null 값이 있는 속성을 생략합니다.

내보낸 각 이벤트 다음 필드가 포함됩니다.

필드	설명
`timeUnixNano`	유닉스 시간 이후 이벤트 발생한 시간(나노초)입니다.
`severityText`	이벤트 의 심각도(예: `INFO`)입니다. 활동 피드에 표시된 이벤트 심각도에 해당합니다.
`severityNumber`	이벤트 의 심각도를 OTLP 심각도 번호 열거형(예: `SEVERITY_NUMBER_INFO`)으로 나타냅니다.
`body.stringValue`	JSON-encoded event object. Contains the event ID (`_id`), event type (`eventType`), creation time in milliseconds since the Unix epoch (`createdDate`), project ID (`projectId`, when applicable), and event-specific details (`eventPayload`). The `source` object identifies what initiated the event, such as a `sourceType` of `USER` and a `sourceInfo` object with the `username`.
`mongodb.event.id` 속성	이벤트 의 고유 식별자입니다. 이 필드 사용하여 이벤트를 중복 제거합니다.
`mongodb.event.type` 속성	활동 피드 이벤트 유형입니다. 이벤트 유형 목록은 Atlas 경고 이벤트 유형을 참조하세요.
`mongodb.event.payload.encoding` 속성	`body.stringValue` 단위 이벤트 페이로드의 인코딩입니다(예: `json`).
`mongodb.org.id` 속성	이벤트 발생한 조직 의 ID . 조직 수준 내보내기에 항상 표시됩니다. 일부 프로젝트 수준 이벤트에서 발표합니다.
`mongodb.project.id` 속성	이벤트 발생한 프로젝트 의 ID . 프로젝트 수준 내보내기에 항상 표시됩니다. 일부 조직 수준 이벤트에서 발표합니다.

다음 예시 내보낸 프로젝트 이벤트 보여줍니다.

{
  "timeUnixNano": "1788896817574000000",
  "severityNumber": "SEVERITY_NUMBER_INFO",
  "severityText": "INFO",
  "body": {
    "stringValue": "{\"_id\":\"6aa06631ba29fc2b0f206c32\",\"eventType\":\"/events/mms/alerts/alert_config_added_audit\",\"projectId\":\"62abb98d95a82610b74debc5\",\"createdDate\":1788896817574,\"resources\":[],\"eventPayload\":\"{\\\"targetAlertConfigId\\\": \\\"6aa06631ba29fc2b0f206c30\\\", \\\"targetAlertConfigEventType\\\": \\\"HOST_DOWN\\\", \\\"targetAlertConfigType\\\": \\\"HOST\\\"}\",\"source\":{\"sourceType\":\"USER\",\"sourceInfo\":{\"username\":\"Atlas Admin\"}}}"
  },
  "attributes": [
    {
      "key": "mongodb.event.id",
      "value": { "stringValue": "6aa06631ba29fc2b0f206c32" }
    },
    {
      "key": "mongodb.event.type",
      "value": { "stringValue": "/events/mms/alerts/alert_config_added_audit" }
    },
    {
      "key": "mongodb.project.id",
      "value": { "stringValue": "62abb98d95a82610b74debc5" }
    },
    {
      "key": "mongodb.event.payload.encoding",
      "value": { "stringValue": "json" }
    }
  ]
}

전달 동작

실시간에 가깝습니다. 정상적인 조건에서 Atlas 거의 실시간으로 이벤트를 전달합니다. 배치는 약 분당 한 번씩 플러시됩니다.
최소 한 번 배달. Atlas 동일한 이벤트 두 번 이상 제공할 수 있습니다. 고유한 mongodb.event.id 필드 사용하여 이벤트를 중복 제거합니다.
중단 중 버퍼링. 대상을 사용할 수 없는 경우 Atlas 이벤트를 버퍼링하고 전송을 다시 시도합니다. Atlas 전달되지 않은 이벤트를 최대 7일 동안 보관합니다. 7일이 지난 후에도 전달되지 않은 상태로 남아 있는 이벤트는 영구적으로 삭제됩니다.
자동 재생, 채우기 또는 실패 경고가 없습니다. 초기 출시하다 지속적인 실패 후 이벤트를 자동으로 재생하지 않으며 통합을 구성하기 전에 발생한 기록 이벤트를 다시 채우지 않습니다. 지속적인 실패 후 이벤트 재전송을 요청 하려면 MongoDB 지원팀 문의.

대상 제한

목적지	제한
Datadog	Datadog은 요청 당 최대 5MB 및 1,000개의 이벤트를 허용합니다.
Splunk	Splunk는 HTTP 이벤트 수집기(HEC)를 통해 이벤트를 일괄적으로 수집합니다. 배치 의 이벤트 중 하나에 잘못된 형식의 이벤트가 발생하면 Splunk는 전체 배치 거부합니다.
OpenTelemetry	배송은 OTel 수집기의 가용성과 구성에 따라 달라집니다. 엔드포인트는 공용 CA(인증 기관)에서 서명한 인증서로 HTTPS를 사용해야 합니다. 엔드포인트 URL은 최대 2자048자까지 가능합니다. 합산 크기가 최대 2KB인 헤더를 최대 10개까지 구성할 수 있습니다.

가격

이벤트 내보내기에는 별도의 SKU 또는 기능당 요금이 부과되지 않습니다. 그러나 이벤트를 내보내면 데이터 전송 요금이 발생할 수 있으며, 이는 대상, 리전 및 cloud 제공자 에 따라 다릅니다. 자세한 학습 은 데이터 전송 비용을 참조하세요.

자세히 알아보기

돌아가기

Splunk로 로그 내보내기

MongoDB 로그를 AWS S3로 푸시하기