テレメトリ

Telemetry は、メッシュ内のワークロードに対してテレメトリがどのように生成されるかを定義します。

メッシュレベルの設定については、ワークロードセレクタ *なし* で、Istio インストールのルート設定ネームスペースにリソースを配置します。

ルート設定ネームスペースを含む任意のネームスペースでは、ワークロードセレクタのない Telemetry リソースは1つだけ有効です。

ワークロードセレクタを持つリソースの場合、任意のワークロードを選択するリソースは1つだけ有効です。

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

AccessLogging

Tracing.TracingSelector

Tracing.CustomTag

Tracing.Literal

Tracing.Environment

Tracing.RequestHeader

MetricsOverrides.TagOverride

AccessLogging.LogSelector

AccessLogging.Filter

MetricSelector.IstioMetric

MetricsOverrides.TagOverride.Operation

WorkloadMode