概要

Datadog は、Istio 環境のあらゆる側面を監視するため、以下を実現できます。

• ログを使用して、Envoy および Istio の Control Plane の健全性を評価。
• リクエスト、帯域幅、リソース消費のメトリクスでサービスメッシュのパフォーマンスを詳しく確認。
• ネットワークパフォーマンスモニタリングで、コンテナ、ポッド、サービス間のネットワークコミュニケーションをメッシュ状にマッピング。
• [APM[2 でメッシュを実行してアプリケーションの分散型トレースの詳細を確認。

Istio 環境での Datadog の使用について、詳細はモニターのブログ記事をご参照ください。

セットアップ

コンテナ環境でのインテグレーション構成に関する一般的な説明は、Kubernetes での Autodiscovery を使用したインテグレーションの構成または Docker での Autodiscovery を使用したインテグレーションの構成を参照してください。

この OpenMetrics ベースのインテグレーションには、_最新_モード (use_openmetrics: true) と_レガシー_モード (use_openmetrics: false) があります。すべての最新機能を利用するために、Datadog は_最新_モードを有効にすることを推奨します。詳しくは、OpenMetrics ベースのインテグレーションにおける最新バージョニングとレガシーバージョニングを参照してください。

Istio メトリクスを収集する Datadog のインスタンスが複数ある場合は、すべてのインスタンスで同じモードを使用していることを確認してください。そうしないと、Datadog サイトでメトリクスデータが変動する可能性があります。

[OpenMetrics V1]、[OpenMetrics V2]、または [OpenMetrics V1 and V2] とマークされたメトリクスは、Istio インテグレーションの対応するモードでのみ利用可能です。Istio v1.5+ とマークされたメトリクスは Istio バージョン 1.5 以降で収集されます。

インストール

Istio は Datadog Agent に含まれています。Istio サーバーまたはクラスターに Datadog Agent をインストールし、Istio で Agent を指定します。

Envoy

Envoy プロキシ を Istioで監視する場合は、Envoy インテグレーションを構成します。

構成

メトリクスの収集

Istio v1.5+ で istio-proxy と istiod を監視するには、 Prometheus 形式のメトリクスを収集するための 2 つの重要なコンポーネントが必要です。

• データプレーン: istio-proxy サイドカーコンテナ
• コントロールプレーン: プロキシを管理する istiod サービス

これらはどちらも istio Agent チェックとして実行されますが、それぞれ異なる責任を持ち、別々に構成されます。

データプレーン構成

デフォルトの istio.d/auto_conf.yaml は、istio-proxy サイドカーコンテナごとに監視を自動的にセットアップします。Agent は、自動的に検出した各サイドカーコンテナに対してこのチェックを初期化します。この構成により、各サイドカーコンテナから公開されるデータの istio.mesh.* メトリクスをレポートすることができます。

インテグレーションのデータプレーン部分をカスタマイズするには

1. ホストに conf.d/istio.d/conf.yaml ファイルを作成します。このファイルには、以下が含まれる必要があります。

   ad_identifiers:
     - proxyv2
     - proxyv2-rhel8
   
   init_config:
   
   instances:
     - use_openmetrics: true
       send_histogram_buckets: true
       istio_mesh_endpoint: http://%%host%%:15020/stats/prometheus
       tag_by_endpoint: false
       exclude_labels:
         - source_version
         - destination_version
         - source_canonical_revision
         - destination_canonical_revision
         - source_principal
         - destination_principal
         - source_cluster
         - destination_cluster
         - source_canonical_service
         - destination_canonical_service
         - source_workload_namespace
         - destination_workload_namespace
         - request_protocol
         - connection_security_policy
   

2. 追加の構成があれば、このファイルをカスタマイズします。利用可能なすべての構成オプションについては、サンプルの istio.d/conf.yaml を参照してください。

3. ホスト の conf.d/ フォルダーをコンテナ化 Agent の conf/d フォルダーにマウントします。

別の構成方法については、Kubernetes での Autodiscovery を使用したインテグレーションの構成または Docker での Autodiscovery を使用したインテグレーションの構成を参照してください。

コントロールプレーン構成

Istio のコントロールプレーンを監視し、mixer、galley、pilot、citadel のメトリクスをレポートするには、istiod デプロイメントを監視するように Agent を構成する必要があります。Istio v1.5 以降では、istio-system ネームスペースにある istiod デプロイメントの以下のポッドアノテーションを適用してください。

ad.datadoghq.com/<CONTAINER_IDENTIFIER>.check_names: '["istio"]'
ad.datadoghq.com/<CONTAINER_IDENTIFIER>.init_configs: '[{}]'
ad.datadoghq.com/<CONTAINER_IDENTIFIER>.instances: |
     [
       {
         "istiod_endpoint": "http://%%host%%:15014/metrics",
         "use_openmetrics": "true"
       }
     ]     

<CONTAINER_IDENTIFIER> をコンテナの名前 (.spec.containers[i].name) に置き換えます。例えば、discovery とします。

これらのアノテーションの適用方法は、使用する Istio のデプロイメント戦略 (Istioctl、Helm、Operator) によって異なります。これらのポッドアノテーションを適用するための適切な方法については、Istio のドキュメントを参照してください。利用可能なすべての構成オプションについては、サンプルの istio.d/conf.yaml を参照してください。

Datadog Agent ポッドのサイドカーインジェクションを無効化

コンテナに Datadog Agent をインストールする場合は、その前に Istio のサイドカーインジェクションを無効にすることをお勧めします。

Istio バージョン >= 1.10:

sidecar.istio.io/inject: "false" ラベルを datadog-agent DaemonSet に追加します。

# (...)
spec:
  template:
    metadata:
      labels:
        sidecar.istio.io/inject: "false"
    # (...)

これは、kubectl patch コマンドでも実行できます。

kubectl patch daemonset datadog-agent -p '{"spec":{"template":{"metadata":{"labels":{"sidecar.istio.io/inject":"false"}}}}}'

Istio バージョン <= 1.9:

sidecar.istio.io/inject: "false" アノテーションを datadog-agent DaemonSet に追加します。

# (...)
spec:
  template:
    metadata:
      annotations:
        sidecar.istio.io/inject: "false"
    # (...)

kubectl patch コマンドを使用します。

kubectl patch daemonset datadog-agent -p '{"spec":{"template":{"metadata":{"annotations":{"sidecar.istio.io/inject":"false"}}}}}'

ログ収集

Agent バージョン 6.0 以降で利用可能

まず、 Kubernetes でログ収集を実行するために Datadog Agent を有効にします。Kubernetes ログ収集を参照してください。

Istio のログ

Istio のログを収集するには、 Istio コンテナが実行しているポッドに以下のアノテーションを適用します。

ad.datadoghq.com/<CONTAINER_IDENTIFIER>.logs: |
     [
       {
         "source": "istio",
         "service": "<SERVICE_NAME>"
       }
     ]     

<CONTAINER_IDENTIFIER> をコンテナの名前 (.spec.containers[i].name) に置き換えます。 <SERVICE_NAME> は Istio のサービス名に置き換えてください。

Envoy のアクセスログ

Envoy のアクセスログを収集するには

1. Envoy インテグレーションがインストールされていることを確認します。
2. Envoy が実行しているポッドに以下のアノテーションを適用します。

ad.datadoghq.com/<CONTAINER_IDENTIFIER>.logs: |
     [
       {
         "type": "file",
         "path": "/var/log/envoy.log",
         "source": "envoy"
       }
     ]     

<CONTAINER_IDENTIFIER> をコンテナの名前 (.spec.containers[i].name) に置き換えます。

検証

Agent の info サブコマンドを実行し、Checks セクションで istio を探します。

収集データ

メトリクス

イベント

Istio チェックには、イベントは含まれません。

サービスチェック

istio.prometheus.health
Returns CRITICAL if the check cannot access the metrics endpoint. Returns OK otherwise.
Statuses: ok, critical

istio.openmetrics.health
Returns CRITICAL if the Agent is unable to connect to the OpenMetrics endpoint, otherwise returns OK.
Statuses: ok, critical

istio.pilot.prometheus.health
Returns CRITICAL if the check cannot access the metrics endpoint. Returns OK otherwise.
Statuses: ok, critical

istio.galley.prometheus.health
Returns CRITICAL if the check cannot access the metrics endpoint. Returns OK otherwise.
Statuses: ok, critical

istio.citadel.prometheus.health
Returns CRITICAL if the check cannot access the metrics endpoint. Returns OK otherwise.
Statuses: ok, critical

トラブルシューティング

無効なチャンク長のエラー

Istio インテグレーション (Istio インテグレーションバージョン 3.13.0 以前) のレガシーモードで以下のエラーが表示された場合

  Error: ("Connection broken: InvalidChunkLength(got length b'', 0 bytes read)",
  InvalidChunkLength(got length b'', 0 bytes read))

このエラーを解決するには、OpenMetrics ベースの Istio インテグレーションの最新モードを使用できます。

最低でも Agent 7.31.0 と Python 3 にアップグレードする必要があります。OpenMetrics を有効にするには、構成のセクションを参照してください。

Istio のデプロイメントで一般的な OpenMetrics インテグレーションを使用する

Istio のプロキシサイドカーインジェクションが有効な場合、istio_mesh_endpoint と同じメトリクスエンドポイントで OpenMetrics インテグレーションを使用して他の Prometheus メトリクスを監視すると、カスタムメトリクス使用量が多く、メトリクス収集が二重になることがあります。

OpenMetrics の構成により、メトリクスの収集が重複しないようにするためには、以下のどちらかを行います。

1. 構成オプション metrics で特定のメトリクスのマッチングを使用するか、または
2. metrics にワイルドカード * 値を使用する場合、以下の OpenMetrics インテグレーションオプションを使用して、Istio および Envoy インテグレーションで既にサポートされているメトリクスを除外することを検討します。

汎用的なメトリクス収集を使用した OpenMetrics の最新モード構成

カスタムメトリクスの高額請求を避けるため、必ず Istio と Envoy のメトリクスを構成から除外してください。openmetrics_endpoint が有効になっている場合は exclude_metrics を使用します。

## 各インスタンスは、他のインスタンスとは独立してスケジュールされます。
#
instances:
  - openmetrics_endpoint: <OPENMETRICS_ENDPOINT>
    metrics: [*]
    exclude_metrics:
      - istio_*
      - envoy_*

汎用的なメトリクス収集を使用した OpenMetrics のレガシーモード構成

カスタムメトリクスの高額請求を避けるため、必ず Istio と Envoy のメトリクスを構成から除外してください。prometheus_url が有効になっている場合は ignore_metrics を使用します。

instances:
  - prometheus_url: <PROMETHEUS_URL>
    metrics:
      - *
    ignore_metrics:
      - istio_*
      - envoy_*

ご不明な点は、Datadog のサポートチームまでお問合せください。

その他の参考資料

お役に立つドキュメント、リンクや記事:

• Datadog を使用した Istio サービスメッシュの監視
• Datadog でキーメトリクスを収集して Istio を監視する方法
• Datadog を使用した Istio の監視方法