目標

このチュートリアルでは、IBM Cloud® Kubernetes Service クラスターにメトリックを構成します。 具体的には、以下の操作を行います。

• IBM Cloud Monitoring インスタンスをプロビジョンします。
• メトリックを送信するようにクラスターにモニタリング・エージェントを構成します。
• モニタリング UI を使用してクラスター・メトリックを分析します。

開始前に

• Monitoring についてお読みください。

• IBM Cloud アカウントのメンバーまたは所有者であるユーザー ID を取得します。 IBM Cloud、ユーザーIDを取得してください： 登録

• Kubernetes モニター・エージェント・イメージに関する情報を取得します。

• Kubernetes のリソース要件を確認します。

• IBM Cloud CLI およびプラグインをインストールします。

  • IBM Cloud CLI (ibmcloud)

  • IBM Cloud Kubernetes Service プラグイン (ibmcloud ks)

  • IBM Cloud Container Registry プラグイン (ibmcloud cr)

  • IBM Cloud Kubernetes Service 可観測性プラグイン (ibmcloud ob)

• Kubernetes CLI(kubectl)のインストール

  kubectl のバージョンがご使用のクラスターのバージョンと互換性があることを確認してください。 kubectl バージョンに互換性がない場合は、 kubectl create clusterrolebinding failed! などのエラーが表示されることがあります。 kubectl version --short を使用して、クラスターと kubectl クライアントのバージョンを確認できます。

• クラスターを作成するか、既存の IBM Cloud Kubernetes Service クラスターを使用します。

• ユーザー ID に以下の IBM Cloud® Identity and Access Management ポリシーが割り当てられていることを確認します。

IBM Cloud® Kubernetes Service IAM ロールの詳細については 、「IAM ロールとアクション」 を参照してください。

IBM Cloud Monitoring インスタンスをプロビジョンする

この入門チュートリアルでは、米国南部リージョンで IBM Cloud Monitoring インスタンスをプロビジョンするための手順を説明します。 サポートされているリージョンについて詳しくは、リージョンを参照してください。

IBM Cloud Monitoring UI を使用して IBM Cloud のインスタンスをプロビジョンするには、以下のステップを実行します。

1. IBM Cloud アカウントにログインします。

   ユーザー ID とパスワードを使用してログインすると、IBM Cloud UI が開きます。

2. **「カタログ」**をクリックします。 IBM Cloud で使用可能なサービスのリストが開きます。

3. 表示されるサービスのリストをフィルタリングするには、**「ロギングとモニタリング」**カテゴリーを選択します。

4. **「IBM Cloud Monitoring」**タイルをクリックします。

5. ロケーションとサービス計画を選択します。

   デフォルトでは、**「ライト」**プランが設定されています。

   他のサービス・プランについて詳しくは、料金プランを参照してください。

6. リソースを構成します。

   サービス・インスタンスの名前を入力します。

   リソース・グループを選択します。

   オプションでタグを追加します。

7. 「作成」 をクリックします。

   インスタンスのプロビジョンが完了すると、*「プログラム識別情報」*ダッシュボードが開き、モニタリング・インスタンスの詳細が表示されます。

CLI を使用してインスタンスをプロビジョンするには、IBM Cloud CLI によるインスタンスのプロビジョニングを参照してください。

インスタンスにメトリックを送信するように Kubernetes クラスターを構成する

IBM Cloud Monitoring インスタンスにメトリックを送信するように Kubernetes クラスターを構成するには、クラスターのノードごとにモニタリング・エージェント・ポッドをインストールする必要があります。 モニタリング・エージェントは DaemonSet を使用してインストールされ、それによってエージェントのインスタンスがすべてのワーカー・ノードで確実に実行されます。 モニタリング・エージェントは、インストールされたポッドからメトリックを収集し、そのデータをインスタンスに転送します。

システム・メトリックを一式すべて取得するためには、モニタリング・エージェントが特権を付与された状況でなければなりません。

スクリプトを使用してエージェントをデプロイするには、コマンド・ラインから以下のステップを実行します。

1. 端末を開きます。 次に、IBM Cloud にログインします。 次のコマンドを実行して、プロンプトに従います。

   ibmcloud login -a cloud.ibm.com
   

   クラスターを使用できるアカウントを選択します。

2. クラスター環境をセットアップします。 以下のコマンドを実行します。

   最初に、環境変数を設定して Kubernetes 構成ファイルをダウンロードするためのコマンドを取得します。

   ibmcloud ks cluster config --cluster <cluster_name_or_ID>
   

   構成ファイルのダウンロードが完了すると、そのローカルの Kubernetes 構成ファイルのパスを環境変数として設定するために使用できるコマンドが表示されます。 KUBECONFIG 環境変数を設定するためのコマンドとしてターミナルに表示されたものを、コピーして貼り付けます。

   クラスターの作業を行うために IBM Cloud® Kubernetes Service CLI にログインするたびに、これらのコマンドを実行して、クラスターの構成ファイルのパスをセッション変数として設定する必要があります。 Kubernetes CLI はこの変数を使用して、IBM Cloud 内のクラスターと接続するために必要なローカル構成ファイルと証明書を検索します。

3. アクセス・キーを取得します。 詳しくは、IBM Cloud UI を使用したアクセス・キーの取得を参照してください。

4. コレクター・エンドポイントの取り込み URL を取得します。

5. モニタリング・エージェントをデプロイします。 以下のコマンドを実行します。

   curl -sL https://raw.githubusercontent.com/draios/sysdig-cloud-scripts/master/agent_deploy/IBMCloud-Kubernetes-Service/install-agent-k8s.sh | bash -s -- -a ACCESS_KEY -c COLLECTOR_ENDPOINT -t TAG_DATA -ac 'sysdig_capture_enabled: false'
   

   説明

   • ACCESS_KEY は、先ほど取得したインスタンスの取り込みキーです。

   • COLLECTOR_ENDPOINT は、先ほど取得したモニタリング・インスタンスを使用できるリージョンの取り込み URL です。

   • TAG_DATA は、コンマで区切られた TAG_NAME:TAG_VALUE 形式のタグです。 1 つ以上のタグをモニタリング・エージェントに関連付けることができます。 例えば、role:serviceX,location:us-south などです。 後で、これらのタグを使用して、エージェントが実行されている環境のメトリックを識別できます。

   • sysdig_capture_enabled を false に設定して、キャプチャー機能を無効にします。 デフォルトでは、true に設定されています。 詳しくは、キャプチャーの処理を参照してください。

6. モニタリング・エージェントが正常に作成されたこと、およびその状況を確認します。 以下のコマンドを実行します。

   kubectl get pods -n ibm-observe
   

   1 つ以上の sysdig-agent ポッドが表示されたら、デプロイメントは成功です。 sysdig-agent ポッドの数は、クラスター内のワーカー・ノードの数と等しくなります。 すべてのポッドが Running 状態である必要があります。

モニター UI の起動

IBM Cloud コンソールからモニタリング UI を起動するには、以下の手順を実行します。

1. IBM Cloud アカウントにログインします。

   ユーザー ID とパスワードを使用してログインすると、IBM Cloud ダッシュボードが開きます。

2. メニューから、可観測性を選択します。

3. **「モニタリング」**を選択します。 IBM Cloud で使用可能なインスタンスのリストが表示されます。

4. インスタンスを見つけて、**「ダッシュボードを開く」**をクリックします。 Web UI が開きます。

情報が最初に収集され、モニタリングエージェントによって処理される間、クラスタエントリが表示されるまでに時間がかかる場合があります。

モニターできるインスタンスは、ブラウザーごとに 1 つのみです。 同じインスタンスについて複数のタブが表示される場合があります。

クラスターのモニター

アドバイザータブでは、ホストおよび Kubernetes クラスターの正常性、リスク、および容量をモニターおよびトラブルシューティングできます。

• データは 10 分ごとに更新されます。
• メトリックは、イベント数と重大度によって優先順位付けされます。
• 詳しくは、 アドバイザーを参照してください。

アドバイザーセクションでは、クラスター別、ノード別、名前空間別、またはワークロード別に Kubernetes クラスターをモニターすることを選択できます。 各オプションには、リソースの正常性をモニターするために使用できる一連の事前定義ダッシュボードが用意されています。 ホストによるモニターを選択することもできます。

クラスターごとの Kubernetes クラスターのモニター

クラスターごとに Kubernetes クラスターをモニターすることを選択した場合は、ノードまたは名前空間ごとにデータを表示するために追加のフィルターを選択することも、以下のいずれかのダッシュボードを選択することもできます。

• ワークロード状況 & パフォーマンス
• 「ノード状況」&「パフォーマンス」
• ポッドのライトサイジング & ワークロード・キャパシティーの最適化
• クラスター容量の計画
• クラスター/名前空間使用可能リソース
• クラスターの概要
• CPU 割り振りの最適化
• メモリー割り振りの最適化

このビューの解釈方法について詳しくは、 クラスターの概要を参照してください。

次のステップ

• カスタム・ダッシュボードを作成します。 詳しくは、ダッシュボードの処理を参照してください。

• アラートについての詳細を確認します。 詳しくは、アラートの処理を参照してください。

• クラスターからログを管理する方法について説明します。 IBM Cloud Logs の使い方については、こちらをご覧ください。

• IBM Cloud Monitoring Workload Protection 機能について学習し、ソフトウェアの脆弱性の検出と優先順位付け、脅威の検出と対応、ソースから実行までの構成、権限、およびコンプライアンスの管理を行います。 IBM Cloud® Security and Compliance Center Workload Protectionの概要 を参照してください。