mongocli Cloud Manager 警报 settings 更新
修改项目指定警报配置的详细信息。
要使用此命令,您必须使用具有项目所有者角色的用户帐户或 API 密钥进行身份验证。
语法
命令语法
mongocli cloud-manager alerts settings update <alertConfigId> [options]
参数
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
alertConfigId | 字符串 | true | 要更新的警报配置的唯一标识符。 |
选项
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
--apiKey | 字符串 | false | Datadog API 密钥、Opsgenie API 密钥或 VictorOps API 密钥。 如果 notificationType 分别为 DATADOG、OPS_GENIE 或 VICTOR_OPS,则为必填项。 |
--enabled | false | 指示是否启用警报配置的标志。 | |
--event | 字符串 | false | 触发警报的事件类型。 要了解 CLI 接受哪些值,请参阅 Atlas 的 API 文档中可能的 eventTypeName 值 ( https://dochub.mongodb.org/core/atlas-event-names ),MongoDB Ops Manager( https://dochub.mongodb.org/core/om-event-names ),或 Cloud Manager ( https://dochub.mongodb.org/core/cm-event-names )。 |
-h,--help | false | 更新帮助 | |
--matcherFieldName | 字符串 | false | 目标对象中要匹配的字段的名称。 要了解有效值,请运行 mongocli Atlas alerts settings fields type。 |
--matcherOperator | 字符串 | false | 根据 matcherValue 检查当前指标时要应用的比较操作符。 有效值为 CONTAINS、ENDS_WITH、EQUALS、NOT_CONTAINS、NOT_EQUALS、REGEX、STARTS_WITH。 |
--matcherValue | 字符串 | false | 要使用指定操作符进行测试的值。 如果将 matcherFieldName 设置为 TYPE_NAME,则可以匹配以下值:CONFIG、Mongo、PRIMARY、SECONDARY、独立运行的实例。 |
--metricMode | 字符串 | false | 指示 Atlas 是否将当前指标值计算为平均值的选项。 有效值为 AVERAGE。 |
--metricName | 字符串 | false | 此命令检查已配置警报所对照的指标名称。 要了解有效值,请参阅 https://dochub.mongodb.org/core/alert-host-metrics-atlas 。仅当事件设置为 OUTSIDE_METRIC_THRESHOLD 时,此选项才适用。 |
--metricOperator | 字符串 | false | 检查当前指标值时要应用的比较操作符。有效值为 LESS_THAN 和 GREATER_THAN。 |
--metricThreshold | float | false | 阈值,超出该阈值将触发警报。 |
--metricUnits | 字符串 | false | 阈值的单位。 有效值为 BITS、BYTES、DAYS、GIGABITS、GIGABYTES、HOURS、KILOBITS、KILOBYTES、MEGABITS、MEGABYTES、MILLISECONDS、MINUTES、PBYTES、RAW、SECONDS、TB。 |
--notificationChannelName | 字符串 | false | Slack 渠道名称。对于 SLACK 通知类型是必需的。 |
--notificationDelayMin | int | false | 检测到警报条件后发送第一个通知之前的等待分钟数。 |
--notificationEmailAddress | 字符串 | false | 发送警报通知的电子邮件地址。 |
--notificationEmailEnabled | false | 启用电子邮件通知的标志。 可配置为 GROUP 和 USER 通知类型。 | |
--notificationIntervalMin | int | false | 未解决的未确认警报的连续通知之间等待的分钟数。 |
--notificationMobileNumber | 字符串 | false | 向其发送警报通知的手机号码。 |
--notificationRegion | 字符串 | false | 指示要使用的 API URL 的区域。 |
--notificationServiceKey | 字符串 | false | PagerDuty 服务密钥。 |
--notificationSmsEnabled | false | 启用文本消息通知的标志。 | |
--notificationTeamId | 字符串 | false | 团队的唯一标识符。 |
--notificationToken | 字符串 | false | Slack API 令牌或 Bot 令牌。 |
--notificationType | 字符串 | false | 警报通知类型。 有效值为 DATADOG、EMAIL、GROUP (Project)、ORG、OPS_GENIE、PAGER_DUTY、 Slack 、SMS、USER 或 VICTOR_OPS。 |
--notificationUsername | 字符串 | false | 向其发送通知的 Atlas user 的名称。 |
--notificationVictorOpsRoutingKey | 字符串 | false | 与您的 Splunk On-Call 帐户关联的路由密钥。 |
-o, --output | 字符串 | false | 输出格式。 有效值为 json、json-path、go-template 或 go-template-file。 要查看完整输出,请使用 -o json 选项。 |
--projectId | 字符串 | false | 标识要使用的项目的十六进制字符串。 此选项会覆盖配置文件或环境变量中的设置。 |
继承选项
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
-P, --profile | 字符串 | false | 要从配置文件中使用的配置文件的名称。 要了解 MongoCLI 的配置文件,请参阅 https://dochub.mongodb.org/core/atlas-cli-configuration-file。 |
输出
如果命令成功,CLI 将返回类似于以下示例的输出。 括号中的值代表您的价值观。
Alert configuration '<ID>' updated.
示例
# Modify the alert configuration with the ID 5d1113b25a115342acc2d1aa so that it notifies a user when they join a group for the project with the ID 5df90590f10fab5e33de2305: mongocli [ops-manager|cloud-manager] alerts settings update 5d1113b25a115342acc2d1aa --event JOINED_GROUP --enabled \ --notificationType USER --notificationEmailEnabled \ --notificationUsername john@example.com \ --output json --projectId 5df90590f10fab5e33de2305