Helm チェック

Supported OS Linux Mac OS Windows

概要

このチェックは、Datadog Agent を通じて Helm のデプロイメントを監視します。

Helm は複数のストレージバックエンドをサポートしています。v3 では、Helm のデフォルトは Kubernetes シークレットで、v2 では、Helm のデフォルトは ConfigMaps です。このチェックでは、両方のオプションに対応しています。

セットアップ

インストール

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

構成

これはクラスターのチェックです。Helm チャートに datadog.helmCheck.enabled を追加することで、このチェックを有効にすることができます。

注: 構成が不要な場合は、空の conf.d を渡すことができます。

詳細については、クラスターチェックのドキュメントを参照してください。

これはクラスターのチェックです。このチェックを有効にするには、spec.features.helmCheck.enabled を DatadogAgent のデプロイ構成に追加します。

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  features:
    helmCheck:
      enabled: true

これはクラスターのチェックです。このチェックを有効にするには、DatadogAgent のデプロイメント構成でコンフィギュレーションファイル helm.yaml を Cluster Agent に渡します。

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  [...]
  override:
    clusterAgent:
      [...]
      extraConfd:
        configDataMap:
          helm.yaml: |-
            init_config:
            instances:
            - collect_events: false

このチェックには、Helm に保存されたリリースにアクセスするために、Cluster Agent ポッドが使用する Kubernetes サービスアカウントにバインドされる追加の権限が必要です。

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: datadog-helm-check
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: datadog-helm-check
subjects:
  - kind: ServiceAccount
    name: datadog-cluster-agent
    namespace: default
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: datadog-helm-check
rules:
- apiGroups:
  - ""
  resources:
  - secrets
  - configmaps
  verbs:
  - get
  - list
  - watch

注: ServiceAccount のサブジェクトは default ネームスペースへのインストールを例に挙げています。デプロイメントに応じて name と namespace を調整してください。

検証

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

収集データ

メトリクス

This check reports a gauge, helm.release, set to 1 for each release deployed in the cluster. The metric has tags that identify the Helm release such as name, app version, chart version, and revision.


helm.release (gauge)	a Helm release

イベント

このチェックは、collect_events オプションが true に設定されているときにイベントを発行します。デフォルトは false です。

このオプションを有効にすると、次の場合にチェックがイベントを発行します。

新しいリリースがデプロイされる。
リリースが削除される。
リリースがアップグレードされる (新しいリビジョン)。
例えば、デプロイ済みから置き換え済みへのステータス変更があります。

サービスチェック

helm.release_state

Returns CRITICAL for a release when its latest revision is in failed state. Returns OK otherwise.

Statuses: ok, critical

トラブルシューティング

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

その他の参考資料

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

ブログ: Datadog で Helm で管理された Kubernetes アプリケーションを監視する