获取一个警报
注意
注意:群组和项目是同义词。您的 {PROJECT-ID}
与您的项目 ID 相同。对于现有群组,群组/项目 ID 保持不变。当引用说明时,此页面将使用“群组”这个更为人熟知的术语。端点仍如文档中所述。
基本 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /groups/{PROJECT-ID}/alerts/{ALERT-ID}
请求路径参数
Parameter | 类型 | 说明 |
---|---|---|
PROJECT-ID | 字符串 | (必需。) 项目标识符。 |
ALERT-ID | 字符串 | (必需。) 警报标识符。 |
请求查询参数
以下查询参数为可选参数:
名称 | 类型 | 必要性 | 说明 | 默认 | ||||||
---|---|---|---|---|---|---|---|---|---|---|
pretty | 布尔 | Optional | 指示响应正文是否应采用 Prettyprint 的标志 格式。 | false | ||||||
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题,可在查询中设置 envelope=true。 对于返回一个结果的端点,响应体包括:
| false |
请求正文参数
此端点不使用 HTTP 请求正文参数。
响应
返回文档中的字段取决于警报类型:
名称 | 类型 | 说明 |
---|---|---|
acknowledged Until | 字符串 | ISO8601 格式的时间戳 确认警报之前的日期和时间格式( UTC )。 如果警报已被确认,Ops Manager 会返回此值。 |
acknowledgement Comment | 字符串 | 确认警报的用户留下的评论。 如果警报已被确认,Ops Manager 会返回此值。 |
acknowledging Username | 字符串 | 确认警报的用户的用户名。 如果警报已被确认,Ops Manager 会返回此值。 |
alertConfigId | 字符串 | 触发此警报的警报配置的唯一标识符。 |
clusterId | 字符串 | 此警报适用的集群的唯一标识符。 在以下情况下,Ops Manager 返回该值:
|
clusterName | 字符串 | 此警报适用的集群的名称。 在以下情况下,Ops Manager 返回该值:
|
created | 字符串 | ISO 格式的时间戳8601 打开警报时的日期和时间格式( UTC 格式)。 |
currentValue | 对象 | 触发警报的指标的当前值。 如果 |
currentValue .number | 数字 | 指标的值。 |
currentValue .units | 字符串 | 值的单位。 值取决于指标类型。 示例,测量内存消耗的指标将具有字节测量值,而测量时间的指标将具有时间单位。 Ops Manager 可能会返回:
|
eventTypeName | 字符串 | 触发警报的事件的名称。 接受的值为: 助手 自动化配置 备份- BI Connector 集群 已访问数据浏览器 主机 组织 项目 副本集(Replica Set) 团队 user 有关 Ops Manager 审核日志中包含的事件的完整列表,请参阅Audit 事件。 |
groupId | 字符串 | 为其打开此警报的群组的唯一标识符。 |
hostId | 字符串 | 指标所属主机的唯一标识符。 如果
|
hostnameAndPort | 字符串 | 警报适用的每个主机的主机名和端口。 这可以是主机名、 FQDN 、 IPv4地址或IPv6地址。 如果
|
id | 字符串 | 警报的唯一标识符。 |
lastNotified | 字符串 | ISO8601 格式的时间戳 上次为此警报发送通知的日期和时间格式( UTC 格式)。如果已发送通知, MongoDB Ops Manager将返回此值。 |
links | 对象数组 | 指向子资源和/或相关资源的一个或多个链接。 响应中的所有 |
metricName | 字符串 | |
replicaSetName | 字符串 | 副本集名称。 如果
|
resolved | 字符串 | ISO8601 格式的时间戳 警报关闭时的日期和时间格式( UTC 格式)。 如果 |
status | 字符串 | 警报的当前状态。 Ops Manager 可以返回以下之一:
|
sourceTypeName | 字符串 |
|
tags | 字符串数组 | 正在为此警报设置标识标签。 |
updated | 字符串 | ISO8601 格式的时间戳 上次更新警报时的日期和时间格式( UTC 格式)。 |
警报的测量类型
alerts
资源会在metricName
字段中返回测量类型。 仅当eventTypeName
设置为OUTSIDE_METRIC_THRESHOLD
时,该字段才存在。
主机测量
| 在serverStatus命令生成的 asserts 文档中找到 MongoDB 进程的断言的比率。 |
| 在后台刷新的数据量。 |
| 在 serverStatus 命令生成的 WiredTigerstorage engine和 文档中找到的 缓存和票证中的字节数。 wiredTiger.cache wiredTiger.concurrentTransactions |
| 在serverStatus命令生成的 connections 文档中找到的 MongoDB 进程的连接数。 |
| |
| MongoDB 进程的 Memory Issues 和Page Faults 的数量。 |
| 等待serverStatus命令生成的MongoDB进程锁的操作数。 MongoDB Ops Manager根据存储引擎的类型计算这些值。 |
| 索引 btree 操作的次数。 |
| 日志操作的数量。 |
| 在serverStatus命令收集的 mem 文档中找到的 MongoDB 进程的内存量。 |
| 在serverStatus命令收集的 network 文档中找到的 MongoDB 进程的吞吐量。 |
| MongoDB 进程的oplog 的持续时间和吞吐量。 |
| 从 MongoDB dbStats 命令收集的磁盘存储空间。 |
| 自上次启动 MongoDB 进程以来该进程的数据库操作速率,可在serverStatus命令收集的 opcounters 文档中找到。 |
| |
| 所选时间段内每秒返回、插入、更新或删除的文档的平均速率。 |
| 所选时间段内执行排序但无法使用索引执行排序的每秒操作的平均速率。 |
| 所选时间段内每次读取、写入或命令操作的平均执行时间(以毫秒为单位)。 适用于运行 MongoDB 3.4 或更高版本的主机。 |
| 主机在前一小时内重新启动的次数。 |
| 物理内存使用量(以字节为单位)。 |
| 网络吞吐量(以字节每秒为单位)。 |
| 正在使用的交换空间总量。 |
请求示例
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --header 'Accept: application/json' \ --include \ --request GET "https://<ops-manager-host>/api/public/v1.0/groups/{PROJECT-ID}/alerts/{ALERT-ID}"
响应示例
响应标头
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
响应体
{ "alertConfigId" : "5b43d04087d9d6357de591aa", "created" : "2019-07-26T21:12:19Z", "currentValue" : { "number" : 100, "units" : "RAW" }, "eventTypeName" : "OUTSIDE_METRIC_THRESHOLD", "humanReadable" : "Project: testProj Organization: testOrg Alert acknowledged by user@example.com until 2019/10/17 19:48 GMT. Comment: N/A Connections has gone below 1000 mycluster.example.com:27017 Created: 2019/10/17 15:26 GMT Replica Set: cluster0-shard-0 Type: Primary Current Value: 100" "groupId" : "535683b3794d371327b", "hostnameAndPort" : "mycluster.example.com:27017", "id" : "533cb4b8e4b0f1820cdabc7f", "lastNotified" : "2019-07-26T21:13:48Z", "metricName" : "CONNECTIONS", "replicaSetName" : "mycluster", "resolved" : "2019-07-26T21:13:42Z", "status" : "CLOSED", "typeName" : "HOST_METRIC", "updated" : "2019-07-26T21:13:42Z", "links" : [ ... ] }