进阶 docs.flagger.app 2026-11-21 03:00:57 · 7 阅读

第7章 Flagger 指标分析

Metric Analysis

在分析过程中,Flagger 可以验证服务水平目标(SLO),例如可用性、错误率百分比、平均响应时间以及基于应用特定指标的其他目标。如果在 SLO 分析期间发现性能下降,发布将自动回滚,从而将对最终用户的影响降到最低。

内置指标

Flagger 自带两项内置指标检查:HTTP 请求成功率和持续时间。

analysis:
    metrics:
    - name: request-success-rate
      interval: 1m
      # 最小请求成功率(非 5xx 响应)
      # 百分比 (0-100)
      thresholdRange:
        min: 99
    - name: request-duration
      interval: 1m
      # 最大请求持续时间 P99
      # 毫秒
      thresholdRange:
        max: 500

对于每个指标,你可以使用 thresholdRange 指定可接受的值域,使用 interval 设置窗口大小或时间序列。这些内置检查适用于所有服务网格和 Ingress 控制器,并通过 Prometheus 查询实现。

自定义指标

金丝雀分析可以通过自定义指标检查进行扩展。使用 MetricTemplate 自定义资源,你可以配置 Flagger 连接到指标提供商,并运行一个返回 float64 值的查询。查询结果用于根据指定的阈值范围来验证金丝雀版本。

查询模板中可用的变量包括:

  • name (canary.metadata.name)
  • namespace (canary.metadata.namespace)
  • target (canary.spec.targetRef.name)
  • service (canary.spec.service.name)
  • ingress (canary.spec.ingresRef.name)
  • interval (canary.spec.analysis.metrics[].interval)
  • variables (canary.spec.analysis.metrics[].templateVariables)

金丝雀分析指标可以通过 templateRef 引用模板: 金丝雀分析指标也可以通过 templateVariables 引用一组自定义变量。这些变量随后会注入到金丝雀分析期间引用的 MetricTemplate 对象中定义的查询中:

Prometheus

通过将提供商类型设置为 prometheus 并编写 PromQL 查询,你可以创建针对 Prometheus 服务器的自定义指标检查。

Prometheus 模板示例: 在金丝雀分析中引用该模板: 上述配置通过检查 HTTP 404 req/sec 百分比是否低于总流量的 5% 来验证金丝雀版本。如果 404 率达到 5% 的阈值,则金丝雀失败。

Prometheus gRPC 错误率示例: 上述模板适用于使用 go-grpc-prometheus 插桩的 gRPC 服务。

Prometheus 身份验证 如果你的 Prometheus API 需要基本身份验证,你可以在与 MetricTemplate 相同的命名空间中创建包含 basic-auth 凭据的 secret: 或者如果你需要 bearer token 身份验证(通过 SA token): 然后在 MetricTemplate 中引用该 secret:

Datadog

你可以使用 Datadog 提供商创建自定义指标检查。

创建一个包含你的 Datadog API 凭据的 secret: Datadog 模板示例: 在金丝雀分析中引用该模板: Datadog 速率限制 在较大的部署环境中,你可能会遇到 Datadog API 的速率限制。为了避免这种情况,你可以使用 Datadog Cluster Agent 批量获取指标。它随后将这些指标作为外部指标服务器暴露出来。

参见 Datadog 文档。 一旦你启用了 Datadog 的外部指标端点和 DatadogMetric CRD(不一定需要使用 registerAPIService),你就可以使用 Flagger 的外部指标提供商从那里查询指标。 服务器地址通常是 datadog-cluster-agent-metrics-server,并在端口 8443 上暴露。ExternalMetrics 的名称格式为 datadogmetric@<namespace>:<metricname>,例如 datadogmetric@istio-system:istio-mesh-request-count。

Amazon CloudWatch

你可以使用 CloudWatch 指标提供商创建自定义指标检查。

CloudWatch 模板示例: 查询格式文档可在此处找到。 在金丝雀分析中引用该模板: 注意:Flagger 需要 AWS IAM 权限来执行 cloudwatch:GetMetricData 才能使用此提供商。

New Relic

你可以使用 New Relic 提供商创建自定义指标检查。

创建一个包含你的 New Relic Insights 凭据的 secret: New Relic 模板示例: 在金丝雀分析中引用该模板:

Graphite

你可以使用 Graphite 提供商创建自定义指标检查。

Graphite 模板示例: 在金丝雀分析中引用该模板: Graphite 身份验证 如果你的 Graphite API 需要基本身份验证,你可以在与 MetricTemplate 相同的命名空间中创建包含 basic-auth 凭据的 secret: 然后,在 MetricTemplate 中引用该 secret:

Google Cloud Monitoring (Stackdriver)

在你的集群上启用 Workload Identity,创建一个对 Cloud Monitoring API 具有读访问权限的服务账号密钥,然后在 GCP 服务账号和 Kubernetes 上的 Flagger 服务账号之间创建 IAM 策略绑定。你可以参考此指南。

为 flagger 服务账号添加注解 或者,你可以下载 json 密钥并将其添加到你的 secret 中,键名为 serviceAccountKey(不推荐此方法)。 创建一个包含你的 project-id 的 secret(如果集群未启用 workload identity,则还需包含你的服务账号 json)。 然后在指标模板中引用该 secret。注意:这里使用的特定 MQL 查询在 GKE 上安装 Istio 时有效。 查询语言的参考文档可在此处找到

InfluxDB

InfluxDB 提供商使用 flux 查询语言。

创建一个包含你的身份验证令牌的 secret,你可以在 InfluxDB UI 中找到该令牌。 然后在指标模板中引用该 secret。 注意:这里使用的特定 MQL 查询在 GKE 上安装 Istio 时有效。

Dynatrace

你可以使用 Dynatrace 提供商创建自定义指标检查。

创建一个包含你的 Dynatrace 令牌的 secret: Dynatrace 指标模板示例: 在金丝雀分析中引用该模板:

Keptn

你可以使用 Keptn 提供商创建自定义指标检查。此提供商允许验证单个 KeptnMetric 的值(代表单个指标的值),或者 Keptn Analysis(它提供灵活的评分逻辑来分析并优先处理来自不同数据源的多个不同指标值)。 此提供商要求集群中已安装 Keptn。

Keptn 指标模板示例: 这将引用命名空间 my-namespace 中名为 response-time 的 KeptnMetric,其可能看起来像以下这样: 该查询包含以下组件,由 / 字符分隔:

  • type(必需):必须是 keptnmetric 或 analysis。
  • namespace(必需):引用的 KeptnMetric/AnalysisDefinition 的命名空间。
  • resource-name(必需):引用的 KeptnMetric/AnalysisDefinition 的名称。
  • timeframe(可选):用于 Analysis 的时间段。这通常设置为与 Canary 的分析间隔相同的值。仅当 type 设置为 analysis 时相关。
  • arguments(可选):传递给 Analysis 的参数。参数作为键值对列表传递,由 ; 字符分隔,例如 foo=bar;bar=foo。仅当 type 设置为 analysis 时相关。

对于 type 为 analysis 的情况,提供商返回的值要么是 0(如果分析失败),要么是 1(分析通过)。

Splunk

你可以使用 Splunk 提供商创建自定义指标检查。

创建一个包含你的身份验证令牌的 secret,你可以在 Splunk o11y UI 中找到该令牌。 Splunk 模板示例: 查询格式文档可在此处找到。 在金丝雀分析中引用该模板:

Kubernetes External Metrics

你可以查询实现 Kubernetes External Metrics API 的外部指标提供商。

默认情况下,Flagger 将使用其绑定的 Service Account 进行身份验证。可选地,你可以通过 Secret 提供 Bearer token(该 Secret 必须包含一个名为 token 的字段): External Metrics 模板示例:

Previous Deployment Strategies Next Webhooks Last updated 6 months ago

评论 (0)