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

Atlas 활동 피드에서 DataDog, Splunk, 고객 관리형 클라우드 저장소 및 모든 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 Administration 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}`	프로젝트 수준의 로그 통합 1개를 반환합니다.
`PUT`	`/api/atlas/v2/groups/{groupId}/logIntegrations/{id}`	프로젝트 수준의 로그 통합 1개를 업데이트합니다.
`DELETE`	`/api/atlas/v2/groups/{groupId}/logIntegrations/{id}`	프로젝트 수준의 로그 통합 1개를 제거합니다.
`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 Administration 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 collector는 이 이벤트를 다른 telemetry와 별도로 배포할 수 있습니다. Atlas는 내보낸 이벤트에서 널 값을 가진 속성을 제외합니다.

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

필드	설명
`timeUnixNano`	유닉스 시간 이후 나노초 단위로 표시된 이벤트 발생 시간입니다.
`severityText`	이벤트 의 심각도를 `INFO` 같은 텍스트로 표시합니다. 활동 피드에 표시된 이벤트 심각도에 해당합니다.
`severityNumber`	OTLP 심각도 번호 열거형으로 나타낸 이벤트 심각도(예: `SEVERITY_NUMBER_INFO`).
`body.stringValue`	JSON 인코딩된 이벤트 객체. 이벤트 ID(`_id`), 이벤트 유형(`eventType`), 유닉스 시간 이후 밀리초 단위의 생성 시간(`createdDate`), 프로젝트 ID(`projectId`, 해당하는 경우), 및 이벤트 특정 세부 정보(`eventPayload`)가 포함됩니다. `source` 객체는 이벤트를 시작한 것을 식별합니다. 예를 들어 `USER`의 `sourceType` 및 `username`이 있는 `sourceInfo` 객체 등이 있습니다.
`mongodb.event.id` 속성	이벤트의 고유 식별자입니다. 이 필드를 사용하여 이벤트를 중복 제거합니다.
`mongodb.event.type` 속성	활동 피드 이벤트 유형. 이벤트 유형 목록은 Atlas 경고 이벤트 유형을 참조하세요.
`mongodb.event.payload.encoding` 속성	`json`와(과) 같은 `body.stringValue`의 이벤트 페이로드 인코딩입니다.
`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는 거의 실시간으로 이벤트를 전달합니다. 배치는 약 1분에 한 번씩 플러시됩니다.
최소 1회 전달. Atlas는 동일한 이벤트를 두 번 이상 전달할 수 있습니다. 고유한 mongodb.event.id 필드를 사용하여 이벤트를 중복 제거합니다.
장애 발생 시 버퍼링. 대상을 사용할 수 없는 경우 Atlas는 이벤트를 버퍼링하고 전송을 재시도합니다. Atlas는 전달되지 않은 이벤트를 최대 7일 동안 보관합니다. 7일 후에도 전달되지 않은 이벤트는 영구적으로 삭제됩니다.
자동 재시도, 백필 또는 실패 경고가 없습니다. 초기 릴리스는 지속적인 실패 후 이벤트를 자동으로 다시 재생하지 않으며 통합을 구성하기 전에 발생한 과거 이벤트를 백필하지 않습니다. 지속적인 실패 후 이벤트 재전송을 요청하려면 MongoDB 지원에 문의하세요.

대상 제한

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

가격

이벤트 내보내기에는 별도의 SKU나 기능별 요금이 없습니다. 단, 이벤트를 내보낼 때 대상, 리전, 클라우드 공급자에 따라 데이터 전송 요금이 발생할 수 있습니다. 자세한 내용은 데이터 전송 비용을 참조하세요.

자세히 알아보기

돌아가기

Splunk로 로그 내보내기

MongoDB 로그를 AWS S3로 푸시하기