Kubernetes のモニター

システムが次世代の「 K8sensor 」に移行されていない場合、レガシー版の「 Kubernetes 」センサーを再インストールする必要がある場合は、インストール時に設定を --set k8s_sensor.deployment.enabled=false 指定して、 非推奨 1.X となったエージェント「 Helm 」チャートの 1.2.74 最終バージョンを使用できます。

Legacy Kubernetes センサーのステータスと実行中のバージョンを確認するには、以下の手順を実行します：

1. ナビゲーションメニューから、インフラを選択します。
2. Maps タブで、Kubernetes ノードをクリックします。
3. ノードの詳細パネルで、 「 Instana Agent (1)」 を展開し、該当するエージェントをクリックします。
4. エージェントパネルで、ダッシュボードを開くをクリックします。
5. エージェントページで、情報エリアのセンサー情報をクリックします。
6. センサー情報ウィンドウで、検索フィールドでInstana - Kubernetes - Sensorを検索します。

センサーが適切に有効化されていれば、表に一致するものが表示される。 状態列には値Activeが表示され、バージョン列にはバージョン番号、例えば1.2.143が表示されます。

エージェントログの検索 Instana - Kubernetes - Sensor およびフィルタリングを行 com.instana.sensor-kubernetes っても結果が得られない場合は、次のコマンドを実行して、 Instana エージェントの設定マップを確認してください：

kubectl -n instana-agent get cm instana-agent -o yaml
 

以下の設定がないことを確認してください：

    com.instana.plugin.kubernetes:
      enabled: false
 

Instana - Kubernetes - Sensorの状態欄が数分間Waitingと表示された場合、センサーの起動に失敗したことを意味します。

エージェントのログを検索し、com.instana.sensor-kubernetesをフィルタリングし、Activating Kubernetes Sensorを探します。 具体的には、次のようなメッセージが表示されていないかチェックする：

ERROR : bundle com.instana.sensor-kubernetes:1.2.143 (246)[com.instana.agent.kubernetes.sensor.Kubernetes(479)] : The activate method has thrown an exception
io.fabric8.kubernetes.client.KubernetesClientException: Failure executing: GET at: https://10.43.0.1/apis/apps/v1/deployments?labelSelector=app%3Dk8sensor. Message: Forbidden!Configured serv
ice account doesn't have access. Service account may have been revoked. deployments.apps is forbidden: User "system:serviceaccount:instana-agent:instana-agent" cannot list resource "deployme
nts" in API group "apps" at the cluster scope.
 

このエラーメッセージは、 Kubernetes API サーバーへのアクセスにサービスアカウントが使用できないことを示しています。

エージェントをインストールすると、デフォルトでは ` K8sensor ` タグ icr.io/instana/k8sensor:latest を介して Next Generation が自動的にインストールされます。 この k8s_sensor.deployment.enabled 値を指定する場合は、必ず（デフォルト true 値）に設定してください。

K8sensor のポーリングレートは、以下のいずれかの場所で k8s_sensor.pollrate 設定を行うことで変更できます：

• Helm 図表（例： --set k8s_sensor.pollrate=15s）
• InstanaAgent カスタムリソース（例： k8s_sensor.pollrate: "15s"）

K8sensor がクラスタ上で動作しているかどうかを確認するには、次のコマンドを実行して app: k8sensor というラベルの付いたデプロイメントを一覧表示します。

kubectl get deployments --all-namespaces -l app=k8sensor
 

K8sensorがリストにあれば、K8sensorが有効になる。 K8sensor が有効な場合、レガシー Kubernetes センサーは自動的に無効になります。 configuration.yamlファイルでは、enabledの値が次のようにfalseに変更されているのがわかる：

    com.instana.plugin.kubernetes:
      enabled: false
 

K8sensorのバージョンは、sha256の画像のハッシュによって最もよく識別される。 実行中の K8sensor コンテナのイメージ・ハッシュをチェックするには、以下のコマンドを実行する：

kubectl get po -n instana-agent -l app=k8sensor  -o jsonpath='{ .items[0].status.containerStatuses[0].imageID }'
 

Instana 現在、Next Generation K8sensor 向けの組み込みのオートスケーリング（HPAテンプレート）は提供されていません。 ただし、 k8sensor のデプロイメントに標準の Kubernetes （HPA） HorizontalPodAutoscaler を適用することで、オートスケーリングを有効にすることができます。 この回避策を実行するには、metrics-server がインストールされたクラスターが必要です。

Instana エージェントオペレーターは、カスタム InstanaAgent リソース（CR）から k8sensor デプロイメントの初期レプリカ数を管理します。 HPAとの競合を避けるため、CRのレプリカ数を一度設定したら、HPAの設定値と同じに minReplicas保ってください。

app: k8sensorというラベルでデプロイメントをリストしても結果が返らない場合、クラスタはK8sensorを実行していません。 この問題は、エージェントのデプロイ時にK8sensorが無効になっていたことを意味します。 この問題を解決するには、K8sensorを有効にしてエージェントを再デプロイします。

Kubernetes ページで、クラスターまたは名前空間をクリックします。 特定の Kubernetes エンティティーのすべての情報を表示する Kubernetes ダッシュボードを表示できます。 コンテキストは、常にコンテキストパスからアクセス可能です。 以下のスクリーン・ショットでは、「k8s-demo-cluster」というクラスターに「robot-shop」という名前の名前空間が表示されています。

Kubernetes ダッシュボードは、以下のように構造化されています。

• 「要約」 には、特定のエンティティーに最も関連性の高い情報が表示されます。 このダッシュボードは、状況と関連情報 (経過時間など) を示す状況表示行から始まります。 次のセクションでは、ポッドを含む、消費されたリソースを提供する CPU、メモリー、およびポッドの情報を確認できます。 以下のスクリーン・ショットの 「トップ・デプロイメント (Top Deployments)」 や 「トップ・ポッド (Top Pods)」 などのセクションには、潜在的なホット・スポットが表示されます。これらのホット・スポットを確認することをお勧めします。 「ログ」 セクションには、エンティティー・メトリックを補完する、そのエンティティーの関連ログの分布図が表示されます。 グラフは対話式で、すべての測定値を選択して強調表示することができます。 選択した期間にフォーカスすることも、 「分析」 セクションにジャンプしてトラブルシューティングを続行することもできます。

• 「詳細」には、「ラベル」、「注釈」、および「仕様」などの詳細情報が表示されます。

• 「イベント」には、関連するすべての Kubernetes イベントが表示され、それぞれのダッシュボードにリンクされます。

• 「デプロイメント」、「K8s Services」、および「ポッド」などの 関連エンティティー は、 Kubernetes ダッシュボードのタブとして表示されます。 表示される内容は、選択したエンティティーによって異なります。

PVを監視するには、 Instana のUIで以下の手順を実行してください：

1. ナビゲーションメニューから、インフラを選択します。

2. 「インフラストラクチャ」ダッシュボードで、 「インフラストラクチャの分析」 をクリックします。

3. 「インフラストラクチャの分析」ダッシュボードで、「 Kubernetes 」の永続ボリュームを検索し、次の画像のように総数を確認します

   

4. PVの一覧を表示するには、次の画像に示すように、インフラストラクチャ タイプのリストから 「 Kubernetes Persistent Volume」 を選択してください：

   

5. PVの指標を表示するには、リストからPVを選択してください。 タイプと現在の値を含むPVメトリクスの一覧を確認できます。

PVメトリクスのスマートアラートを設定するには、 Instana のUIで以下の手順を実行してください：

1. ナビゲーションメニューから、 「インフラストラクチャ 」＞「 スマートアラート 」＞「 スマートアラートの作成」 を選択します。

2. 「スマートアラートの作成」ウィンドウで、「使用容量（%）」などの利用可能なPVメトリクスのいずれかを選択し、必要なエンティティに基づいてフィルタリングします。

   

スマートアラートの設定に関する詳細については、 「スマートアラート」 を参照してください。

Instana 静的プロビジョニングと動的プロビジョニングの両方において、主要なクラウドプロバイダーが提供する最も一般的なストレージクラスをサポートしています。 以下のサポートマトリックスは、サポートが確認されている各種ストレージクラスを示しています。

PVCを監視するには、 Instana のUIで以下の手順を実行してください：

1. ナビゲーションメニューから、インフラを選択します。

2. 「インフラストラクチャ」ダッシュボードで、 「インフラストラクチャの分析」 をクリックします。

3. 「インフラストラクチャの分析」ダッシュボードで、「 Kubernetes 」の永続ボリュームを検索し、次の画像のように総数を確認します

   

4. PVCの一覧を表示するには、次の画像に示すように、インフラストラクチャ タイプのリストから 「 Kubernetes Persistent Volume Claim」 を選択します

   

5. PVCのメトリクスを表示するには、PVCの一覧からPVCを選択してください。 タイプと値を含むPVCメトリクスの一覧を確認できます。

PVC メトリクスのスマートアラートを設定するには、 Instana のUIで以下の手順を実行してください：

1. ナビゲーションメニューから、 「インフラストラクチャ 」＞「 スマートアラート 」＞「 スマートアラートの作成」 を選択します

2. 「スマートアラートの作成」ウィンドウで、「使用容量（%）」などの利用可能なPVメトリクスのいずれかを選択し、必要なエンティティに基づいてフィルタリングします。

   

スマートアラートの設定に関する詳細については、 「スマートアラート」 を参照してください。

PVやPVCのモニタリングとその必要性について詳しく知りたい場合は、 ブログ記事 「Demystifying PVCs and PVs（ IBM ）」をご覧ください。

サービス・メッシュのバイパスをデバッグするには、以下の手順を実行します。

1. サービス・メッシュのバイパスが有効になっていることを確認します。
2. iptable ルールがコンテナーに適用されていることを確認します。

サービスメッシュのバイパスが有効になっているかどうかを確認するには、次のコマンドを実行して Instana エージェントのログを確認してください：

kubectl logs -l app.kubernetes.io/instance=instana-agent -n instana-agent -c instana-agent
 

サービス・メッシュバイパスが有効になっている場合は、以下のログ行が表示されます。これらのログ行は、示されているプロセスに対してインバウンドまたはアウトバウンドのバイパス・エントリーが書き込まれていることを示します。

インバウンド・パス:

2021-04-26T08:13:57.065+0000 | INFO  | -client-thread-2 | DefaultServiceMeshSupport        | 51 - com.instana.agent - 1.1.597 | Applying inbound service mesh bypass for process '764670'
 

アウトバウンド・バイ・パス:

2021-04-26T08:13:57.140+0000 | INFO  | -client-thread-2 | DefaultServiceMeshSupport        | 51 - com.instana.agent - 1.1.597 | Applying outbound service mesh bypass for process '764670'
 

iptablesのルールを確認する最も簡単な方法は、 Instana エージェントにシェル接続し、次のようにターゲットコンテナのiptablesルールを一覧表示することです。 JVM${PID} プロセスのPIDを以下に置き換えてください：

kubectl -n instana-agent exec -it ${INSTANA_AGENT_POD} -c instana-agent  -- /bin/bash
nsenter -n -t ${PID} iptables -t nat -n -L INSTANA_OUTPUT
 

チェーンが適用されている場合は、次のような出力が表示されます。

Chain INSTANA_OUTPUT (1 references)
target     prot opt source               destination
ACCEPT     tcp  --  0.0.0.0/0            10.128.15.237
ACCEPT     tcp  --  0.0.0.0/0            10.64.0.1
ACCEPT     tcp  --  0.0.0.0/0            169.254.123.1
 

次のコマンドを実行して、 Instana エージェントと JVM プロセス間の双方向通信がサポートされているか確認してください：

nsenter -n -t ${PID} iptables -t nat -n -L INSTANA_INBOUND
 

結果は、以下の出力のようになります。

Chain INSTANA_INBOUND (1 references)
target     prot opt source               destination
ACCEPT     tcp  --  10.128.15.237        10.64.0.14
ACCEPT     tcp  --  10.64.0.1            10.64.0.14
ACCEPT     tcp  --  169.254.123.1        10.64.0.14
 

iptablesルールが適用されたタイミングによっては、プロセスの計測が完了し、 Instana のダッシュボードにデータが表示されるまで数分かかる場合があります。