创建Prometheus告警策略

1. 接口描述

接口请求域名： monitor.tencentcloudapi.com 。

创建 Prometheus 告警策略(将逐步废弃，建议使用 CreatePrometheusAlertGroup 创建告警策略)

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 新增告警

新增告警

输入示例

POST / HTTP/1.1
Host: monitor.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreatePrometheusAlertPolicy
<公共请求参数>

{
    "InstanceId": "prom-kshrsdf",
    "AlertRule": {
        "Id": "alert-odhjeg",
        "Name": "资源告警",
        "TemplateId": "temp-cjhger",
        "Notification": {
            "Enabled": true,
            "Type": "amp",
            "WebHook": "",
            "AlertManager": {
                "ClusterType": "eks",
                "ClusterId": "cls-ojeg",
                "Url": "http://10.0.0.1:9000"
            },
            "RepeatInterval": "5m",
            "TimeRangeStart": "00:00:00",
            "TimeRangeEnd": "23:59:59",
            "NotifyWay": [
                "wechat"
            ],
            "ReceiverGroups": [
                "skjehrsheb"
            ],
            "PhoneNotifyOrder": [
                1
            ],
            "PhoneCircleTimes": 0,
            "PhoneInnerInterval": 0,
            "PhoneCircleInterval": 0,
            "PhoneArriveNotice": true
        },
        "Rules": [
            {
                "Annotations": [
                    {
                        "Name": "summary",
                        "Value": "磁盘使用率过高"
                    }
                ],
                "Describe": "",
                "For": "2m",
                "Labels": [
                    {
                        "Name": "severity",
                        "Value": "warning"
                    }
                ],
                "Name": "磁盘使用率过高",
                "Rule": "1- node_filesystem_avail_bytes  / node_filesystem_size_bytes > 0.85",
                "RuleState": 0,
                "Template": "磁盘使用率过高，实例: {{$labels.instance}}，ID: {{$labels.instance_id}}，当前值: {{ $value | humanizePercentage }}。"
            }
        ],
        "UpdatedAt": "2024-07-15T16:46:42+08:00",
        "ClusterId": "cls-iehgr"
    }
}

输出示例

{
    "Response": {
        "Id": "alert-ojnfb",
        "RequestId": "ac-khgr-iohvr"
    }
}

示例2 添加告警策略，告警渠道为Alertmanager

添加告警策略，告警渠道为Alertmanager

输入示例

POST / HTTP/1.1
Host: monitor.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreatePrometheusAlertPolicy
<公共请求参数>

{
    "InstanceId": "prom-kshrsdf",
    "AlertRule": {
        "Id": "alert-odhjeg",
        "Name": "资源告警",
        "TemplateId": "temp-cjhger",
        "Notification": {
            "AlertManager": {
                "ClusterId": "cls-ksjbr",
                "ClusterType": "eks",
                "Url": "http://10.0.0.1:9000/api/v1/alerts"
            },
            "Enabled": true,
            "NotifyWay": null,
            "PhoneArriveNotice": false,
            "PhoneCircleInterval": 0,
            "PhoneCircleTimes": 0,
            "PhoneInnerInterval": 0,
            "PhoneNotifyOrder": null,
            "ReceiverGroups": null,
            "RepeatInterval": "5m",
            "TimeRangeEnd": "23:59:59",
            "TimeRangeStart": "00:00:00",
            "Type": "alertmanager",
            "WebHook": ""
        },
        "Rules": [
            {
                "Annotations": [
                    {
                        "Name": "summary",
                        "Value": "MySQL High CPU Usage"
                    }
                ],
                "Describe": "",
                "For": "5m",
                "Labels": [
                    {
                        "Name": "severity",
                        "Value": "warning"
                    }
                ],
                "Name": "MySQL High CPU Usage",
                "Rule": "avg by (instance_id,cluster_id,instance_region) (qce_cynosdb_mysql_cpuuserate_max) > 85",
                "RuleState": 0,
                "Template": "MySQL cpu usage is higher than 85%. Instance ID: {{ $labels.instance_id }}, cluster ID: {{ $labels.cluster_id }}, region: {{ $labels.instance_region }}"
            }
        ],
        "ClusterId": "cls-iehgr"
    }
}

输出示例

{
    "Response": {
        "Id": "alert-xxx",
        "RequestId": "3dfe620f-11b8-4301-b279-1fdadedf7a59"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。