欢迎使用API文档，如果您熟悉网络服务协议和一种以上编程语言，推荐您调用API管理您的资源和开发自己的应用程序。
本文档提供了API的描述、语法、参数说明及示例等内容。在调用API之前，请确保已经充分了解相关术语，详细信息请参见下表。
| 术语 | 说明 |
|---|---|
| 监控目标 | 监控目标是指平台各类服务直接或间接暴露的 /metrics 端点。Prometheus 通过这些端点定期抓取监控数据，生成时间序列持久化到数据库中。 |
| 监控数据 | 监控数据是指从监控目标收集到的各种指标和样本值。这些数据通常包含有关系统状态、性能、行为和活动的信息。 |
| 监控指标 | 监控指标 通常由一个唯一的标识符（称为指标名称）和一组键值对标签组成，例如： node_cpu_seconds_total{node_name=”node-1”, host_ip=”10.10.1.4”, mode=”idle”, cpu=”0”, …} 这些标签可以用于对指标进行更细粒度的分类和筛选，以便于更有效地监视和分析系统的运行状况。 |
| 监控样本 | 监控样本组成实际的时间序列数据，每个样本包括一个float64类型值和一个int64类型的毫秒精度的时间戳，例如： 1024.24 1709885997000 |
| 时间序列 | 给定的监控指标，再加上一组属于这个指标的监控样本，组成一条时间序列。 |
| 告警消息 | 告警消息由触发中的告警规则产生，提供实时和历史告警的状态、级别、详情、来源等信息，帮助用户快速实现故障定位与异常排查。 |
| 告警分组 | 告警分组是关联告警规则与告警订阅的载体，告警分组会将组内规则产生的告警消息发送至目标订阅终端。 |
| 告警规则 | 使用收集上来的监控指标，编写具有实际意义的告警表达式，再添加告警通知的具体内容，就形成了一条告警规则；每条告警规则属于一个告警分组。 |
| 告警订阅 | 告警订阅即通知渠道，支持设置邮件、企业微信、钉钉、飞书、Webhook类型的订阅终端，以接收已关联告警分组中的实时消息。 |
| 订阅终端 | 订阅终端即告警消息的某个接收方，例如：一条邮件地址，一个群机器人地址，一个Webhook URL；每个订阅终端属于一个告警订阅。 |
