规则管理

通过此服务,你可以通过将你的 Prometheus 配置文件复制到 GreptimeCloud 中轻松设置警报和记录规则。此外,可视化的图表将在控制台中自动生成,这些为监视应用程序提供了无缝体验。你可以访问 Prometheus 了解有关配置文件的更多详细信息。

通过 Git 管理规则文件

每个 GreptimeCloud 服务都带有一个 Git 仓库,用于存储 Prometheus 的规则和配置。GreptimeCloud 的 Prometheus 兼容规则引擎会根据存储在数据库中的数据适配你的规则,并在匹配时发出警报。

注意

Git 仓库中禁止创建分支或标签

下载模板

你可以在 GreptimeCloud 控制台 中获取仓库的 clone URL。

shell

  1. git clone <cloud-repo-url>

文件

在仓库中你可以看到这些文件:

shell

  1. .
  2. ├── README.md
  3. └── prometheus.yml

你可以在本地添加或修改文件,仅这些文件被允许使用:

  • prometheus.yml
  • README.md
  • <your rules> YAML files

prometheus.yml

prometheus.yml 文件负责管理全局和警报设置,请不要更改文件名称。文件内支持的字段如下所示,其他字段都会被丢弃:

yaml

  1. global:
  2. [ evaluation_interval: <duration> | default = 1m ]
  3. external_labels:
  4. [ <labelname>: <labelvalue> ... ]
  5. alerting:
  6. alert_relabel_configs:
  7. [ - <relabel_config> ... ]
  8. alertmanagers:
  9. [ - <alertmanager_config> ... ]

规则文件

你可以在根目录下添加自定义的 .yml 文件来添加规则配置。假设你有一个名为 alert.yml 的规则文件,其内容如下:

yaml

  1. groups:
  2. - name: example
  3. rules:
  4. - record: code:prometheus_http_requests_total:sum
  5. expr: sum by (code) (prometheus_http_requests_total)

该文件在目录中的位置如下:

shell

  1. .
  2. ├── README.md
  3. ├── alert.yml
  4. └── prometheus.yml

你可以添加任意数量的规则文件。

限制

  • 每个文件限制为 1MB,总仓库限制为 100MB
  • 每个文件必须是有效的 yaml 格式
  • 禁止创建目录

推送代码

在将 Prometheus 配置文件添加或复制到此仓库后,你可以将它们推送到 GreptimeCloud。

shell

  1. git add .

shell

  1. git commit -m "sync prometheus configuration"

shell

  1. git push

拉取代码

除了通过 Git 编辑配置文件外,你还可以通过 GreptimeCloud 控制台 对规则进行更改。 通过下方的命令即可拉取最新的配置文件:

shell

  1. git pull

可视化数据

将 Prometheus 配置文件推送到 GreptimeCloud 后,访问 GreptimeCloud 控制台,并点击 Prometheus Workbench。你可以看到基于你的配置文件自动生成的图表。

你还可以通过控制台添加新规则或编辑现有规则,这些更改将自动推送到仓库中。