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

将日志推送到 AWS S3 存储桶

注意

此功能不适用于Atlas Infinite。要学习;了解有关Atlas Infinite 功能和行为的更多信息,请参阅MongoDB Atlas Infinite:概述。

您可以持续将来自 mongod、mongos 的日志和Atlas 审核日志从 M10+集群推送到 AWS S3 存储桶。 Atlas每 5 分钟导出一次日志。

要将日志推送到 AWS S3 存储桶,您必须拥有Atlas 的Project Owner 或 Organization Owner访问权限。

要使用Atlas Administration API将日志推送到 AWS S3 存储桶,您必须拥有Atlas 的Project Owner访问权限。

  • 您无法指定要发送的日志。 Atlas发送所有mongod 、 mongos和Atlas 审核日志。

  • 基于推送的日志导出不支持自带密钥 (BYOK)。

  • 您只能将日志从 M10+ Atlas 集群推送到 AWS S3 存储桶。

  • Atlas不会导出超过 10 MB 的日志行。

  • 您不能对Atlas Infinite 集群使用基于推送的日志导出。如果您的项目同时包含Atlas Core 集群和Atlas Infinite 集群,Atlas仅从Atlas Core 集群推送日志。

MongoDB正在逐步淘汰基于推送的日志导出,取而代之的是外部日志接收器,后者提供1 分钟的导出间隔、AWS KMS加密、对多区域访问点的支持、额外目标以及每个目标的日志类型选择。

Date
里程碑

2 月4 , 2026

基于推送的日志导出已弃用。

九月 2026

外部日志接收器通常可供所有账户使用并启用。

十月30 , 2026

基于推送的日志导出停止接受新配置。现有出口继续不间断运行。

2 月4 , 2027

基于推送的日志导出功能已终止。 MongoDB不再为基于推送的日志导出提供安全更新、错误修复或技术支持。现有配置将继续运行,直到MongoDB与您的客户团队协调停用该功能。

要从基于推送的日志导出迁移到外部日志接收器,请完成以下步骤。

1

将对 /api/atlas/v2/groups/{groupId}/pushBasedLogExport 的调用替换为对 /api/atlas/v2/groups/{groupId}/logIntegrations 的调用。

2

配置集成以使用与基于推送的配置相同的 AWS IAM角色和 S3 存储桶。要保留基于推送的每日文件夹路径结构,请将 useLegacyPathStructure设立为 true。有关配置步骤,请参阅将日志导出到 AWS S3 存储桶。

3

确认Atlas按预期将日志传送到您的存储桶。在此验证期间,基于推送的日志导出和外部日志接收器都会传送日志,因此您的存储桶包含重复条目。

4

验证交付后,禁用基于推送的配置。重复交付停止。

如果在迁移过程中遇到阻碍,联系MongoDB支持部门。

您将需要:

  • 具有 sts:AssumeRole 的 AWS IAM角色,授予Atlas访问权限您的 AWS资源的权限,并将最大会话持续时间设立为 12 小时。

  • 现有 AWS S3 存储桶。

  • 一个 M10+ Atlas 集群。

注意

在此过程中, Atlas会创建角色策略来访问权限具有以下权限的 S3 存储桶:

要将日志持续推送到 AWS S3 存储桶,请按照以下步骤操作。

1
  1. 如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含项目的组织。

  2. 如果尚未显示,请从导航栏的 Projects 菜单中选择您的项目。

  3. 在侧边栏中,单击 Security 标题下的 Database & Network Access。

  4. 在侧边栏中,单击 Advanced。

    显示“高级”页面。

2
3
4

系统将提示您 a) 创建新的 AWS 角色,或 b) 使用已附加到 Atlas 的角色。