您可以将事件从 Atlas 操作日志流式传输到外部工具,包括 DataDog、Splunk、客户托管的云存储以及任何兼容 OpenTelemetry (OTel) 的目标。导出事件可以实现集中式 Atlas 审核日志记录、长期保留以及与现有监控和可观测性工具的集成。
您可以在以下级别配置事件导出:
项目:从 Project Activity Feed 导出事件。
组织:从 Organization Activity Feed 导出事件。
与系统日志导出不同,事件导出不需要 M10+ 集群。事件导出支持所有层级的集群,包括免费层级和共享层级集群。
支持的目标位置
可用的目标取决于您是为项目还是组织配置集成。项目事件导出支持所有日志导出目标。在初始版本中,组织事件导出仅支持与 OTel 兼容的目标。
目的地 | 项目事件 | 组织事件 |
|---|---|---|
是 | No | |
是 | No | |
是 | No | |
是 | No | |
是 | 是 | |
是 | No |
必需的访问权限
要为项目配置事件导出,您必须拥有项目的
Project Owner访问权限。要为组织配置事件导出,您必须拥有该组织的
Organization Owner访问权限。
配置项目事件导出
要导出项目级事件,请按照您的目标位置的配置步骤进行操作,并在系统提示时在 Log Type 下选择 Events:
您可以将 Events 与系统日志类型组合在同一个集成中,也可以为日志和事件创建单独的集成。
配置组织事件导出
组织级集成仅导出事件,且仅支持与 OTel 兼容的目标。要配置组织级集成,请参阅导出组织操作日志事件。
使用 API 配置事件导出
要以编程方式配置事件导出,请使用 Atlas Administration API 的日志集成终结点。要导出事件,请设置 logTypes 以包含 EVENTS。
方法 | 端点 | 说明 |
|---|---|---|
|
| 创建一个项目级日志集成。 |
|
| 返回所有项目级日志集成。 |
|
| 返回一个项目级日志集成。 |
|
| 更新一个项目级日志集成。 |
|
| 删除一个项目级日志集成。 |
|
| 创建一个组织级日志集成。 |
|
| 返回所有组织级别的日志集成。 |
|
| 返回一个组织级日志集成。 |
|
| 更新一个组织级日志集成。 |
|
| 删除一个组织级别的日志集成。 |
注意
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 从导出的事件中省略具有空值的属性。
每个导出的事件都包含以下字段:
字段 | 说明 |
|---|---|
| 事件发生的时间,以自 Unix 纪元以来的纳秒数为单位。 |
| 以文本形式表示事件的严重性,例如 |
| 事件的严重程度,作为 OTLP 严重程度数字枚举,例如 |
| JSON 编码的事件对象。包含事件 ID ( |
| 事件的唯一标识符。使用此字段对事件进行去重。 |
| 操作日志事件类型。有关事件类型列表,请参阅 Atlas 警报事件类型。 |
|
|
| 发生事件的组织的 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 或按功能收费。但是,导出事件可能会产生数据传输费用,具体费用因目的地、区域和云提供商而异。要了解更多信息,请参阅数据传输费用。