Prometheus 2.0 迁移指南

秉承我们稳定性承诺，Prometheus 2.0 版本包含许多向后不兼容的更改。本文档提供了从 Prometheus 1.8 迁移到 Prometheus 2.0 的指南。

' class="reference-link">

标志

Prometheus 命令行标志的格式已经更改。现在所有标志不再使用单破折号，而是使用双破折号。通用标志(--config.file, --web.listen-address和--web.external-url)仍然相同，但除此之外，几乎所有与存储的标志都已删除。

一些值的注意的标志已被删除：

  • -alertmanager.url 在 Prometheus 2.0 中，用于静态配置 Alertmanager 的 URL 命令行标志已被删除。现在必须通过服务发现来发现 Alertmanager。请参阅 Alertmanager 服务发现。
  • -log.format 在 Prometheus 2.0 中，日志只能流式传输到标准输出。
  • -query.staleness-delta已重命名为--query.lookback-delta；Prometheus 2.0 引入了一种新的处理陈旧性的机制，请参见陈旧性
  • -storage.local.* Prometheus 2.0 引入了新的存储引擎，因为与旧引擎有关的标志都已删除。有关新引擎的信息，请参阅存储部分。
  • -storage.remote.* Prometheus 2.0 删除了已经废弃的远程存储标志。如果指定了它们将无法启动。要写入 InfluxDB, Graphite 或 OpenTSDB 远程存储，请使用相关的存储适配器。
' class="reference-link">

Alertmanager 服务发现

Prometheus 1.4 中引入了 Alertmanager 服务发现机制，这使得 Prometheus 可以使用与采集数据相同的机制来动态发现 Alertmanager 副本。在 Prometheus 2.0，静态 Alertmanager 配置的命令行标志已删除，因此命令行标志./prometheus -alertmanager.url=http://alertmanager:9093/将与prometheus.yml配置文件中改为：

  1. alerting:
  2.   alertmanagers:
  3.   - static_configs:
  4.     - targets:
  5.       - alertmanager:9093

您还可以在 alertmanager 配置中使用所有常规的 Prometheus 服务发现集成组件和标签重新标记过程。该代码片段指示 Prometheus 在default名称空间中搜索标签为name: alertmanager且具有非空端口的 Kubernetes pods.

  1. alerting:
  2.   alertmanagers:
  3.   - kubernetes_sd_configs:
  4.       - role: pod
  5.     tls_config:
  6.       ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
  7.     bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
  8.     relabel_configs:
  9.     - source_labels: [__meta_kubernetes_pod_label_name]
  10.       regex: alertmanager
  11.       action: keep
  12.     - source_labels: [__meta_kubernetes_namespace]
  13.       regex: default
  14.       action: keep
  15.     - source_labels: [__meta_kubernetes_pod_container_port_number]
  16.       regex:
  17.       action: drop
' class="reference-link">

记录规则和告警规则

告警规则和记录规则的配置格式已更改为 YAML。旧的格式的记录规则和告警规则示例：

  1. job:request_duration_seconds:histogram_quantile99 =
  2.   histogram_quantile(0.99, sum(rate(request_duration_seconds_bucket[1m])) by (le, job))
  4. ALERT FrontendRequestLatency
  5.   IF job:request_duration_seconds:histogram_quantile99{job="frontend"} > 0.1
  6.   FOR 5m
  7.   ANNOTATIONS {
  8.     summary = "High frontend request latency",
  9.   }

将被修改为如下格式：

  1. groups:
  2. - name: example.rules
  3.   rules:
  4.   - record: job:request_duration_seconds:histogram_quantile99
  5.     expr: histogram_quantile(0.99, sum(rate(request_duration_seconds_bucket[1m]))
  6.       BY (le, job))
  7.   - alert: FrontendRequestLatency
  8.     expr: job:request_duration_seconds:histogram_quantile99{job="frontend"} > 0.1
  9.     for: 5m
  10.     annotations:
  11.       summary: High frontend request latency

为了帮助更改，promtool工具提供了一种自动转换规则的方法。给定一个.rules文件，它将输出新格式的.rules.yml。如：

  1. $ promtool update rules example.rules

请注意，您需要使用 2.0 版而非 1.8 版的 promtool。

' class="reference-link">

存储

Prometheus 2.0 中的数据格式已完全更改，并与 1.8 版本不向后兼容。为了保留对历史监控数据的访问权限，我们建议您运行一个没有采集数据的 1.8.1 版本以上的 Prometheus 实例与 2.0 版本的 Prometheus 实例并行运行，并让新服务通过远程读取协议从旧服务读取现有数据。

您的 1.8 版本的 Prometheus 实例应使用以下标志和仅包含external_labels设置(如果有)的配置文件启动：

  1. $ ./prometheus-1.8.1.linux-amd64/prometheus -web.listen-address ":9094" -config.file old.yml

然后可以使用以下标志(在同一台计算机上)启动 Prometheus 2.0 实例：

  1. $ ./prometheus-2.0.0.linux-amd64/prometheus --config.file prometheus.yml

除了完整的已存在的配置外，prometheus.yml还包含以下部分：

  1. remote_read:
  2.   - url: "http://localhost:9094/api/v1/read"

promQL

以下功能已从 promQL 中删除：

  • drop_common_labels函数 - 应该使用without聚合修饰符
  • keep_common聚合修饰符 - 应该是用by修饰符
  • count_scalar函数 - absent()函数或在操作中正确传播标签可以更好地处理用例

有关更多详细信息，请参见 issue #3060。

' class="reference-link">

杂项

' class="reference-link">

非 root 用户运行 Prometheus

Prometheus Docker 镜像现在构建为非 root 用户运行 Prometheus。如果您希望 Prometheus UI/API 在低端口号(如 80 端口)上监听，则需要重写它。对于 Kubernetes，您可以使用如下 YAML：

  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4.   name: security-context-demo-2
  5. spec:
  6.   securityContext:
  7.     runAsUser: 0
  8. ...

更多详细信息，详见为 Pod 或容器配置安全上下文

如果使用 Docker，将使用如下代码：

  1. docker run -u root -p 80:80 prom/prometheus:v2.0.0-rc.2  --web.listen-address :80
' class="reference-link">

Prometheus 生命周期

如果您使用 Prometheus /-/reload HTTP 端点在更改时自动重载 Prometheus 配置，出于安全原因在 Prometheus 2.0 默认禁用这些端点。要启用它们，设置--web.enable-lifecycl标志。