{"id":1523,"date":"2021-02-10T09:45:45","date_gmt":"2021-02-10T09:45:45","guid":{"rendered":"https:\/\/www.ipcpu.com\/?p=1523"},"modified":"2021-09-10T09:46:18","modified_gmt":"2021-09-10T09:46:18","slug":"alertmanager-api","status":"publish","type":"post","link":"https:\/\/c.ipcpu.com\/2021\/02\/alertmanager-api\/","title":{"rendered":"\u4f7f\u7528alertmanager\u7684API\u63a5\u53e3\u53d1\u9001\u62a5\u8b66\u6d88\u606f"},"content":{"rendered":"

\u4f7f\u7528alertmanager\u7684API\u63a5\u53e3\u53d1\u9001\u62a5\u8b66\u6d88\u606f.md<\/p>\n

Alertmanager\u63d0\u4f9b\u4e86API\u4f9b\u5176\u4ed6\u7a0b\u5e8f\u8c03\u7528\uff0c\u76ee\u524d\u7248\u672c\u662fV2\uff0c\u6587\u6863\u6bd4\u8f83\u5c11\uff0c\u4ec5\u5728github\u4e2d\u6709\u4e2a\u5e2e\u52a9\u9875\u9762\u3002\u6211\u4eec\u8fd9\u91cc\u6574\u7406\u4e0b\u6700\u5e38\u7528\u7684\u51e0\u4e2a\u63a5\u53e3\u3002\u8c03\u8bd5\u5de5\u5177\u6211\u4f7f\u7528\u7684Postman\u3002<\/p>\n

GET \/api\/v2\/alerts \u67e5\u8be2\u62a5\u8b66\u4fe1\u606f<\/h2>\n

Query\u53c2\u6570\u5982\u4e0b\uff0c\u4ee5\u4e0b\u53c2\u6570\u7528\u6765\u8fc7\u6ee4\u544a\u8b66
\n<\/p>\n

\u7ed3\u679c\u5982\u4e0b<\/p>\n

\n
 [{\n        \"annotations\": {\n            \"description\": \"TCP_ESTAB\u6570\u5f02\u5e38 IS-PUSH-PRO-tcpserver-06: 445313\",\n            \"summary\": \"TCP_ESTAB\u6570\u5f02\u5e38 IS-PUSH-PRO-tcpserver-06\"\n        },\n        \"endsAt\": \"2020-08-23T03:14:29.564Z\",\n        \"fingerprint\": \"19a2d1b57b6f28ba\",\n        \"receivers\": [\n            {\n                \"name\": \"pywebhook\"\n            }\n        ],\n        \"startsAt\": \"2020-08-23T00:25:14.564Z\",\n        \"status\": {\n            \"inhibitedBy\": [],\n            \"silencedBy\": [\n                \"57bd377f-05b1-4016-9086-7318c298678e\",\n                \"757f69d8-8529-4ae3-b1f3-b9b750ba113f\"\n            ],\n            \"state\": \"suppressed\"\n        },\n        \"updatedAt\": \"2020-08-23T11:11:31.711+08:00\",\n        \"generatorURL\": \"https:\/\/prometheus.lpcsd.com\/graph?g0.expr=node_netstat_Tcp_CurrEstab%7Benv%3D%22PRO%22%7D+%3E+20000+and+abs%28node_netstat_Tcp_CurrEstab%7Benv%3D%22PRO%22%7D+-+node_netstat_Tcp_CurrEstab%7Benv%3D%22PRO%22%7D+offset+1d%29+%3E+20000&g0.tab=1\",\n        \"labels\": {\n            \"alertname\": \"TCP_ESTAB\u6570\u5f02\u5e38\",\n            \"application\": \"tcpserver\",\n            \"buniess\": \"PRODUCT01\",\n            \"dc\": \"TC\",\n            \"env\": \"PRO\",\n            \"instance\": \"IS-PUSH-PRO-tcpserver-06\",\n            \"instancetype\": \"app\",\n            \"job\": \"TC-app\",\n            \"product\": \"PUSH\",\n            \"severity\": \"Information\",\n            \"team\": \"node\"\n        }\n    }\n]<\/code><\/pre>\n<\/div>\n

POST \/api\/v2\/alerts \u53d1\u9001\u65b0\u7684\u62a5\u8b66\u4fe1\u606f<\/h2>\n
\n
[{ \n    \"labels\": {\n        \"alertname\": \"\u6211\u53ea\u662f\u4e00\u4e2a\u6d4b\u8bd5\",\n        \"service\": \"\u522b\u62c5\u5fc3\",\n        \"severity\":\"Warning\",\n        \"instance\": \"IS-MBG-PRO-jenkins-01\"\n    },\n    \"annotations\": {\n        \"summary\": \"\u6d4b\u8bd5\"\n    },\n    \"startsAt\": \"2020-08-23T10:00:00.000+08:00\", \n    \"endsAt\": \"2020-08-23T01:11:00.000+08:00\"\n}]<\/code><\/pre>\n<\/div>\n

Body\u53c2\u6570\u662f\u4e00\u4e2a\u6570\u7ec4[]\uff0c\u683c\u5f0f\u662fapplication\/json\uff0c\u91cc\u9762\u662f\u4e00\u4e2a\u4e2a\u7684\u544a\u8b66\u3002\u5176\u4e2dstartsAt\u4e0eendsAt\u662f\u53ef\u9009\u53c2\u6570\uff0c\u4e14\u683c\u5f0f\u5fc5\u987b\u662f\u4e0a\u9762\u7684\u90a3\u79cd\uff0c\u4e0d\u80fd\u662f\u65f6\u95f4\u6233\u3002generatorURL\u4e5f\u662f\u4e00\u4e2a\u53ef\u9009\u9879\u3002\u8fd9\u91cc\u9762\u662f\u6ca1\u6709status\u8fd9\u4e00\u9879\u7684\uff0c\u5f53\u7136\u5199\u4e86\u4e5f\u4e0d\u4f1a\u62a5\u9519\uff0c\u4f46\u662f\u53ea\u8981alertmanager\u63a5\u6536\u5230\u7684\u5c31\u88ab\u8ba4\u4e3a\u662f\u4e00\u4e2a\u62a5\u8b66\u3002<\/p>\n

GET \/api\/v2\/silences \u83b7\u53d6\u6c89\u9ed8\u89c4\u5219<\/h2>\n

\u6211\u4ece\u7ebf\u4e0a\u5bfc\u51fa\u4e862\u4e2a\u6bd4\u8f83\u5178\u578b\u7684\u4f8b\u5b50\uff0c\u4e00\u4e2a\u662fisRegex\u5339\u914d\uff0c\u4e00\u4e2a\u6ca1\u6709\u542f\u7528isRegex\u5339\u914d\u3002\u5982\u4e0b<\/p>\n

\n
[{\n        \"id\": \"dd9f7558-0aa8-4827-8f03-b0a539fac598\",\n        \"status\": {\n            \"state\": \"active\"\n        },\n        \"updatedAt\": \"2020-05-26T03:47:04.088Z\",\n        \"comment\": \"1\",\n        \"createdBy\": \"a\",\n        \"endsAt\": \"2020-08-26T17:46:45.327Z\",\n        \"matchers\": [{\n            \"isRegex\": true,\n            \"name\": \"hostname\",\n            \"value\": \"IS-AMT-PRO-bid-redis-cluster-.*\"\n        }],\n        \"startsAt\": \"2020-05-26T03:47:04.088Z\"\n    },\n    {\n        \"id\": \"560b6d4f-a746-4e88-b6f1-b411ea62442f\",\n        \"status\": {\n            \"state\": \"active\"\n        },\n        \"updatedAt\": \"2020-07-28T08:05:15.095Z\",\n        \"comment\": \"aa\",\n        \"createdBy\": \"1\",\n        \"endsAt\": \"2020-08-27T08:05:06.950Z\",\n        \"matchers\": [{\n                \"isRegex\": false,\n                \"name\": \"instance\",\n                \"value\": \"IS-GAME-PRO-app-bigdata-01\"\n            },\n            {\n                \"isRegex\": false,\n                \"name\": \"alertname\",\n                \"value\": \"PortDownDectect\"\n            }\n        ],\n        \"startsAt\": \"2020-07-28T08:05:15.095Z\"\n    }\n]<\/code><\/pre>\n<\/div>\n

POST \/api\/v2\/silences \u521b\u5efa\u4e00\u4e2a\u6c89\u9ed8\u89c4\u5219<\/h2>\n
\n
{\n    \"comment\": \"test\",\n    \"createdBy\": \"abc\",\n    \"matchers\": [{\n        \"isRegex\": false,\n        \"name\": \"hostname\",\n        \"value\": \"IS-MBG-PRO-jenkins-01\"\n    }],\n    \"startsAt\": \"2020-08-23T00:00:00.088Z\",\n    \"endsAt\": \"2020-08-24T00:00:00.088Z\"\n}<\/code><\/pre>\n<\/div>\n

Body\u53c2\u6570\u662f\u4e00\u4e2a\u5b57\u5178\uff0c\u683c\u5f0f\u662fapplication\/json\u3002
\n\u521b\u5efa\u6210\u529f\u4ee5\u540e\u4f1a\u663e\u793asilenceID, \u540e\u9762\u53ef\u4ee5\u4f7f\u7528 DELETE \/silence\/{silenceID} \u5220\u9664\u6c89\u9ed8\u89c4\u5219(DELETE\u63d0\u4ea4\u7684\u6570\u636e\uff0c\u548c\u521b\u5efa\u6210\u529f\u4ee5\u540e\u7684\u6570\u636e\u4e00\u81f4)<\/p>\n

\n
{\n    \"silenceID\": \"91b199ad-3d96-4394-a797-fe187827c72e\"\n}<\/code><\/pre>\n<\/div>\n

\u6ce8\u610f\u4e8b\u9879<\/h2>\n

\u5728\u8fd9\u91cc\uff0c\u6211\u4eec\u5fc5\u987b\u91cd\u7533\u4e00\u904dprometheus\u5411alertmanager\u53d1\u9001\u62a5\u8b66\u6d88\u606f\u7684\u8fc7\u7a0b\u3002
\nprometheus\u6839\u636e\u53c2\u6570evaluation_interval\u8bbe\u5b9a\u7684\u5468\u671f\uff0c\u6839\u636e\u8bbe\u5b9a\u7684\u62a5\u8b66\u89c4\u5219\u8fdb\u884c\u67e5\u8be2\uff0c\u5982\u679c\u67e5\u8be2\u7ed3\u679c\u4e3aTrue\uff0c\u4f1a\u8fdb\u5165pending\u72b6\u6001\uff0c\u7ecf\u8fc7for\u53c2\u6570\u8bbe\u5b9a\u5468\u671f\u4ee5\u540e\uff0c\u8fdb\u5165firing\u72b6\u6001\uff0c\u6b64\u65f6\u4f1a\u5411alertmanager\u53d1\u9001\u544a\u8b66\u6d88\u606f\u3002<\/p>\n

\u5728\u4e0b\u4e00\u4e2aevaluation_interval\u5468\u671f\uff0cprometheus\u4ecd\u7136\u4f1a\u5411alertmanager\u53d1\u9001\u6d88\u606f\uff0c\u76f4\u5230\u89c4\u5219\u67e5\u8be2\u7ed3\u679c\u4e3aFalse\uff0c\u8fdb\u5165inactive\u72b6\u6001\uff08resolved\uff09\uff0cprometheus\u4f1a\u5411alertmanager\u53d1\u9001resolved\u6d88\u606f\u3002<\/p>\n

\u4e5f\u5c31\u662f\u8bf4\u5982\u679c\u4e00\u4e2a\u544a\u8b66\u6ca1\u6709\u6062\u590d\uff0c\u90a3\u4e48prometheus\u6bcf\u9694evaluation_interval\u65f6\u95f4\u5c31\u4f1a\u5411alertmanager\u53d1\u6d88\u606f\u3002<\/p>\n

\u540c\u6837\u7684alertmanager\u4e2d\u6709\u4e00\u4e2a\u53c2\u6570\uff0cresolve_timeout \uff0c\u8868\u793a\u5f53\u6301\u7eedresolve_timeout (\u9ed8\u8ba45\u5206\u949f)\u65f6\u957f\u4ee5\u540e\u6ca1\u6709\u6536\u5230\u6765\u81eaprometheus\u7684\u6d88\u606f\uff0c\u90a3\u4e48\u4f1a\u8ba4\u5b9a\u6b64\u62a5\u8b66\u5df2\u7ecf\u6062\u590d\u3002<\/p>\n

\u5728\u4e0a\u9762\u7684\u573a\u666f\u4e2d\uff0c\u6211\u4eec\u901a\u8fc7API\u624b\u52a8\u521b\u5efa\u4e86\u4e00\u6761\u62a5\u8b66\uff0c\u7531\u4e8e\u6211\u4eec\u6ca1\u6709\u540e\u7eed\u52a8\u4f5c\uff0c\u6b64\u6761\u62a5\u8b66\uff0c\u4f1a\u5728resolve_timeout (\u9ed8\u8ba45\u5206\u949f)\u65f6\u957f\u540e\uff0c\u8fdb\u5165\u6062\u590d\u72b6\u6001(resolved)\u3002\u5982\u679c\u4e0d\u60f3\u6536 resolved\u62a5\u8b66\uff0c\u53ef\u4ee5\u5728\u63a5\u6536\u4eba\u53c2\u6570send_resolved: false \u6765\u5173\u95ed\u3002<\/p>\n

\u53c2\u8003\u8d44\u6599<\/h2>\n

https:\/\/github.com\/prometheus\/alertmanager\/blob\/main\/api\/v2\/openapi.yaml<\/a>
\n
https:\/\/zhuanlan.zhihu.com\/p\/43637757<\/a><\/p>\n

\u8f6c\u8f7d\u8bf7\u6ce8\u660e\uff1aIPCPU-\u7f51\u7edc\u4e4b\u8def<\/a> » \u4f7f\u7528alertmanager\u7684API\u63a5\u53e3\u53d1\u9001\u62a5\u8b66\u6d88\u606f<\/a><\/p>","protected":false},"excerpt":{"rendered":"

\u4f7f\u7528alertmanager\u7684API\u63a5\u53e3\u53d1\u9001\u62a5\u8b66\u6d88\u606f.md Alertmanager\u63d0\u4f9b\u4e86API\u4f9b\u5176\u4ed6\u7a0b\u5e8f\u8c03\u7528\uff0c\u76ee\u524d\u7248\u672c\u662fV2\uff0c\u6587\u6863\u6bd4\u8f83\u5c11\uff0c\u4ec5\u5728github\u4e2d\u6709\u4e2a\u5e2e\u52a9\u9875\u9762\u3002\u6211\u4eec\u8fd9\u91cc\u6574\u7406\u4e0b\u6700\u5e38\u7528\u7684\u51e0\u4e2a\u63a5\u53e3\u3002\u8c03\u8bd5\u5de5\u5177\u6211\u4f7f\u7528\u7684Postman\u3002 GET \/api\/v2\/alerts \u67e5\u8be2\u62a5\u8b66\u4fe1\u606f Query\u53c2\u6570\u5982\u4e0b\uff0c\u4ee5\u4e0b\u53c2\u6570\u7528\u6765\u8fc7\u6ee4\u544a\u8b66 \u7ed3\u679c\u5982\u4e0b [{ “annotations”: { “description”: “TCP_ESTAB\u6570\u5f02\u5e38 IS-PUSH-PRO-tcpserver-06: 445313”, “summary”: “TCP_ESTAB\u6570\u5f02\u5e38 IS-PUSH-PRO-tcpserver-06” }, “endsAt”: “2020-08-23T03:14:29.564Z”, “fingerprint”: “19a2d1b57b6f28ba”, “receivers”: [ { “name”: “pywebhook” } ], “startsAt”: “2020-08-23T00:25:14.564Z”, “status”: { “inhibitedBy”: [], “silencedBy”: [ “57bd377f-05b1-4016-9086-7318c298678e”, “757f69d8-8529-4ae3-b1f3-b9b750ba113f” ], “state”: “suppressed” }, “updatedAt”: “2020-08-23T11:11:31.711+08:00”, “generatorURL”: “https:\/\/prometheus.lpcsd.com\/graph?g0.expr=node_netstat_Tcp_CurrEstab%7Benv%3D%22PRO%22%7D+%3E+20000+and+abs%28node_netstat_Tcp_CurrEstab%7Benv%3D%22PRO%22%7D+-+node_netstat_Tcp_CurrEstab%7Benv%3D%22PRO%22%7D+offset+1d%29+%3E+20000&g0.tab=1”, “labels”: { “alertname”: “TCP_ESTAB\u6570\u5f02\u5e38”, “application”: “tcpserver”, “buniess”: “PRODUCT01”, […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[3],"tags":[190],"_links":{"self":[{"href":"https:\/\/c.ipcpu.com\/wp-json\/wp\/v2\/posts\/1523"}],"collection":[{"href":"https:\/\/c.ipcpu.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/c.ipcpu.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/c.ipcpu.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/c.ipcpu.com\/wp-json\/wp\/v2\/comments?post=1523"}],"version-history":[{"count":1,"href":"https:\/\/c.ipcpu.com\/wp-json\/wp\/v2\/posts\/1523\/revisions"}],"predecessor-version":[{"id":1524,"href":"https:\/\/c.ipcpu.com\/wp-json\/wp\/v2\/posts\/1523\/revisions\/1524"}],"wp:attachment":[{"href":"https:\/\/c.ipcpu.com\/wp-json\/wp\/v2\/media?parent=1523"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c.ipcpu.com\/wp-json\/wp\/v2\/categories?post=1523"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c.ipcpu.com\/wp-json\/wp\/v2\/tags?post=1523"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}