モニター Kubernetes

サポートされる管理対象 Kubernetes

• IBM Cloud Kubernetes Service モニターおよびパフォーマンス管理
• Amazon Elastic Container Service for Kubernetes (EKS)
• Azure Kubernetes Service (AKS)
• Google Kubernetes Engine (GKE)
• IBM Cloud Kubernetes Service
• VMware Tanzu Kubernetes Grid (TKG) および VMware Tanzu Kubernetes Grid Integration (TKGI) (旧称 Pivotal Container Service (PKS))

Linux ワーカーのみがサポートされます。 Windows で実行されるワーカーはサポートされません。

サポートされるサービスメッシュ

Instana は、Istio の最後の 3 つの安定バージョンをサポートしています。

Kubernetes ページ

Instana UI のナビゲーション・メニューで 「プラットフォーム」 > Kubernetes をクリックします。 Kubernetes クラスターと名前空間の情報が表示されます。

「アプリケーション」ページ

Instana UI のナビゲーション・メニューで 「アプリケーション」 をクリックし、 「アプリケーション」 または 「サービス」 タブをクリックします。 サービスまたはアプリケーションが Kubernetes クラスターで実行されている場合は、 「インフラストラクチャー」 タブでそれぞれのコンテキスト情報を確認できます。

コンテナーの場合、ポッドと名前空間が表示され、直接リンクされます。ホストの場合、クラスターとノードも表示され、リンクされます。

「インフラストラクチャー」ページ

Instana UI のナビゲーション・メニューで 「インフラストラクチャー」 をクリックします。 インフラストラクチャー・マップでは、選択したホストまたはコンテナーのいずれかのサイドバーに Kubernetes 情報が表示されます。

ダイナミック・フォーカス を使用して、データをフィルターに掛けることができます。 例えば、クラスター内の特定のデプロイメントを検索します。 さらに、キーワード entity.kubernetes.cluster.distribution と entity.kubernetes.cluster.managedBy を使用すると、ディストリビューション層と管理層で Kubernetes クラスターを検索することもできます。 entity.kubernetes.cluster.distribution でサポートされる値は、 gke、 eks、 openshift、および kubernetesです。 entity.kubernetes.cluster.managedBy に対してサポートされる値は rancher および none です。

単一の Kubernetes サービスから複数の論理サービスへ

サービス・マッピング・ルールが一致し、その Kubernetes サービスで呼び出しが生成される場合、複数の論理サービスを単一の Kubernetes サービスに関連付けることができます。 例えば、ラベル・セレクター "service=my-service" を持つ Kubernetes サービスには、タグ kubernetes.container.name、 kubernetes.pod.label、および key: envを持つ Instana のカスタム・サービス・マッピング構成と結合された追加のラベル "env=dev" および "env=staging" を持つポッドが含まれている場合があります。 その結果、複数の論理サービスがその単一の Kubernetes サービスにリンクされ、 Kubernetes Service ダッシュボードに表示されます。

単一の論理サービスから複数の Kubernetes サービスへ

複数の Kubernetes サービスは、それらの Kubernetes サービスが破棄され、時間の経過とともに再作成されるときに、単一の論理サービスに関連付けることができます。 例えば、生成された呼び出しを持つ Kubernetes サービス shop-service-a が、時間の経過とともに shop-service-b によって生成された呼び出しに置き換えられる場合、選択された期間が生成された呼び出しと重複すると、両方のサービスが論理サービス・ダッシュボードに表示されます。

クラスター

CronJob

DaemonSet

デプロイメント

ジョブ

Kubernetes サービス

名前空間

ノード

ポッド

StatefulSet

組み込み

Kubernetes エンティティーの問題をトリガーする組み込みヘルス・ルールがいくつか存在します。

• クラスター
  • Kubernetes は、マスター・コンポーネント (apiserver、スケジューラー、およびコントローラー・マネージャー) が正常でないことを報告します。 Kubernetes のバグが原因で、ヘルスが常に確実に報告されるとは限りません。 Instana は、マスター・コンポーネントの正常性状況をフィルタリングしようとします。アラートは発生しませんが、クラスター詳細ページには正常性状況のみが表示されます。
• ノード
  • 要求された CPU が最大容量に近づいています。 CPU 容量に対する要求された CPU の比率が 80% を超えています。
  • 要求されたメモリーが最大容量に近づいています。 要求されたメモリー対メモリー容量の比率が 80% を超えています。
  • 割り振り済みポッドが最大容量に近づいています。 ポッド容量に対する割り振り済みポッドの比率が 80% を超えています。 ノードの場合、フェーズ「Running」および「Unknown」のポッドは、割り振り済みとしてカウントされます。 ノード容量について詳しくは、 Kubernetes の資料を参照してください。
  • ノードが 1 分を超えて作動不能状態を報告し、このノードのすべての状態が「作動可能」状態を超えています。 すべてのノード条件について詳しくは、 Kubernetes の資料を参照してください。
• 名前空間
  • 要求された CPU が最大容量に近づいています。 CPU 容量に対する要求された CPU の比率が 80% を超えています。
  • 要求されたメモリーが最大容量に近づいています。 要求されたメモリー対メモリー容量の比率が 80% を超えています。
  • 割り振り済みポッドが最大容量に近づいています。 ポッド容量に対する割り振り済みポッドの比率が 80% を超えています。 名前空間の場合、フェーズ「保留中」、「実行中」、および「不明」のポッドが割り振り済みとしてカウントされます。 名前空間キャパシティー値は、名前空間ごとに設定できる ResourceQuotas に基づいています。 詳しくは、 Kubernetes の資料を参照してください。
• デプロイメント
  • 使用可能なレプリカの数が、必要なレプリカの数よりも少ない。
• ポッド
  • ポッドはデプロイされてから 1 分以内に作動可能になっている必要がありますが、1 分以内に作動可能になっていない場合は、タスクが完了したという理由ではありません (PodCondition= Ready, Status=False, Reason! = PodCompleted)。 すべてのポッドの状態について詳しくは、 Kubernetes の資料を参照してください。

カスタム

組み込みルールに加えて、クラスター、名前空間、デプロイメント、およびポッドのメトリックに対してカスタム・ルールを作成することもできます。 例えば、ノード・キャパシティー警告のしきい値が高すぎる場合は、それらを無効にして、より低いしきい値でカスタム・ルールを作成することができます。 詳しくは、 イベントおよびインシデントの構成を参照してください。

OpenShift ServiceMesh

OpenShift ServiceMeshにある OpenShift FAQ を参照してください。

Istio (Istio)

apiVersion: networking.istio.io/v1alpha3
kind: ServiceEntry
metadata:
  name: instana-agent-worker-<node-unique-counter>
spec:
  hosts:
  - <node-ip-address>.instana-agent-headless.instana-agent.svc
  ports:
  - number: 42699
name: agent
    protocol: TCP
  - number: 42666
name: socket
    protocol: TCP
  resolution: DNS
  location: MESH_EXTERNAL

com.instana.container:
  serviceMesh:
    enableServiceMeshBypass: true

メッシュのバイパスによるデバッグ

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

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

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'

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

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

Kubernetes クラスターまたは名前空間が表示されないのはなぜですか?

Kubernetes ページにクラスターまたは名前空間がリストされていない場合は、エージェントがインストールされていないためにアクティブにモニターされているクラスターがないか、選択した時間フレーム中にモニターされているクラスターがありません。

「ライブ」 をクリックして、ライブ・モードのクラスターと名前空間があるかどうかを確認します。リストされていない場合は、 Instana エージェントを kubernetes にインストールする必要があります。

clusterRole 権限の欠落

モニター問題のタイプ: kubernetes_missing_permissions

Kubernetes クラスターを正常にモニターできるようにするには、Instana エージェントに特定のリソースに対する適切な ClusterRole 権限が必要です。 これらの権限がない場合、対応するリソースが Instana の Kubernetes ダッシュボードに表示されません。 この問題を解決するには、最新バージョンの Instana Agent YAML、 Helm チャート、または Operator をインストールします。 各インストール方式の最新バージョンについて詳しくは、 Kubernetes または OpenShiftを参照してください。

非推奨

Instana は、 Kubernetes センサーの DaemonSet、Deployment、および ReplicaSet の extensions/v1beta1 および apps/v1beta2 API バージョンのサポートを非推奨にしました。 廃止された API バージョンは、 Kubernetes v1.16で削除されました。 詳しくは、 Kubernetesからの発表を参照してください。