Kubernetes API サーバーメトリクス

Supported OS Linux Windows Mac OS

インテグレーションバージョン6.2.0

Kubernetes API Server ダッシュボード

概要

このチェックは Kube_apiserver_metrics を監視します。

セットアップ

インストール

Kube_apiserver_metrics チェックは Datadog Agent パッケージに含まれているため、サーバーに追加でインストールする必要はありません。

構成

Kubernetes クラスターにマスターノードがあり、kube-apiserver イメージのポッドとコンテナが実行されている場合、Datadog Agent はこのポッドを自動的に検出し、その kube_apiserver_metrics.d/auto_conf.yaml ファイルに基づいてインテグレーションを構成します。

しかし、GKE、EKS、AKS のようなマネージド Kubernetes ディストリビューションを使用している場合、Agent が検出できる実行中の kube-apiserver ポッドが存在しないかもしれません。

この場合、default ネームスペースの kubernetes サービスに対してインテグレーションを設定できます。

パラメーター値
<INTEGRATION_NAME>["kube_apiserver_metrics"]
<INIT_CONFIG>[{}]
<INSTANCE_CONFIG>[{"prometheus_url": "https://%%host%%:%%port%%/metrics"}]

利用可能なすべての構成オプションは、kube_apiserver_metrics.yaml で確認できます。

サービスへのアノテーション

default ネームスペース内の kubernetes サービスに次のアノテーションを付加できます。

    ad.datadoghq.com/endpoints.checks: |
  {
    "kube_apiserver_metrics": {
      "instances": [
        {
          "prometheus_url": "https://%%host%%:%%port%%/metrics"
        }
      ]
    }
  }   

    annotations:
  ad.datadoghq.com/endpoints.check_names: '["kube_apiserver_metrics"]'
  ad.datadoghq.com/endpoints.init_configs: '[{}]'
  ad.datadoghq.com/endpoints.instances:
    '[{ "prometheus_url": "https://%%host%%:%%port%%/metrics"}]'

    これで、Datadog Cluster Agent は、各エンドポイントのチェックを Datadog Agent にスケジューリングします。

    ローカルファイル

    また、エンドポイントを直接 kube_apiserver_metrics.yaml ファイルに構成し、Agent の構成ディレクトリのルートにある conf.d/ フォルダーに配置してクラスターチェックとして実行することもできます。

    注: ローカルファイルや ConfigMap を使用してクラスターチェックを構成する場合、コンフィギュレーションファイルに cluster_check: true を追加する必要があります。

    クラスターチェックを設定するために、Cluster Agent に構成を提供します。

      clusterAgent:
  confd:
    kube_apiserver_metrics.yaml: |-
      advanced_ad_identifiers:
        - kube_endpoints:
            name: "kubernetes"
            namespace: "default"
      cluster_check: true
      init_config:
      instances:
        - prometheus_url: "https://%%host%%:%%port%%/metrics"      

      spec:
#(...)
  override:
    clusterAgent:
      extraConfd:
        configDataMap:
          kube_apiserver_metrics.yaml: |-
            advanced_ad_identifiers:
              - kube_endpoints:
                  name: "kubernetes"
                  namespace: "default"
            cluster_check: true
            init_config:
            instances:
              - prometheus_url: "https://%%host%%:%%port%%/metrics"

      これらの構成により、Agent は default ネームスペース内の kubernetes サービスに、定義されたエンドポイント IP アドレスとポートでリクエストを行います。

      検証

      Agent の status サブコマンドを実行し、Checks セクションの kube_apiserver_metrics を探してください。

      収集データ

      メトリクス

      サービスチェック

      Kube_apiserver_metrics には、サービスのチェック機能は含まれません。

      イベント

      Kube_apiserver_metrics には、イベントは含まれません。

      トラブルシューティング

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

      PREVIEWING: may/embedded-workflows