5.4. トラブルシューティング UI プラグイン

前提条件

• cluster-admin クラスターロールを持つユーザーとしてクラスターにアクセスできる。
• OpenShift Container Platform Web コンソールにログインしている。
• Cluster Observability Operator がインストールされている。

前提条件

• cluster-admin クラスターロールを持つユーザーとして OpenShift Container Platform クラスターにアクセスできる。クラスターのバージョンが 4.17 以降の場合は、アプリケーションランチャー からトラブルシューティング UI パネルにアクセスできます。
• OpenShift Container Platform Web コンソールにログインしている。
• OpenShift Container Platform Logging がインストールされている (相関ログを視覚化する場合)。
• OpenShift Container Platform Network Observability がインストールされている (相関ネットフローを視覚化する場合)。
• Cluster Observability Operator がインストールされている。

• Cluster Observability Operator トラブルシューティング UI プラグインがインストールされている。

  注記

  トラブルシューティングパネルは、クラスターにインストールされている可観測性シグナルストアに依存します。Kubernetes リソース、アラート、およびメトリクスは、OpenShift Container Platform クラスターで常にデフォルトで使用できます。以下に示すその他のシグナルタイプを使用するには、オプションのコンポーネントをインストールする必要があります。

  • ログ: Red Hat Openshift Logging (コレクション) および Red Hat が提供する Loki Operator (ストア)
  • ネットワークイベント: Red Hat が提供する Network Observability (コレクション) と Red Hat が提供する Loki Operator (ストア)

  手順

  1. Web コンソールの Administrator パースペクティブで、Observe Alerting に移動し、アラートを選択します。アラートに相関項目があると、アラート詳細ページのグラフの上に Troubleshooting Panel リンクが表示されます。

     

     Troubleshooting Panel リンクをクリックしてパネルを表示します。

  2. パネルは、クエリーの詳細とクエリー結果のトポロジーグラフで構成されています。選択したアラートは、Korrel8r クエリー文字列に変換され、korrel8r サービスに送信されます。結果は、返されたシグナルとリソースを結ぶグラフネットワークとして表示されます。これは、現在のリソースから始まり、開始点から最大 3 ステップ離れた関連オブジェクトを含む 近傍 グラフです。グラフ内のノードをクリックすると、それらのリソースに対応する Web コンソールページに移動します。

  3. トラブルシューティングパネルを使用して、選択したアラートに関連するリソースを見つけることができます。

     注記

     ノードをクリックすると、グラフに表示されているよりも少ない結果が表示される場合があります。これは既知の問題であり、今後のリリースで対処される予定です。

     
     1. Alert (1): このノードはグラフの開始点です。Web コンソールに表示される KubeContainerWaiting アラートを表します。
     2. Pod (1): このノードは、このアラートに関連付けられた Pod リソースが 1 つあることを示しています。このノードをクリックすると、コンソール検索が開き、関連する Pod が直接表示されます。
     3. Event (2): Pod に関連付けられた Kuberenetes イベントが 2 つあります。このノードをクリックすると、イベントが表示されます。
     4. Logs (74): この Pod には 74 行のログがあります。このノードをクリックすると、ログにアクセスできます。
     5. Metrics (105): Pod に関連付けられたメトリクスが多数あります。
     6. Network (6): 複数のネットワークイベントがあります。これは、Pod がネットワーク経由で通信したことを示しています。グラフ内の残りのノードは、Pod が通信した Service、Deployment、DaemonSet リソースを表しています。
     7. Focus: このボタンをクリックすると、グラフが更新されます。デフォルトでは、グラフ内のノードをクリックしてもグラフ自体は変わりません。代わりに、メインの Web コンソールページが変更され、ページ上のリンクを使用して他のリソースに移動できるようになります。トラブルシューティングパネル自体は、開いたまま変更されません。トラブルシューティングパネルのグラフを強制的に更新するには、Focus をクリックします。すると、Web コンソールの現在のリソースを開始点として使用して、新しいグラフが描画されます。

     8. Show Query: このボタンをクリックすると、いくつかの実験的な機能が有効になります。

        
        1. Hide Query をクリックすると、実験的な機能が非表示になります。
        2. グラフの開始点を示すクエリー。グラフの作成に使用される Korrel8r 相関エンジンの一部であるクエリー言語は、実験段階であり、今後変更される可能性があります。Focus ボタンを押すと、メインの Web コンソールウィンドウ内のリソースに合わせてクエリーが更新されます。

        3. Neighbourhood depth は、表示する近傍の数を増減するために使用します。

           注記

           大規模なクラスターで大きな値を設定すると、結果の数が多すぎる場合にクエリーが失敗する可能性があります。

        4. Goal class を選択すると、近傍検索ではなく目標指向型の検索になります。目標指向型の検索では、開始点から目標クラスまでのすべてのパスが表示されます。目標クラスは、リソースまたはシグナルの種類を示します。目標クラス形式は実験的なものであり、変更する可能性があります。現在、次の目標が有効です。

           • k8s:RESOURCE[VERSION.[GROUP]] は、kuberenetes リソースの種類を示します。たとえば、k8s:Pod や k8s:Deployment.apps.v1 です。
           • alert:alert は、アラートを表します。
           • metric:metric は、メトリクスを表します。
           • netflow:network は、ネットワークの可観測性ネットワークイベントを表します。
           • log:LOG_TYPE は、保存されたログを表します。LOG_TYPE は、application、infrastructure、または audit のいずれかである必要があります。