To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.
To initiate an exception request to enable this integration for your organization, email [email protected].
概要
このチェックは 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 のサポートチームまでお問合せください。
