概要

このチェックは 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 サービスに対してインテグレーションを設定できます。

• kube_apiserver_metrics チェックを実行する主なユースケースは、クラスターレベルのチェックとしてです。
• これは、サービスへのアノテーションを使用するか、Datadog Operator、Helm Chart、または手動でローカルファイルを使用して行うことができます。
• メトリクスを収集するには、Autodiscovery テンプレートに次のパラメーターと値を設定します。

利用可能なすべての構成オプションは、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 のサポートチームまでお問合せください。