Prometheus学习系列（二十六）之集成

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

一、标志

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，请使用相关的存储适配器。

二、Alertmanager服务发现

在Prometheus 1.4中引入了Alertmanager服务发现，允许Prometheus使用与刮擦目标相同的机制动态发现Alertmanager复制品。在Prometheus 2.0中，已删除静态Alertmanager配置的命令行标志，因此以下命令行标志：

./prometheus -alertmanager.url=http://alertmanager:9093/

将在prometheus.yml配置文件中替换为以下内容：

alerting:
  alertmanagers:
  - static_configs:
    - targets:
      - alertmanager:9093

您还可以在Alertmanager配置中使用所有常用的Prometheus服务发现集成和重新标记。此代码段指示Prometheus使用name: alertmanger：alertmanager和非空端口在default命名空间中搜索Kubernetes pod。

alerting:
  alertmanagers:
  - kubernetes_sd_configs:
      - role: pod
    tls_config:
      ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
    bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
    relabel_configs:
    - source_labels: [__meta_kubernetes_pod_label_name]
      regex: alertmanager
      action: keep
    - source_labels: [__meta_kubernetes_namespace]
      regex: default
      action: keep
    - source_labels: [__meta_kubernetes_pod_container_port_number]
      regex:
      action: drop

三、记录规则和报警

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

job:request_duration_seconds:histogram_quantile99 =
  histogram_quantile(0.99, sum(rate(request_duration_seconds_bucket[1m])) by (le, job))

ALERT FrontendRequestLatency
  IF job:request_duration_seconds:histogram_quantile99{job="frontend"} > 0.1
  FOR 5m
  ANNOTATIONS {
    summary = "High frontend request latency",
  }

看起来像这样：

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

为了帮助进行更改，promtool工具具有自动执行规则转换的模式。给定.rules文件，它将以新格式输出.rules.yml文件。例如：

$ promtool update rules example.rules

请注意，您需要使用2.0中的promtool，而不是1.8。

四、存储

Prometheus 2.0中的数据格式已完全改变，并且不向后兼容1.8。为了保持对历史监控数据的访问，我们建议您运行至少与Prometheus 2.0实例并行运行至少版本1.8.1的非刮擦Prometheus实例，并让新服务器通过远程读取协议从旧服务器读取现有数据。

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

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

然后可以使用以下标志启动Prometheus 2.0（在同一台机器上）：

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

除了完整的现有配置之外，prometheus.yml还包含哪些节：

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

五、PromQL

从PromQL中删除了以下功能：

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

有关详细信息，请参阅issue＃3060。

六、杂项

6.1 普罗米修斯非root用户

Prometheus Docker镜像现在可以作为非root用户运行Prometheus。如果您希望Prometheus UI / API侦听低端口号（例如，端口80），则需要覆盖它。对于Kubernetes，您将使用以下YAML：

apiVersion: v1
kind: Pod
metadata:
  name: security-context-demo-2
spec:
  securityContext:
    runAsUser: 0
...

有关更多详细信息，请参阅为Pod或容器配置安全上下文。

如果您使用的是Docker，则会使用以下代码段：

docker run -u root -p 80:80 prom/prometheus:v2.0.0-rc.2  --web.listen-address :80

6.2 普罗米修斯生命周期

如果您使用Prometheus /-/reload加载HTTP端点在更改时自动重新加载Prometheus配置，则出于安全原因，默认情况下会禁用这些端点，这是Prometheus 2.0中的。要启用它们，请设置--web.enable-lifecycle标志。

七、链接

Prometheus官网地址：https://prometheus.io/
我的Github：https://github.com/Alrights/prometheus