トラブルシューティング

コマンドフラグ

診断データの収集が完了すると、このコマンドは生成されたパッケージの保存場所を表示します。

Done!
Diagnostics package ->
<output-dir>/diagnostics_<YYYYMMDDHHmmss>

--output-dirこのコマンドは、. で指定したディレクトリ内に、タイムスタンプ付きのディレクトリを作成します。

収集される情報

診断エンジンは、以下のコレクターを実行します。

• クラスタスコープの Kubernetes リソース

  このエンジンは、クラスタスコープの Kubernetes リソースを収集します。これには以下が含まれます：

  • ノード
  • 名前空間
  • ClusterRoles
  • ClusterRoleBindings
  • StorageClasses
  • PersistentVolumes
  • CustomResourceDefinitions (CRD)
  • その他のクラスタースコープのリソース
• ホストのネットワーク情報

  このエンジンは、ホストのネットワーク情報を収集します。これには以下が含まれます：

  • ルーティング・テーブル
  • ネットワーク・インターフェース
  • iptables のルール
  • sysctl のネットワーク関連パラメータ
  • 接続情報
• Envoy 診断

  このエンジンは、 Instana のCoreロードバランサーポッドから Envoy の診断情報を収集します。これには以下が含まれます：

  • クラスター統計
  • リスナーの設定
  • 経路
  • 正常性情報
• 名前空間付き Kubernetes リソース

  このエンジンは、以下のものを含め、すべての Instana ネームスペースにわたる、ネームスペース付きの Kubernetes リソースを収集します

  • ポッド数
  • デプロイメント数
  • StatefulSets
  • サービス
  • ConfigMaps
  • 秘密（数値は伏せられています）
  • イベント
  • ReplicaSets
  • DaemonSets
  • PersistentVolumeClaims
  • HorizontalPodAutoscalers
  • カスタム・リソース
• ノードレベルの情報

  このエンジンは、一時的な DaemonSet を展開して、以下のようなノードレベルの情報を収集します

  • CPU
  • メモリー
  • ディスクのトポロジー
  • カーネルおよびOSのバージョン
  • マウント・ポイント
  • ディスク使用率
  • sysctlの設定
  • dmesg の出力

  一時的なノードコレクター DaemonSet は、ワイルドカード許容設定を適用するため、エンジンはコントロールプレーンノード、インフラストラクチャノード、専用データストアノード、GPUノード、および任意のカスタムテインテッドノードを含め、クラスター内のすべてのノードから診断情報を収集します。 この動作は自動的に行われるため、追加のフラグは必要ありません。

• Instana バックエンドの診断

  このエンジンは、 Instana のバックエンド診断情報を収集します。これには以下が含まれます：

  • 健康エンドポイントの反応
  • 内部指標
  • Podのリソース使用状況
• Kafka 診断

  このエンジンは、 Kafka の診断情報を収集します。これには以下が含まれます：

  • トピック一覧
  • コンシューマー・グループのラグ
  • ブローカー構成
  • Kafka カスタムリソースのステータス
• Cassandra 診断

  このエンジンは、 Cassandra の診断情報を収集します。これには以下が含まれます：

  • nodetool status の出力結果
  • nodetool info の出力結果
  • 表統計
  • CQLの検証結果
• Elasticsearch 診断

  このエンジンは、 Elasticsearch の診断情報を収集します。これには以下が含まれます：

  • クラスターの正常性
  • インデックスの統計
  • シャードの割り当て
  • Elasticsearch カスタムリソースのステータス
• BeeInstana 診断

  このエンジンは、 BeeInstana の診断情報を収集します。これには以下が含まれます：

  • アグリゲーターのログ
  • インジェスターのログ
  • Monconfigのログ
  • BeeInstana カスタムリソースのステータス
  • 内部指標
• Kubernetes ノードレベルのサービスログ

  このエンジンは、マネージドクラウドプラットフォームを含む、標準的な Kubernetes ディストリビューションのノードレベルのサービスログを収集します。 例：

  • kubelet
  • containerd
  • Docker 実行時間（該当する場合）
• OpenShift-specific プラットフォームサービスのログ

  このエンジンは、 Kubernetes のノードレベルのサービスログに加え、 OpenShift-specific プラットフォームのサービスログも収集します。 例：

  • CRI-O
  • OpenShift API サーバー
  • マシン設定デーモン
  • その他のプラットフォームコンポーネント
  注：non-OpenShift クラスタでは、このコレクタは出力を生成せずに終了します。
• 詳細デバッグ用スクリプト（ --deep-debug) が必要）

  --deep-debugを有効にすると、標準の収集が完了した後、エンジンが追加のディープデバッグスクリプトを実行します。 例：

  • 拡張ネットワーク診断
  • データストアの詳細検査

デフォルトの名前空間

診断エンジンは、以下のデフォルトのネームスペースを使用します。

エンジンは、クラスターからCoreおよびUnitのネームスペースを自動的に検出します。

環境変数リファレンス

設定は、環境変数を直接指定するか、または フラグを --env-file 指定してファイルを .env 渡すことで指定できます。 デフォルト値が「自動検出」と記載されている場合、エンジンは関連するネームスペース内の Kubernetes のシークレットからその値を読み取ります。

ClickHouse

PostgreSQL

BeeInstana

Elasticsearch

Cassandra

Kafka

コアとエージェント

バックエンドの API の認証情報

Dockerレジストリー

.env ファイルの例

デフォルトの設定値を上書きするためのファイル .env を作成します。

CLICKHOUSE_NAMESPACE=my-clickhouse
KAFKA_NAMESPACE=my-kafka

CLICKHOUSE_ADMIN_USER=clickhouse_operator_user
CLICKHOUSE_ADMIN_PASSWORD=s3cr3t

CLICKHOUSE_WINDOW_HOURS=48

CASSANDRA_POD_SELECTOR=app=instana-cassandra,tier=database

オーバーライドファイルを使用して、次のコマンドを実行してください：

kubectl-instana diagnostics \
  --download-key <download-key> \
  --env-file ./my-overrides.env

このような状況が発生したとき

トラブルシューティングの方法

1. コア・シークレット内の「Sales Key」が、ユニット・シークレット内のライセンス文字列と一致していることを確認してください。 異なる場合は、正しい販売キーを使用してライセンスを再ダウンロードしてください。
2. Instana のオペレーターログを確認し、ライセンスのインポートエラーがないか確認してください：

   kubectl logs -n instana-operator deployment/instana-operator --tail=100

3. Groundskeeperのバックエンドコンポーネント、Podのステータス、およびログを確認してください：

   kubectl get pods -n instana-core | grep groundskeeper 

4. それでもライセンスの状態が「無効」と表示される場合は、 IBM のサポートまでご連絡ください。