将日志导出到外部服务

重要

您可以将 M10+ Atlas集群配置为每分钟将系统日志导出到外部服务。将日志导出到外部服务可以实现日志的集中管理、长期保留以及与现有监控和可观察性工具的集成。

支持的日志类型

Atlas支持导出以下日志类型：

您可以指定要导出的日志类型，并配置最多 10 条导出路径，以将日志同时发送到多个目标。

重要

日志可能包含敏感信息（包括 PII）。您负责在外部服务中存储和处理日志。要让Atlas在导出日志之前编辑某些信息，联系MongoDB支持部门。

您必须有一个 M10+集群才能导出日志。日志导出不适用于免费或共享层集群。此要求不适应用操作日志事件导出，因为它支持所有层的集群。
您必须拥有 Project Owner 或 Organization Owner 访问权限才能配置日志导出。
每台Atlas托管每天通常会生成 1 GB的日志。导出日志会产生数据传输费用。确切的数据传输费用因目的地、地区和云提供商而异。
出口日志源自 AWS us-east-1 中的Atlas控制平面，而与集群的地区或云提供商无关。如果您的集群不在 AWS us-east-1 中，除了互联网出口费用外，您还会产生跨区域或云间数据传输费用。要学习；了解有关数据传输成本的更多信息，请参阅数据传输成本。
网络问题或重试可能会导致外部服务出现重复的日志条目。

Atlas自动处理日志导出故障并进行恢复，无需人工干预：

当将日志传送到外部接收器失败时， Atlas默认会自动使用指数退避进行重试，默认下最多尝试 3。重试延迟从 1 秒开始，并增加一倍，直到两次尝试之间的最大延迟为 10 秒。

在 5 次连续失败后，熔断器会打开，以防止重复请求对目标服务进行大量冲击。熔断器会保持打开状态 5 分钟，然后尝试进行一次测试写入。如果测试成功，则恢复正常操作。如果失败，熔断器会重新打开。

每个接收器配置都有自己独立的断路器，因此一个集成的问题不会影响其他集成。

当重试次数已用尽或出现不可重试的错误（例如无效凭证）时， Atlas会将失败的日志事件放入死信队列 (DLQ)，并保留 7 天。 DLQ 可防止接收器不可用时丢失数据。

警告

超过 7 天的日志将从 DLQ 中永久删除。如果您的接收器无法访问的时间超过 7 天，则无法恢复这些日志。

当连接恢复并且熔断器关闭时，Atlas 会自动重新处理从 DLQ 到您的目标的排队日志。无需人工干预。

警告

如果在日志在 DLQ 中排队时修改接收器配置，则排队的日志在重放时将使用新配置。示例，如果将目标从一个 S3 存储桶更改为另一个存储桶，排队的日志将发送到新存储桶，而不是原始目标。

Atlas提供默认警报，在以下情况下自动向 Project Owner用户发送电子邮件通知：

这些警报是信息性的，这意味着它们只显示在项目操作日志中，不会显示在 Project Alerts 页面的 Open Alerts 或Closed Alerts 标签页上。要学习；了解有关信息警报生命周期的更多信息，请参阅警报工作流。

此外，项目操作日志还会记录以下信息性事件：

您可以在项目的警报设置中自定义警报接收者和通知方法。有关详细信息，请参阅配置警报。

下表总结了Atlas支持日志导出的外部服务：

目的地	说明
Amazon Web Services S3	将 `mongod`、`mongos` 和Atlas 审核日志导出到 AWS S3 存储桶。支持多区域接入点 (MRAP)。
Azure Blob 存储	将 `mongod`、`mongos` 和Atlas 审核日志导出到Azure Blob 存储容器。
Datadog	将 `mongod`、`mongos` 和Atlas 审核日志导出到 Datadog，以进行实时日志分析和仪表盘。
Google Cloud PlatformGoogle Cloud Platform存储	将 `mongod`、`mongos` 和Atlas 审核日志导出到 Google Cloud Storage 存储桶。
OpenTelemetry	将 `mongod`、`mongos` 和Atlas 审核日志导出到 OpenTelemetry (OTel) 终结点，以实现供应商中立的可观察性。
Splunk	将 `mongod`、`mongos` 和Atlas 审核日志导出到 Splunk Cloud 或 Splunk Enterprise，以便集中搜索和分析日志。

所有支持的目标都可以导出项目级操作日志事件。组织级事件导出仅支持 OpenTelemetry。