IBM Cloud Docs
IBM Cloud の一部ではない Kubernetes または OpenShift クラスターをエージェントにデプロイする

IBM Cloud の一部ではない Kubernetes または OpenShift クラスターをエージェントにデプロイする

IBM Cloud®で実行する機能に加えて、 IBM Cloud Monitoring が提供する一元化されたモニターは、 Helm チャートを使用して Kubernetes にモニター・エージェントをインストールすることによって、他のクラウドでも実行できます。

開始前に

エージェントのデプロイ

Helmを使用してエージェントをデプロイするには、以下のステップを実行します。

ステップ 1. Sysdig Helm リポジトリーのセットアップ

IBM Cloud Monitoring Helm リポジトリを Helm インスタンスに追加します。

以下のステップを実行します。

  1. クラスター・コンテキストを設定します。

    ibmcloud ks cluster config --cluster <CLUSTER_NAME>
    
  2. Helm リポジトリを追加します。

    helm repo add sysdig https://charts.sysdig.com
    

    以下のエラーを受け取る場合があります。

    helm repo add sysdig https://charts.sysdig.com    --debug
    Error: context deadline exceeded
    helm.go:84: [debug] context deadline exceeded
    

    以下のコマンドを実行し、 Helm リポジトリーの追加を再試行します。

    rm $HOME/Library/Preferences/helm/repositories.lock
    
  3. すべての Helm チャートの最新バージョンを取得するようにリポジトリーを更新します。

    helm repo update
    
  4. sysdig リポジトリで現在利用可能な Helm チャートをリストアップします。

    helm search repo sysdig
    
  5. Helm チャート sysdig/sysdig-deploy がリストされていることを確認します。

ステップ 2 yamlファイルを作成する

yaml ファイルを定義し、デプロイする予定の IBM Cloud Monitoring エージェントをデプロイするための値を組み込みます。 例えば、ファイルに agent-values-monitor.yaml という名前を付けます。

以下の yaml は、 IBM Cloud Monitoring エージェントを構成するために使用できるテンプレートです。

global:
  clusterConfig:
    name: CLUSTER_NAME
  sysdig:
    accessKey: SERVICE_ACCESS_KEY
agent:
  collectorSettings:
    collectorHost: INGESTION_ENDPOINT
nodeAnalyzer:
  enabled: false

説明

  • CLUSTER_NAME は、エージェントをデプロイしているクラスターの名前です。
  • SERVICE_ACCESS_KEY は IBM Cloud Monitoring インスタンスのアクセス・キーです。
  • INGESTION_ENDPOINT は、インスタンスの取り込みエンドポイントです。 例: ingest.us-east.monitoring.cloud.ibm.com

ここ には、 IBM Cloud Monitoring エージェントを構成するために使用可能なすべてのオプションがあります。

ステップ 3。 Helm チャートをインストールする

エージェントをデプロイするには、 sysdig/sysdig-deploy チャートをインストールする必要があります。 前のステップで構成したような変数 yaml ファイルを使用してチャートをインストールすることも、変数を直接構成することもできます。

以下のコマンドを実行し、 Helm チャートと変数 yaml ファイルを使用してエージェントをインストールします。

helm install -n ibm-observe sysdig-agent sysdig/sysdig-deploy -f agent-values-monitor.yaml

Helm 値ファイルを使用していない場合は、 Helm チャートを使用し、変数を設定することで、以下のコマンドを実行してエージェントをインストールできます。

helm install sysdig-agent sysdig/sysdig-deploy --namespace ibm-observe --create-namespace\
    --set global.sysdig.accessKey=<SERVICE_ACCESS_KEY> \
    --set agent.collectorSettings.collectorHost=<INGESTION_ENDPOINT> \
    --set nodeAnalyzer.enabled=false \
    --set global.clusterConfig.name=<CLUSTER_NAME>

説明

  • CLUSTER_NAME は、エージェントをデプロイしているクラスターの名前です。
  • SERVICE_ACCESS_KEY は IBM Cloud Monitoring インスタンスのアクセス・キーです。
  • INGESTION_ENDPOINT は、インスタンスの取り込みエンドポイントです。

例えば、 us-east リージョンの場合、サンプルの Helm インストールは以下のようになります。

helm install sysdig-agent sysdig/sysdig-deploy --namespace ibm-observe \
    --set global.sysdig.accessKey=<ENTER_YOUR_ACCESS_KEY> \
    --set agent.collectorSettings.collectorHost=ingest.us-east.monitoring.cloud.ibm.com \
    --set nodeAnalyzer.enabled=false \
    --set global.clusterConfig.name=mycluster

Error: INSTALLATION FAILED: Kubernetes cluster unreachable: xxxxxx failed to refresh token: oauth2: cannot fetch token: 400 Bad Request」というエラーが発生した場合は、クラスター・コンテキストを設定して再試行してください。

エージェントの更新

Helmを使用してエージェントのバージョンを更新するには、以下の手順を実行します。

  1. チャートを更新します。

    helm repo update
    
  2. エージェントをアップグレードします。

    helm upgrade -n ibm-observe sysdig-agent sysdig/sysdig-deploy -f agent-values-monitor.yaml
    

以下の手順では、使用可能な最新バージョンをクラスターにインストールします。

エージェントの削除

Helmを使用してエージェントを削除するには、チャートをアンインストールする必要があります。

以下のステップを実行します。

  1. インストールされているチャートをリストアップします。

    helm list -n ibm-observe
    

    コマンドの出力は、以下のようにチャートをリストアップします

    NAME        	NAMESPACE  	REVISION	UPDATED                             	STATUS  	CHART              	APP VERSION
    sysdig-agent	ibm-observe	1       	2023-03-24 15:02:58.408108 +0100 CET	deployed	sysdig-deploy-1.6.3
    
  2. チャートをアンインストールします。

    helm delete sysdig-agent  -n ibm-observe
    

    Helmの用語では、 sysdig-agent はリリースの名前です。

    コマンドに名前空間を含めるのを忘れた場合は、次のエラーが表示されます: Error: uninstall: Release not loaded: sysdig-agent: release: not found