文档首页/ 应用服务网格 ASM/ 用户指南/ 用户指南(新版)/ 网格配置/ 升级/ 1.18升1.28 通过TelemetryAPI配置自定义指标
更新时间:2026-11-03 GMT+08:00
分享

1.18升1.28 通过TelemetryAPI配置自定义指标

操作场景

ASM从1.28版本开始使用Telemetry API管理Sidecar指标,1.18版本IOP中的自定义指标配置不会被继承,升级后将使用ASM预置的指标模板。

本节通过一个示例介绍如何通过Telemetry API配置自定义指标。您可根据需要自行准备Telemetry API配置文件,并在升级后应用到 CCE 集群中。

操作步骤

  1. 以下面的IOP中配置为例,该配置自定义了4个tag,并移除了2个tag:

    spec:
      values:    
        telemetry:
          enabled: true
          v2:
            enabled: true
            prometheus:
              configOverride:
                gateway:
                  http:
                    metrics:
                      - name: requests_total
                        dimensions: 
                          destination_cluster: upstream_peer.cluster_id
                          destination_port: string(upstream.port)
                          source_cluster: node.metadata['CLUSTER_ID']
                          source_pod: node.metadata['NAME']
                        tags_to_remove: 
                          - response_flags
                          - source_principal

  2. 与之对应的Telemetry API配置文件如下:

    apiVersion: telemetry.istio.io/v1
    kind: Telemetry
    metadata:
      name: custom-tag
      namespace: istio-system
    spec:
      metrics:
        - providers:
            - name: prometheus
          overrides:
            - match:
                metric: REQUEST_COUNT
                mode: CLIENT
              tagOverrides:
                destination_cluster:
                  value: filter_state.upstream_peer.cluster
                destination_port:
                  value: string(upstream.port)
                source_cluster:
                  value: xds.node.metadata['CLUSTER_ID']
                source_pod:
                  value: xds.node.metadata['NAME']
                response_flags:
                  operation: REMOVE
                source_principal:
                  operation: REMOVE

  3. 在 CCE 集群中执行以下命令,创建该配置:

    kubectl apply -f telemetry-custom-tag.yaml -n istio-system

参考资料

更多关于Telemetry API的说明,请参考Istio官方文档:Telemetry API - Metrics。

相关文档