site24x7-operatorは、KubernetesクラスターにおけるSite24x7監視エージェントのデプロイと管理を簡素化します。設定とインストールのプロセスを自動化し、異なる監視エージェント間で複数のYAMLファイルを手動で管理する必要をなくします。
従来、Kubernetes環境の監視は容易ではありませんでした。多くのチームで以下のような対応が必要でした:
これらすべてが、オンボーディングプロセスの遅延や複雑化、手動での追加作業の発生につながっていました。
site24x7-operatorは、デプロイプロセス全体を自動化します:
site24x7-operatorが適切な設定を適用します。
site24x7-operatorは、単一のカスタムリソースを介して、Kubernetesクラスター内のインフラストラクチャとAPMリソースの両方の完全な監視ライフサイクルを管理します。
ユーザーは、site24x7-operatorをクラスターにデプロイし、監視対象の名前空間、使用するエージェントイメージ、プロキシ設定、その他の監視設定など、希望する監視構成を記述したSite24x7K8sリソースを作成します。
site24x7-operatorは、Site24x7監視リソースの期待される状態と実際のクラスターの状態を継続的に調整(リコンサイル)し、選択されたSite24x7K8s設定に基づいて監視リソースのプロビジョニングと更新を行います。
設定が変更されると、site24x7-operatorは更新された世代を検出し、ユーザーから提供された設定とSite24x7リソースの既存の状態を比較して、すべての管理対象リソースに必要な変更を適用します。手動でのHelmアップグレードやkubectl patch操作は必要ありません。
Site24x7K8sカスタムリソースは、Kubernetesクラスター内の監視の集中設定ポイントとして機能します。複数の監視コンポーネントを手動でデプロイして設定する代わりに、単一のカスタムリソースに監視要件を定義するだけで、site24x7-operatorが自動的にリソースを管理します。
カスタムリソースには、主に次の2つのセクションが含まれます:
infrastructureapmsite24x7-operatorは、このリソースを継続的に監視し、設定が変更されるたびに子リソースを自動的に作成、更新、または削除します。この宣言的アプローチにより、監視設定のバージョン管理、再現性、および環境間での一貫性が確保されます。
site24x7-operatorは、site24x7名前空間で実行される中央コントローラーとして機能します。Site24x7K8sカスタムリソースを継続的に監視し、Site24x7リソースの状態が期待される監視設定と一致することを確認します。
カスタムリソースが作成または変更されると、site24x7-operatorはどのリソースをデプロイ、更新、または削除する必要があるかを判断し、それらの変更を適用します。また、管理対象リソースの正常性を追跡し、失敗したデプロイを自動的に再試行します。
site24x7-operatorは、自動APMインストルメンテーションを担当するウェブフックサーバーをホストします。カスタムリソースの削除中、ファイナライザーによって、site24x7-operatorが作成したすべてのクラスター全体のリソースが安全にクリーンアップされます。
Site24x7エージェントはDaemonSetとして実行され、クラスター内のすべてのノードに1つのエージェントポッドがデプロイされるようにします。
各エージェントポッドには、以下が含まれます:
エージェントはKubernetes APIサーバーと直接通信してクラスターの状態情報を収集し、収集したメトリクスを可視化と分析のためにSite24x7に送信します。
エージェントはクラスター全体およびノードレベルの情報を収集するため、Kubernetesリソースにアクセスするための昇格した権限を必要とします。
Kube-State-Metricsは、Kubernetesオブジェクトの状態に関するメトリクスを生成する標準的なKubernetesコンポーネントです。
以下のような情報を提供します:
Site24x7エージェントはこれらのメトリクスを利用して、クラスターの正常性とリソース利用状況に関する包括的な可視性を提供します。
このコンポーネントは、インフラストラクチャ監視が有効になっている場合、自動的にデプロイされます。
クラスターエージェントは、大規模なクラスターで自動的にアクティブになるオプションのコンポーネントです。
大規模な環境では、すべてのノードエージェントが個別にKubernetes APIサーバーにクエリを送信すると、APIサーバーの負荷が増加する可能性があります。クラスターエージェントは、これらのクラスター全体のクエリを集中管理し、必要な情報を一度だけ取得してノードエージェントに分配します。
このアプローチにより、Kubernetes APIサーバーのオーバーヘッドが削減され、監視のスケール性能が向上します。
クラスターエージェントは、ReadinessおよびLiveness監視のためのヘルスチェックエンドポイントも公開します。
CSIドライバーはDaemonSetとして実行され、アプリケーションポッドへのAPMエージェントバイナリの配信を担当します。
CSIドライバーのアーキテクチャには、以下が含まれます:
kubeletと統合するドライバー登録コンポーネント。エージェントバイナリはノードごとに1回ダウンロードされ、インストルメンテーションされたワークロード間で共有されるため、ストレージとネットワークのオーバーヘッドが削減されます。
Mutating設定により、自動APMインストルメンテーションが有効になります。
監視対象の名前空間で新しいポッドが作成されるたびに、ウェブフックサーバーはポッドの作成リクエストをインターセプトし、ポッドがスケジュールされる前に必要な監視コンポーネントを注入します。
ワークロードのタイプに応じて、ウェブフックは以下を実行する場合があります:
ウェブフックは名前空間レベルのフィルタリングをサポートし、オプトアウト設定を遵守するため、管理者はどのワークロードをインストルメンテーションするかを制御できます。
データエクスポーターは、アプリケーションワークロード内で実行されているAPMエージェントから収集されたメトリクスとデータを受信し、収集されたデータをSite24x7に転送します。
次の2つのデプロイモードで動作可能です:
DaemonSetモードは優れたリソース効率を提供し、サイドカーモードはより強力なワークロードの分離を提供します。
site24x7-operatorは、監視およびデプロイのカスタマイズのための広範な設定オプションをサポートしています。サポートされているすべての設定フィールドの詳細については、こちらのヘルプドキュメントを参照してください。
クラスターレベル:
名前空間レベル(名前空間 site24x7):
ステップ1は、両方のインストール方法で共通です。希望するインストール方法(YAMLまたはHelm)に基づいてステップ2を完了し、その後、共通のステップ3から6に進んで監視の設定と検証を行ってください。
kubectl create namespace site24x7 && kubectl create secret generic site24x7-agent --namespace site24x7 --from-literal=s247_device_key=< device key >
site24x7-operatorは、2つのデプロイ方法をサポートしています(YAMLベースのインストールとHelmベースのインストール)。希望するデプロイ方法の手順に従ってください。
Site24x7コンソールからsite24x7-operatorのYAMLファイルをダウンロードし、クラスターに適用します。
kubectl apply -f site24x7_operator.yaml
これにより、次のリソースが作成されます:
site24x7)site24x7-operatorに必要なカスタムリソース定義(CRD)ClusterRoleおよびClusterRoleBindingsite24x7-operatorデプロイメントポッド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
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
kubectl apply -f site24x7-config.yaml
このステップにより、site24x7-operatorが設定に基づいて動作を開始します。適用されると、site24x7-operatorはsite24x7k8s-resourceを処理し、必要な監視リソースをプロビジョニングします。
site24x7-operatorは、必要な監視およびデータ収集リソースを自動的に適用します。
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を有効にする、フルスタックオブザーバビリティに切り替える、監視対象のポッドを更新するなど、監視要件が変更された場合でも、再インストールすることなく簡単に設定を変更できます。
インストール後に監視設定を変更するには:
site24x7k8s_resource.yaml)を編集します。kubectl apply -f site24x7k8s_resource.yaml
site24x7-operatorの調整(リコンシリエーション)ループがsite24x7k8s-resourceの変更を自動的に検出し、それに応じて監視リソースを更新します。
site24x7-operatorおよびすべての監視リソースを削除するには、次の手順に従って適用されたマニフェストを削除し、クラスター内に作成されたリソースをクリーンアップします。
kubectl delete -f site24x7k8s_resource.yaml --wait=false
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)"'
使用したインストール方法に基づいて、適切なコマンドを使用してsite24x7-operatorをアンインストールします。
kubectl delete -f site24x7_operator.yaml
helm uninstall site24x7-operator helm repo remove site24x7
次のコマンドを実行して、Site24x7デバイスキーシークレットと名前空間を削除します:
kubectl delete secret site24x7-agent --namespace site24x7 kubectl delete namespace site24x7