对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

将操作日志事件导出到外部工具

您可以将事件从 Atlas 操作日志流式传输到外部工具,包括 DataDog、Splunk、客户托管的云存储以及任何兼容 OpenTelemetry (OTel) 的目标。导出事件可以实现集中式 Atlas 审核日志记录、长期保留以及与现有监控和可观测性工具的集成。

您可以在以下级别配置事件导出:

  • 项目:从 Project Activity Feed 导出事件。

  • 组织:从 Organization Activity Feed 导出事件。

与系统日志导出不同,事件导出不需要 M10+ 集群。事件导出支持所有层级的集群,包括免费层级和共享层级集群。

可用的目标取决于您是为项目还是组织配置集成。项目事件导出支持所有日志导出目标。在初始版本中,组织事件导出仅支持与 OTel 兼容的目标。

  • 要为项目配置事件导出,您必须拥有项目的 Project Owner 访问权限。

  • 要为组织配置事件导出,您必须拥有该组织的 Organization Owner 访问权限。

要导出项目级事件,请按照您的目标位置的配置步骤进行操作,并在系统提示时在 Log Type 下选择 Events:

您可以将 Events 与系统日志类型组合在同一个集成中,也可以为日志和事件创建单独的集成。

组织级集成仅导出事件,且仅支持与 OTel 兼容的目标。要配置组织级集成,请参阅导出组织操作日志事件。

要以编程方式配置事件导出,请使用 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}

返回一个项目级日志集成。

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 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 日志记录。记录的资源包含一个 service.name 属性,该属性设置为 mongodb-atlas-events,用于标识操作日志事件流,这样您的 OTel collector 就可以将这些事件与其他遥测数据分开路由。Atlas 从导出的事件中省略具有空值的属性。

每个导出的事件都包含以下字段:

字段
说明

timeUnixNano

事件发生的时间,以自 Unix 纪元以来的纳秒数为单位。

severityText

以文本形式表示事件的严重性,例如 INFO。与操作日志中显示的事件严重程度对应。

severityNumber

事件的严重程度,作为 OTLP 严重程度数字枚举,例如 SEVERITY_NUMBER_INFO。

body.stringValue

JSON 编码的事件对象。包含事件 ID (_id)、事件类型 (eventType)、自 Unix 纪元以来的创建时间(以毫秒为单位) (createdDate)、项目ID(如适用) (projectId)、和事件特定详情 (eventPayload)。source 对象确定是什么引发了该事件,例如 USER 的 sourceType 和具有 username 的 sourceInfo 对象。

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 最多可保留未发送的事件七天。七天后仍未发送的事件将被永久删除。

  • 没有自动重试、回填或失败警报。初始版本不会在持续失败后自动重放事件,也不会回填在您配置集成之前发生的历史事件。如需在持续失败后请求重新交付事件,请联系 MongoDB 支持。

目的地
限制

Datadog

DataDog 每个请求最多接受 5 MB 和 1,000 个事件。

Splunk

Splunk 通过 HTTP Event Collector (HEC) 批处理接收事件。如果批处理中的一个事件格式错误,Splunk 将拒绝整个批处理。

OpenTelemetry

交付取决于您的 OTel 收集器的可用性和配置。终结点必须使用 HTTPS,并使用由公共证书颁发机构 (CA) 签署的证书。终结点 URL 最多可以是 2,048 个字符。您可以配置最多 10 个头部,合并大小最多 2 KB。

事件导出没有单独的 SKU 或按功能收费。但是,导出事件可能会产生数据传输费用,具体费用因目的地、区域和云提供商而异。要了解更多信息,请参阅数据传输费用。