Site24x7 Kubernetes Operator:クラスターとアプリケーションの自動監視

本ページは機械翻訳をもとに提供しています。正確かつ最新の情報は英語版の内容をご参照ください。

site24x7-operatorは、KubernetesクラスターにおけるSite24x7監視エージェントのデプロイと管理を簡素化します。設定とインストールのプロセスを自動化し、異なる監視エージェント間で複数のYAMLファイルを手動で管理する必要をなくします。

目次

site24x7-operatorを使用する理由

従来、Kubernetes環境の監視は容易ではありませんでした。多くのチームで以下のような対応が必要でした:

  • 完全なメトリクスを収集するために、複数のYAMLファイルを調整する。
  • OpenShiftやGKE Autopilotなどのプラットフォームごとに異なるインストール用YAMLを扱う。
  • アプリケーションパフォーマンス監視(APM)エージェントの設定や更新のために、本番環境のYAMLを手動で編集する。
  • 監視コンポーネントを追加するためにDockerイメージを更新する。

これらすべてが、オンボーディングプロセスの遅延や複雑化、手動での追加作業の発生につながっていました。

site24x7-operatorは、デプロイプロセス全体を自動化します:

  • プラットフォームの自動設定:Kubernetes環境のタイプを指定するだけで、site24x7-operatorが適切な設定を適用します。
  • 手間のいらないインストール:手動での介入なしに、監視リソースを自動的にスケジュールおよびデプロイします。
  • Dockerイメージの変更が不要:監視エージェントがポッドに動的に注入されるため、アプリケーションのデプロイ設定をクリーンに保つことができます。
  • 集中管理された設定:単一のカスタムリソースファイルを通じて、すべての監視設定を管理します。

動作の仕組み

site24x7-operatorは、単一のカスタムリソースを介して、Kubernetesクラスター内のインフラストラクチャとAPMリソースの両方の完全な監視ライフサイクルを管理します。

ユーザーは、site24x7-operatorをクラスターにデプロイし、監視対象の名前空間、使用するエージェントイメージ、プロキシ設定、その他の監視設定など、希望する監視構成を記述したSite24x7K8sリソースを作成します。

site24x7-operatorは、Site24x7監視リソースの期待される状態と実際のクラスターの状態を継続的に調整(リコンサイル)し、選択されたSite24x7K8s設定に基づいて監視リソースのプロビジョニングと更新を行います。

設定が変更されると、site24x7-operatorは更新された世代を検出し、ユーザーから提供された設定とSite24x7リソースの既存の状態を比較して、すべての管理対象リソースに必要な変更を適用します。手動でのHelmアップグレードやkubectl patch操作は必要ありません。

site24x7-operator:主要コンポーネント

1.カスタムリソース(Site24x7K8s)

Site24x7K8sカスタムリソースは、Kubernetesクラスター内の監視の集中設定ポイントとして機能します。複数の監視コンポーネントを手動でデプロイして設定する代わりに、単一のカスタムリソースに監視要件を定義するだけで、site24x7-operatorが自動的にリソースを管理します。

カスタムリソースには、主に次の2つのセクションが含まれます:

  • Kubernetesクラスターおよびノード監視用のinfrastructure
  • アプリケーションパフォーマンス監視用のapm

site24x7-operatorは、このリソースを継続的に監視し、設定が変更されるたびに子リソースを自動的に作成、更新、または削除します。この宣言的アプローチにより、監視設定のバージョン管理、再現性、および環境間での一貫性が確保されます。

2.オペレーター(コントロールプレーン)

site24x7-operatorは、site24x7名前空間で実行される中央コントローラーとして機能します。Site24x7K8sカスタムリソースを継続的に監視し、Site24x7リソースの状態が期待される監視設定と一致することを確認します。

カスタムリソースが作成または変更されると、site24x7-operatorはどのリソースをデプロイ、更新、または削除する必要があるかを判断し、それらの変更を適用します。また、管理対象リソースの正常性を追跡し、失敗したデプロイを自動的に再試行します。

site24x7-operatorは、自動APMインストルメンテーションを担当するウェブフックサーバーをホストします。カスタムリソースの削除中、ファイナライザーによって、site24x7-operatorが作成したすべてのクラスター全体のリソースが安全にクリーンアップされます。

3.インフラストラクチャ監視

Site24x7エージェント(DaemonSet)

Site24x7エージェントはDaemonSetとして実行され、クラスター内のすべてのノードに1つのエージェントポッドがデプロイされるようにします。

各エージェントポッドには、以下が含まれます:

  • CPU、メモリ、ディスク、ネットワーク使用率などのホストレベルのメトリクスを収集するプライマリノードエージェント。
  • 実行中のアプリケーションを検出し、APMインストルメンテーションの対象となるかどうかを判断する自動プロファイラー。

エージェントはKubernetes APIサーバーと直接通信してクラスターの状態情報を収集し、収集したメトリクスを可視化と分析のためにSite24x7に送信します。

エージェントはクラスター全体およびノードレベルの情報を収集するため、Kubernetesリソースにアクセスするための昇格した権限を必要とします。

Kube-State-Metrics(Deployment)

Kube-State-Metricsは、Kubernetesオブジェクトの状態に関するメトリクスを生成する標準的なKubernetesコンポーネントです。

以下のような情報を提供します:

  • Deploymentのレプリカ数
  • ポッドの状態とフェーズ
  • リソースのリクエストと制限
  • Persistent Volume Claim(PVC)のステータス

Site24x7エージェントはこれらのメトリクスを利用して、クラスターの正常性とリソース利用状況に関する包括的な可視性を提供します。

このコンポーネントは、インフラストラクチャ監視が有効になっている場合、自動的にデプロイされます。

クラスターエージェント(Deployment)

クラスターエージェントは、大規模なクラスターで自動的にアクティブになるオプションのコンポーネントです。

大規模な環境では、すべてのノードエージェントが個別にKubernetes APIサーバーにクエリを送信すると、APIサーバーの負荷が増加する可能性があります。クラスターエージェントは、これらのクラスター全体のクエリを集中管理し、必要な情報を一度だけ取得してノードエージェントに分配します。

このアプローチにより、Kubernetes APIサーバーのオーバーヘッドが削減され、監視のスケール性能が向上します。

クラスターエージェントは、ReadinessおよびLiveness監視のためのヘルスチェックエンドポイントも公開します。

4. APM

CSIドライバー(DaemonSet)

CSIドライバーはDaemonSetとして実行され、アプリケーションポッドへのAPMエージェントバイナリの配信を担当します。

CSIドライバーのアーキテクチャには、以下が含まれます:

  • Java、.NET、Node.js、Pythonなどのサポートされている言語のAPMエージェントパッケージをダウンロードするプロビジョナーコンテナ。
  • CSI VolumeMountsを通じて、アプリケーションコンテナに必要なAPMエージェントを提供するCSIサーバーコンテナ。
  • kubeletと統合するドライバー登録コンポーネント。

エージェントバイナリはノードごとに1回ダウンロードされ、インストルメンテーションされたワークロード間で共有されるため、ストレージとネットワークのオーバーヘッドが削減されます。

Mutatingウェブフック設定とウェブフックサーバー

Mutating設定により、自動APMインストルメンテーションが有効になります。

監視対象の名前空間で新しいポッドが作成されるたびに、ウェブフックサーバーはポッドの作成リクエストをインターセプトし、ポッドがスケジュールされる前に必要な監視コンポーネントを注入します。

ワークロードのタイプに応じて、ウェブフックは以下を実行する場合があります:

  • APMエージェントバイナリを含むCSIエフェメラルボリュームを追加する。
  • 必要な環境変数を挿入する。
  • エージェント固有のランタイム設定を構成する。
  • Kubernetesシークレットからライセンス情報を注入する。

ウェブフックは名前空間レベルのフィルタリングをサポートし、オプトアウト設定を遵守するため、管理者はどのワークロードをインストルメンテーションするかを制御できます。

データエクスポーター

データエクスポーターは、アプリケーションワークロード内で実行されているAPMエージェントから収集されたメトリクスとデータを受信し、収集されたデータをSite24x7に転送します。

次の2つのデプロイモードで動作可能です:

  • DaemonSetモード:単一のエクスポーターが同じノード上で実行されているワークロードに対応します。
  • サイドカーモード:監視対象の各アプリケーションポッドと並んでコンテナがデプロイされます。

DaemonSetモードは優れたリソース効率を提供し、サイドカーモードはより強力なワークロードの分離を提供します。

サポートされているプラットフォーム

  • 標準のKubernetes
  • OpenShift(Red Hat)
  • Google Kubernetes Engine(GKE)
  • その他のマネージドKubernetesサービス(AWS EKS、Azure AKS)
  • APM監視はGKE Autopilotではサポートされていません。
  • site24x7-operatorは現在、AMD64およびARM64アーキテクチャのLinuxノードをサポートしています。
  • site24x7-operatorは現在、Java、.NET、Node.js、およびPythonアプリケーションをサポートしています。

Site24x7K8s設定オプション

site24x7-operatorは、監視およびデプロイのカスタマイズのための広範な設定オプションをサポートしています。サポートされているすべての設定フィールドの詳細については、こちらのヘルプドキュメントを参照してください。

site24x7-operatorのインストール

site24x7-operatorをインストールする前に、既存のSite24x7 KubernetesインフラストラクチャおよびAPM監視リソースを削除してください。手順については、移行ヘルプドキュメント(英語版)を参照してください。

前提条件

  • Kubernetes v1.25+
  • Helm 3.x
  • Docker 17.03+または互換性のあるcontainerdバージョン
  • Linuxカーネル 3.18+
  • 必要なクラスター権限:
    Site24x7 Kubernetes Operatorをインストールするには、インストールを実行するユーザーまたはCIシステムが、Site24x7 Operatorとそれに関連するリソースを作成するために、以下のクラスターレベルおよび名前空間レベルの権限を持っている必要があります。

          クラスターレベル:

  •  namespaces (""):get, create, patch, update
  • customresourcedefinitions (apiextensions.k8s.io):get, create, patch, update
  • clusterroles (rbac.authorization.k8s.io):get, create, patch, update
  • clusterrolebindings (rbac.authorization.k8s.io):get, create, patch, update
  • priorityclasses (scheduling.k8s.io):get, create, patch, update

名前空間レベル(名前空間 site24x7):

  • serviceaccounts (""):get, create, patch, update
  • services (""):get, create, patch, update
  • deployments (apps):get, create, patch, update

ステップ1は、両方のインストール方法で共通です。希望するインストール方法(YAMLまたはHelm)に基づいてステップ2を完了し、その後、共通のステップ3から6に進んで監視の設定と検証を行ってください。

ステップ 1:Site24x7デバイスキーシークレットの作成

kubectl create namespace site24x7 && 
kubectl create secret generic site24x7-agent --namespace site24x7 --from-literal=s247_device_key=< device key >

ステップ 2:site24x7-operatorのデプロイ 

site24x7-operatorは、2つのデプロイ方法をサポートしています(YAMLベースのインストールとHelmベースのインストール)。希望するデプロイ方法の手順に従ってください。

YAMLベースのインストール:

Site24x7コンソールからsite24x7-operatorのYAMLファイルをダウンロードし、クラスターに適用します。

kubectl apply -f site24x7_operator.yaml

これにより、次のリソースが作成されます:

  • 専用の名前空間(site24x7)
  • site24x7-operatorに必要なカスタムリソース定義(CRD)
  • 必要な権限を付与するためのClusterRoleおよびClusterRoleBinding
  • クラスター内の監視リソースを管理するsite24x7-operatorデプロイメントポッド

Helmベースのインストール:

i. Site24x7 Helmリポジトリを追加します:

helm repo add site24x7 https://site24x7.github.io/helm-charts

ii. リポジトリを更新します:

helm repo update

iii. site24x7-operatorをインストールします:

helm install site24x7-operator site24x7/site24x7operator

OpenShift環境の場合:

helm install site24x7-operator site24x7/site24x7operator --set openshift=true

ステップ 3:site24x7k8s_resource.yamlファイルをダウンロードして設定する

Site24x7K8sカスタムリソースのYAMLファイル(site24x7k8s_resource.yaml)をダウンロードし、監視設定に合わせて更新します:

apiVersion: site24x7.com/v1alpha1
kind: Site24x7K8s
metadata:
  name: site24x7k8s-resource
  namespace: site24x7
spec:
  openShift: false
  installationType:
    agentType: "fso" # options: fso | apm_insight | infra | custom
  proxy:
    http_proxy: "<http proxy url>"
    https_proxy: "<https proxy url>"
  infrastructure:
    managementAction: true
    clusterName: "PROD_CLUSTER_EKS_1"
    site24x7Agent:
      leaseAPI:
        enabled: false
      nodeSelector: {}
      imagePullSecrets: []
  apm:
    webhook:
      monitorAllNamespaces: true
      excludeNamespaces:
        - site24x7
        - kube-system
        - kube-public
        - kube-node-lease
        - cert-manager
        - ingress-nginx
        - external-dns
        - argocd
        - flux-system
        - velero
    monitorAllPods: false
    includeAppLabels:
      payment_namespace:
        - app.kubernetes.io/name: payments-api
          app.kubernetes.io/instance: payments-prod
          app.kubernetes.io/component: api
          app.kubernetes.io/part-of: payments-platform

ステップ 4:カスタムリソースの適用

kubectl apply -f site24x7-config.yaml

このステップにより、site24x7-operatorが設定に基づいて動作を開始します。適用されると、site24x7-operatorはsite24x7k8s-resourceを処理し、必要な監視リソースをプロビジョニングします。

site24x7-operatorは、必要な監視およびデータ収集リソースを自動的に適用します。

ステップ 5:インストールの検証

site24x7-operatorと監視リソースが実行されていることを確認します:

kubectl get pods -n site24x7

(有効にされた監視タイプに基づいて)次のリソースが表示されます:

  • site24x7-operatorデプロイメントポッド
  • site24x7-agent DaemonSetポッド(インフラストラクチャ監視)
  • site24x7-kube-state-metricsデプロイメントポッド(インフラストラクチャ監視)
  • site24x7-cluster-agentデプロイメント(ノード数に基づく)
  • site24x7-apminsight-dataexporter-daemonsetポッド(APM監視)
  • site24x7-csi-driver DaemonSetポッド(APM監視)
APMエージェントを有効にするには、監視対象のプロセスに一致するプロセス監視ルールが作成され、有効になっていることを確認してください。ルール作成後、従来のエージェントで監視する場合は、該当するすべてのアプリケーションワークロードを再起動する必要があります。

ステップ 6:Site24x7コンソールでの監視の検証

  1. Site24x7コンソールにログインします。
  2. APMメトリクスを表示するには:
    • [APM]→[K8sアプリケーションディスカバリー]に移動して、Kubernetesアプリケーションディスカバリーの詳細を表示します。
    • [APM]→[アプリケーション]に移動して、監視対象のアプリケーションインスタンスとパフォーマンスインサイトを表示します。
  3. インフラストラクチャメトリクスを表示するには:
    • [K8s]に移動して、クラスターとノードのメトリクスに関する詳細情報を表示します。

設定の更新

後からAPMを有効にする、フルスタックオブザーバビリティに切り替える、監視対象のポッドを更新するなど、監視要件が変更された場合でも、再インストールすることなく簡単に設定を変更できます。

インストール後に監視設定を変更するには:

  1. カスタムリソースのYAMLファイル(site24x7k8s_resource.yaml)を編集します。
  2. 必要な変更を行います(例:監視タイプの有効化/無効化、ポッドラベルの更新)。
  3. 設定を再適用します:
    kubectl apply -f site24x7k8s_resource.yaml

site24x7-operatorの調整(リコンシリエーション)ループがsite24x7k8s-resourceの変更を自動的に検出し、それに応じて監視リソースを更新します。

site24x7-operatorのアンインストール

site24x7-operatorおよびすべての監視リソースを削除するには、次の手順に従って適用されたマニフェストを削除し、クラスター内に作成されたリソースをクリーンアップします。

ステップ 1:Site24x7K8sカスタムリソースの削除
kubectl delete -f site24x7k8s_resource.yaml --wait=false
ステップ 2:Mutatedポッドの再起動

site24x7-operatorのデプロイを削除する前に、site24x7-apminsight CSIボリュームが削除されるように、site24x7-mutating-webhookによって変更(mutate)されたすべてのポッドを必ず再起動してください。

Site24x7ボリュームがインジェクションされたすべてのポッドを取得するには、次のコマンドを使用します:

kubectl get pods --all-namespaces -o json | jq -r '.items[] | select(any(.spec.volumes[]?; .csi.driver == "site24x7-csi-driver")) | "\(.metadata.name)\t\(.metadata.namespace)"'
ステップ 3:site24x7-operatorのアンインストール

使用したインストール方法に基づいて、適切なコマンドを使用してsite24x7-operatorをアンインストールします。

  • YAMLベースのインストールの場合:以下を実行します。
    kubectl delete -f site24x7_operator.yaml
  • Helmベース of インストールの場合:以下を実行します。
    helm uninstall site24x7-operator
    helm repo remove site24x7
ステップ 4:Site24x7シークレットと名前空間の削除

次のコマンドを実行して、Site24x7デバイスキーシークレットと名前空間を削除します:

kubectl delete secret site24x7-agent --namespace site24x7
kubectl delete namespace site24x7

関連ドキュメント