遥测

遥测定义了如何在网格内为工作负载生成遥测。

对于网格级配置，请将资源放在 Istio 安装的根配置命名空间中，*无需* 工作负载选择器。

对于任何命名空间，包括根配置命名空间，只能有一个没有工作负载选择器的 Telemetry 资源。

对于具有工作负载选择器的资源，只能有一个资源选择任何给定的工作负载。

Telemetry 配置的层次结构如下

1. 特定于工作负载的配置
2. 特定于命名空间的配置
3. 根命名空间配置

示例

启用 10% 流量的随机采样的策略

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
  name: mesh-default
  namespace: istio-system
spec:
  # no selector specified, applies to all workloads
  tracing:
  - randomSamplingPercentage: 10.00

为 foo 工作负载禁用跟踪报告的策略（注意：跟踪上下文仍将传播）

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
  name: foo-tracing
  namespace: bar
spec:
  selector:
    matchLabels:
      service.istio.io/canonical-name: foo
  tracing:
  - disableSpanReporting: true

选择备用 Zipkin 提供程序用于跟踪报告的策略

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
  name: foo-tracing-alternate
  namespace: baz
spec:
  selector:
    matchLabels:
      service.istio.io/canonical-name: foo
  tracing:
  - providers:
    - name: "zipkin-alternate"
    randomSamplingPercentage: 10.00

仅从客户端工作负载采样跟踪的 Zipkin 提供程序定制策略

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
  name: mesh-default
  namespace: istio-system
spec:
  # no selector specified, applies to all workloads
  tracing:
  - match: CLIENT
  - providers:
    - name: "zipkin"

从字面值添加自定义标签的策略

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
  name: mesh-default
  namespace: istio-system
spec:
  # no selector specified, applies to all workloads
  tracing:
  - randomSamplingPercentage: 10.00
    customTags:
      my_new_foo_tag:
        literal:
          value: "foo"

禁用整个网格的 Prometheus 服务器端指标的策略

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
  name: mesh-default
  namespace: istio-system
spec:
  # no selector specified, applies to all workloads
  metrics:
  - providers:
    - name: prometheus
    overrides:
    - match:
        metric: ALL_METRICS
        mode: SERVER
      disabled: true

为foo命名空间的所有 Prometheus 指标添加维度的策略

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
  name: namespace-metrics
  namespace: foo
spec:
  # no selector specified, applies to all workloads in the namespace
  metrics:
  - providers:
    - name: prometheus
    overrides:
    # match clause left off matches all istio metrics, client and server
    - tagOverrides:
        request_method:
          value: "request.method"
        request_host:
          value: "request.host"

从bar.foo工作负载的一些 Prometheus 指标中删除response_code维度的策略

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
  name: remove-response-code
  namespace: foo
spec:
  selector:
    matchLabels:
      service.istio.io/canonical-name: bar
  metrics:
  - providers:
    - name: prometheus
    overrides:
    - match:
        metric: REQUEST_COUNT
      tagOverrides:
        response_code:
          operation: REMOVE
    - match:
        metric: REQUEST_DURATION
      tagOverrides:
        response_code:
          operation: REMOVE
    - match:
        metric: REQUEST_SIZE
      tagOverrides:
        response_code:
          operation: REMOVE
    - match:
        metric: RESPONSE_SIZE
      tagOverrides:
        response_code:
          operation: REMOVE

为整个网格启用访问日志记录的策略

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
  name: mesh-default
  namespace: istio-system
spec:
  # no selector specified, applies to all workloads
  accessLogging:
  - providers:
    - name: envoy
    # By default, this turns on access logging (no need to set `disabled: false`).
    # Unspecified `disabled` will be treated as `disabled: false`, except in
    # cases where a parent configuration has marked as `disabled: true`. In
    # those cases, `disabled: false` must be set explicitly to override.

禁用foo命名空间的访问日志记录的策略

apiVersion: telemetry.istio.io/v1
kind: Telemetry
metadata:
  name: namespace-no-log
  namespace: foo
spec:
  # no selector specified, applies to all workloads in the namespace
  accessLogging:
  - disabled: true

遥测

跟踪

ProviderRef

指标

MetricSelector

MetricsOverrides

访问日志记录

Tracing.TracingSelector

Tracing.CustomTag

Tracing.Literal

Tracing.Environment

Tracing.RequestHeader

MetricsOverrides.TagOverride

AccessLogging.LogSelector

AccessLogging.Filter

MetricSelector.IstioMetric

MetricsOverrides.TagOverride.Operation

WorkloadMode