第1章 サポートの概要
OpenShift Container Platform クラスターの問題は、診断ツール、サポート手順、およびリモートヘルスモニタリングを使用して特定および解決できます。
1.1. サポートの利用 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat カスタマーポータルにアクセスして、ナレッジベースの記事の確認、サポートケースの作成、追加の製品ドキュメントおよびリソースの確認を行ってください。
1.2. リモートヘルスモニタリングの問題 リンクのコピーリンクがクリップボードにコピーされました!
Telemetry Client と Insights Operator を使用して、クラスターのテレメトリーと設定データを収集します。Red Hat サポートチームは、この診断情報を使用して、インフラストラクチャーの潜在的な問題をプロアクティブに特定し、解決します。
Red Hat はこのデータを使用して、接続クラスター の問題を理解し、解決します。接続クラスターと同様に、ネットワークが制限された環境でもリモートヘルスモニタリングを使用できます。OpenShift Container Platform は以下を使用してデータを収集して正常性を監視します。
Telemetry: Telemetry クライアントは、4 分 30 秒ごとにメトリクス値を収集し、Red Hat にアップロードします。Red Hat はこのデータを使用して以下を行います。
- クラスターの監視。
- OpenShift Container Platform のアップグレードのロールアウト。
- アップグレードエクスペリエンスの向上。
Insights Operator: OpenShift Container Platform は、デフォルトで Insights Operator をインストールして有効にします。この Operator は、2 時間ごとに設定とコンポーネントの障害ステータスを報告します。Insights Operator は次のことに役立ちます。
- 発生する可能性のあるクラスターの問題を事前に特定する。
- Red Hat OpenShift Cluster Manager でソリューションと予防措置を提供する。
telemetry 情報を確認できます。
リモートヘルスレポートを有効にしている場合は、Red Hat Lightspeed を使用してクラスターの問題を特定できます。必要に応じて、リモートヘルスレポートを無効にできます。
1.3. クラスターデータ収集 リンクのコピーリンクがクリップボードにコピーされました!
診断ツールとシステムログは、Red Hat Support チームがクラスターの問題をトラブルシューティングおよび解決するために必要な重要なデバッグ情報を提供します。
クラスター管理者は、以下を使用してクラスターに関するデータを収集できます。
-
must-gather ツール:
must-gatherツールを使用して、クラスターに関する情報を収集し、問題をデバッグします。 -
sosreport:
sosreportツールを使用して、デバッグ目的で設定の詳細、システム情報、および診断データを収集します。 - Cluster ID: Red Hat サポートに情報を提供する際に、クラスターの一意 ID を取得します。
-
ブートストラップノードのジャーナルログ:
bootkube.serviceのjournaldユニットログと、ブートストラップノードからコンテナーログを収集し、ブートストラップ関連の問題をトラブルシューティングします。 -
クラスターノードのジャーナルログ: ノード関連の問題をトラブルシューティングするために、個々のクラスターノード上の
journaldユニットログと/var/log内のログを収集します。 - ネットワークトレース: Red Hat サポートがネットワーク関連の問題をトラブルシューティングできるように、特定の OpenShift Container Platform クラスターノードまたはコンテナーからネットワークパケットトレースを提供します。
1.4. 問題解決 リンクのコピーリンクがクリップボードにコピーされました!
管理者は、システムの健全性を監視し、特定のトラブルシューティング手順を適用することで、OpenShift Container Platform のダウンタイムを最小限に抑えることができます。
次の手順を使用して、これらのコンポーネントのトラブルシューティングを行うことができます。
インストールの問題: OpenShift Container Platform のインストールはさまざまな段階を経て進められます。以下を実行できます。
- インストールステージの監視。
- インストールのどの段階で発生するかの判断。
- 複数のインストールの問題調査。
- 失敗したインストールからのログ収集。
ノードの問題: クラスター管理者は、ノードのステータス、リソースの使用状況、および設定を確認して、ノード関連の問題を検証およびトラブルシューティングできます。以下に対してクエリーを実行できます。
- ノード上の kubelet のステータス。
- クラスターノードジャーナルログ。
Crio の問題: クラスター管理者は、各クラスターノードで CRI-O コンテナーランタイムエンジンのステータスを確認できます。コンテナーランタイムの問題が発生した場合には、以下を実行します。
- CRI-O journald ユニットログを収集します。
- CRI-O ストレージをクリーンアップします。
オペレーティングシステムの問題: OpenShift Container Platform は Red Hat Enterprise Linux CoreOS で実行されます。オペレーティングシステムの問題が発生した場合は、カーネルクラッシュの手順を調査してください。以下の点を行うようにしてください。
- kdump が有効である。
- kdump 設定をテストする。
- コアダンプを分析する。
ネットワークの問題: クラスター管理者は以下を実行して、Open vSwitch の問題をトラブルシューティングできます。
- Open vSwitch のログレベルを一時的に設定する。
- Open vSwitch のログレベルを永続的に設定する。
- Open vSwitch のログを表示する。
Operator の問題: クラスター管理者は以下を実行して、Operator の問題を解決できます。
- Operator サブスクリプションのステータスを確認する。
- Operator Pod の正常性を確認する。
- Operator ログを収集する。
Pod の問題: クラスター管理者は、Pod のステータスを確認して以下を実行することで、Pod 関連の問題のトラブルシューティングを行うことができます。
- Pod およびコンテナーのログを確認する。
- root アクセスでデバッグ Pod を起動する。
Source-to-Image の問題: クラスター管理者は S2I ステージを確認し、S2I プロセスのどこで障害が発生したかを判断できます。Source-to-Image(S2I) の問題を解決するには、以下を収集します。
- Source-to-Image 診断データ。
- アプリケーションの障害を調査するためのアプリケーション診断データ。
ストレージの問題: 障害のあるノードがアタッチしたボリュームをアンマウントできないことが原因で、新しいノードにボリュームをマウントできない場合、マルチアタッチストレージエラーが発生します。クラスター管理者は、以下を実行して、複数アタッチされているストレージの問題を解決できます。
- RWX ボリュームを使用して、複数割り当てを有効にします。
- RWO ボリュームの使用時に障害が発生したノードを回復するか、削除します。
モニタリングの問題: クラスター管理者は、モニタリングに関するトラブルシューティングページの手順を実行してください。ユーザー定義プロジェクトのメトリクスが利用できない場合や、Prometheus が大量のディスク領域を消費している場合は、以下を確認します。
- ユーザー定義のメトリクスが利用できない理由を調べる。
- Prometheus が大量のディスク領域を消費している理由を特定する。
-
OpenShift CLI (
oc) の問題: ログレベルを増やすことで OpenShift CLI (oc) の問題を調査します。