トラブルシューティングの概要

特定の分野を詳しく調べる前に、このページを利用してCubeCOSの課題の優先順位付けを行ってください。 まずは以下のクラスター全体の正常性チェックから始め、その後、影響を受けるワークロードに関するガイドに進んでください。

始める前に

以下のセクションで説明する一部の確認作業では、admin ユーザーとして CubeCOS クラスターの仮想 IP (VIP) への SSH アクセス、またはコントローラーノード上の OpenStack CLI へのアクセスが必要となります。 アクセス権がない場合は、プラットフォーム管理者にアクセス権を依頼してください。

クラスタ全体の正常性を確認する

まずはクラスタ全体の正常性チェックから始めましょう。 多くのインスタンス、ネットワーク、およびストレージの問題は、ここで報告されているサービスに起因しています。

• Web UI：ダッシュボードのヘルスインジケーターパネルを確認してください。 エラーが表示された場合は、[修復] をクリックして、自動修復を実行してください。

• CLI: SSHでVIPにログインし、cluster check_repairを実行してください。

  Check cluster service health

  ssh admin@<cluster-vip>

  Run a service health check

  controller> cluster check_repair

  各行には、サービス（例：Network、Compute、Storage）と、ステータス（ok または FIXING）が記載されています。 FIXING 行では、括弧内に障害が発生したコンポーネントが明記されます。たとえば、ネットワークの問題の場合は neutron(3)、コンピューティングの問題の場合は nova(8) といった具合です。

  コマンドの出力の全内容および各サービスの説明については、Web UI または CLI を使用した CubeCOS サービスの監視と修復 を参照してください。

ログとイベントの確認

クラスタのヘルスチェックで問題の原因が特定できない場合は、影響を受けているリソースのログを確認してください。

• インスタンスのアクションログ：[Compute] > [インスタンス] に移動し、対象のインスタンスを選択して、[アクションログ] タブを開き、調査したいイベントの [分析] をクリックします。
• クラスタ全体のログ検索：http://<cluster-vip>:5601/opensearch-dashboards/app/data-explorer/discover にアクセスして、すべての CubeCOS サービスにわたるログを検索します。

詳細については、CubeCOS におけるログ分析を参照してください。

既存のアラートを確認する

イベント > トリガー に移動し、既存のトリガーがすでにこの問題を検知しているかどうかを確認し、そのトリガーから送信された通知を確認してください。 詳細については、トリガーの管理を参照してください。