Docs 菜单
Docs 主页
/
MongoDB Atlas
/

与第三方服务集成

在此页面上

  • 必需的访问权限
  • 查看或修改第三方设置

您可以将 Atlas 与第三方监控服务集成,以便在各种外部监控服务中接收 Atlas 警报,并查看和分析 Atlas 收集的集群 性能指标

注意

目前,无服务器实例指标不支持任何第三方服务(例如 Datadog)。

要查看第三方集成设置,您必须对项目拥有 Organization OwnerProject Owner 访问权限。

注意

在运行任何 Atlas CLI 命令之前,您必须:

要使用 Atlas CLI 创建或更新 Datadog 集成,请运行以下命令:

atlas integrations create DATADOG [options]

要了解有关命令语法和参数的更多信息,请参阅 Atlas CLI 文档中的 Atlas 集成创建 DATADOG。

要使用 Atlas CLI 创建或更新 Opsgenie 集成,请运行以下命令:

atlas integrations create OPS_GENIE [options]

要了解有关命令语法和参数的更多信息,请参阅 Atlas CLI 文档中的 Atlas 集成创建 OPS_GENIE。

要使用 Atlas CLI 创建或更新 PagerDuty 集成,请运行以下命令:

atlas integrations create PAGER_DUTY [options]

要了解有关命令语法和参数的更多信息,请参阅 Atlas CLI 文档中的 Atlas 集成创建 PAGER_DUTY。

要使用 Atlas CLI 创建或更新 VictorOps 集成,请运行以下命令:

atlas integrations create VICTOR_OPS [options]

要了解有关命令语法和参数的更多信息,请参阅 Atlas CLI 文档中的 Atlas 集成创建 VICTOR_OPS。

要使用 Atlas CLI 创建或更新 Webhook 集成,请运行以下命令:

atlas integrations create WEBHOOK [options]

要了解有关命令语法和参数的更多信息,请参阅 Atlas CLI 文档中的 Atlas 集成创建 WEBHOOK。

要使用 Atlas CLI 列出项目的所有第三方集成,请运行以下命令:

atlas integrations list [options]

要使用 Atlas CLI 返回第三方集成的详细信息,请运行以下命令:

atlas integrations describe <integrationType> [options]

要了解上一个命令的语法和参数详情,请参阅 Atlas CLI 文档中的 Atlas 集成列表Atlas 集成说明。

提示

请参阅:相关链接

要使用 Atlas CLI 删除第三方集成,请运行以下命令:

atlas integrations delete <integrationType> [options]

要了解命令语法和参数详情,请参阅 Atlas CLI 文档中的 Atlas 集成删除。

提示

请参阅:相关链接

要使用 Atlas UI 修改第三方集成设置,请执行以下操作:

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

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

  3. Projects(项目)菜单旁边,展开 Options(选项)菜单,然后单击 Integrations(项目设置)。

    显示“项目集成”页面。

2

单击要修改的第三方服务的 Configure。您可以设置以下一项或多项:

第三方服务
配置详情

Datadog Settings

配置 Atlas 以向 Datadog 发送有关部署的指标数据。您可以在 Datadog 仪表盘中查看这些指标。要发现 Datadog 追踪的所有 Atlas 指标的详细列表,请参阅 Datadog 集成页面。

  • 如果您有 Datadog 帐户,请使用 Datadog 开始跟踪 Atlas 指标数据。

  • 如果您还没有 Datadog 帐户,请注册一个。

  • Datadog API 密钥

  • API 区域

    在 Atlas 用户界面中,Atlas 支持以下 Datadog 地区:

    • US1

    • US3

    • US5

    • EU1

    • AP1

    Datadog 默认使用 US1

    如要了解有关 Datadog 区域的更多信息,请参阅 Datadog 站点

Microsoft Teams Settings

配置 Atlas,以将有关项目的警报发送到 Microsoft Teams 频道。您可以在频道中显示的自适应卡片中查看这些警报。

要将警报通知发送到 Microsoft Teams 通道,您必须创建 Microsoft Teams 传入 Webhook。创建 Webhook 后,您可以使用自动生成的 URL 在 Atlas 中配置 Microsoft Teams 集成。

要设置集成,请参阅与 Microsoft Teams 集成

New Relic Settings

重要提示:自 2021 年 6 月 16 日星期三起,New Relic 不再支持与 MongoDB 的基于插件的集成。建议不要注册基于插件的集成。要了解更多信息,请参阅 New Relic 插件 EOL 声明。

配置 Atlas,以将有关部署的指标数据发送到 New Relic,以便通过 New Relic MongoDB 插件进行查看。您还可以使用 Insights for New Relic 对已收集的数据进行分析。Atlas 向 New Relic 发送的指标数据与 Atlas 集群指标中显示的指标数据相同。

  • 如果您有 New Relic 帐户,请输入以下信息:

    • 帐户 ID

    • 许可证密钥

    • Insights API 插入密钥

    • Insights API 查询密钥

  • 如果您没有 New Relic 账户,请注册一个账户。

如果任何密钥后来失效,Atlas 会向项目所有人发送电子邮件,并最终删除无效的凭证。

OpsGenie API Key

OpsGenie 警报 API 设置 API 密钥。配置警报时,这将用作默认 OpsGenie API 密钥。(请注意,此集成会将警报发送到配置的帐户,而不是团队。)

  • 如果您有 OpsGenie 帐户,请输入以下信息:

    • OpsGenie 集成 API 密钥,在您创建 OpsGenie 团队下的 API 集成后,OpsGenie 会提供该密钥。您不能使用常规 OpsGenie 帐户 API 密钥进行 Atlas 集成。

    • API 区域(美国或欧洲)

  • 如果您没有 OpsGenie 账户,请注册一个账户。

PagerDuty Service Key

为发送到 PagerDuty 账户的警报通知设置默认服务密钥。当你在警报配置中添加 PagerDuty 通知时,Atlas 会默认输入密钥。如果您添加 PagerDuty 通知,并且用于发送通知的密钥失效,则 Atlas 会向项目所有者发送电子邮件,并最终删除该密钥。

用户只能从 PagerDuty 仪表盘确认 PagerDuty 警报。

所有新的 PagerDuty 密钥都使用事件 API v2.

如果您有 事件 API v1 密钥,则可以继续在 Atlas 中使用该密钥。

Slack Settings

为发送到 Slack 账户的警报通知设置团队名称、 API 令牌和渠道名称。要配置 Slack 与 OAuth2 的集成,单击 Configure,然后单击 Sign in with Slack

登录后,系统会转到 Slack 登录页面,您可在其中选择工作区并配置权限。将 Slack 配置为连接到 Atlas 后,系统会自动生成并维护您的 API 令牌。Atlas 会将您重定向回 Integrations page

使用 Atlas 进行初始配置 Slack 后,您可以 EditRemove 集成。编辑集成时,Atlas 会显示团队名称和 API 令牌,并允许您更改频道名称。

重要提示:Atlas 已弃用旧版令牌。您无法使用旧版令牌配置新的 Slack 集成,也无法编辑任何现有的旧版令牌。如果您在 Atlas 弃用旧版令牌之前使用该令牌配置 Slack 集成,则可以继续使用旧版令牌。但是,如果您需要编辑令牌配置,则必须重新配置 Slack 与 OAuth2 的集成。

SumoLogic Settings

为您连接 SumoLogic 相关文档,以便使用 Atlas 配置 SumoLogic。您无需在 Atlas 中配置任何设置即可设置 SumoLogic 集成。

VictorOps Settings

为发送到 Splunk On-Call(以前称为 VictorOps)帐户的警报通知设置 API 密钥和路由密钥。Atlas 在配置警报时使用此信息作为默认设置。

Webhook Settings

添加了 Webhook URL 端点,Atlas 可以向该端点发送用于编程处理的警报通知。Atlas 以 HTTP 帖子请求的形式发送警报通知。请求正文包含使用与 Atlas Administration API Alerts 资源具有相同格式的 JSON 文档。

Atlas添加了一个名为 X-MMS-Event 的请求标头,以区分各种警报状态。此标头的可能值为:

alert.open

警报刚刚打开。

alert.close

警报已解决。

alert.update

先前打开的警报仍处于打开状态。

alert.acknowledge

警报已得到确认。

alert.cancel

警报无效并被取消。

alert.inform

表示信息警报,即持续云备份事件,例如“主节点当选”。

如果您在 Webhook Secret 字段中指定键,则 Atlas 会添加 X-MMS-Signature 请求标头。此标头包含请求主体的 Base64 编码的 HMAC-SHA-1 签名。Atlas 使用提供的密钥创建签名。

要向 Webhook 发送警报通知,请在创建或编辑警报时选择 Webhook 通知选项。如果您添加 Webhook 通知,并且 URL 或可选密钥失效,Atlas 会向项目所有者发送一封电子邮件,并最终删除 Webhook 设置。

重要提示:如果您的防火墙配置需要,请允许从 Atlas IP 地址进行访问,这样 Atlas 就可以与 webhook 通信。

Prometheus Settings

配置 Atlas,将有关部署的指标数据发送到 Prometheus 实例。要了解更多信息,请参阅与 Prometheus 集成。

注意

如果此表未显示服务的欧洲集成点,则 Atlas 不支持该集成点。目前,只有 OpsGenieDataDog 提供独立的欧洲集成点。

后退

可用指标