Automation Suite 診断ツールを使用する

概要

Automation Suite に問題が発生したときに、まず最初に使用するのが Automation Suite 診断ツールです。診断ツールでは、さまざまな必須コンポーネントの正常性をチェックし、統合されたレポートを提供します。

注:

Automation Suite 診断ツールは、次の方法で入手できます。

• as-installer.zip インストーラー パッケージを解凍する
• supportability-tools.zip をダウンロードする

Automation Suite 診断ツールを実行する前に、インストーラー フォルダーに移動します。インストーラーは、次の場所、またはインストーラーをダウンロードした任意の場所にあります。

cd /opt/UiPathAutomationSuite/{version}/installer

Automation Suite 診断ツールの使用を開始するには、次のコマンドを実行します。

./Support-Tools/diagnostics-tool/diagnostics-report.sh

次の表に、Automation Suite 診断ツールで実行するチェックを示します。スクリプトは、クラスター内の任意のノードでも、外部からでも実行できます。

ノード	Checks (小切手)
マスター ノード	必要なサービスが実行中かどうかを確認します。 ディスク サイズが適切に構成されているかどうかをテストします。 他のサービスの正常性を収集する Kubernetes ジョブを実行します。
エージェント ノード	必要なサービスがノード上で実行されているかどうかを確認します。 ディスク サイズが適切に構成されているかどうかをテストします。
外部マシン	サービスの正常性を収集する Kubernetes ジョブを実行します。 注: 外部マシンからスクリプトを実行するには、まず適切な kubeconfig コンテキストをクラスターに設定してから、-e フラグをスクリプト bash diagnostics-report.sh -e に渡します。

Automation Suite 診断ツールによって生成されたサンプル レポートが表示されます。

診断レポートを読む

INFO ログ

緑色の INFO ログは、必要なチェックに合格したことを示します。ただし、それでも、隠れたエラーを回避するためにディスク/メモリの使用状況を正しくチェックする必要があります。

WARN メッセージ

このようなメッセージは高いリスクを示しているわけではありませんが、場合によっては修正が必要です。特定の状況において、何らかのサービスに影響が生じる可能性があります。

エラー メッセージ

このようなメッセージで示される問題はクラスター内のサービスに影響するので、修正する必要があります。

Rke2-server または Rke2-agent サービスが停止している

これらのサービスが停止している場合は、ノードが停止しています。<service-name> を使用してサービスを再実行してください。これによって問題が修正されます。

/var/lib にマウントされているディレクトリ サイズ

レポートには、Kubernetes がデータの格納に使用している、/var/lib にマウントされているディレクトリのサイズが表示されます。ディレクトリがいっぱいの場合は、さまざまな問題が発生する可能性があります。こうした問題を回避するには、このサイズを大きくしてください。

Rke2 のバージョン

レポートには、rke2 のバージョンが参考のために表示されます。

ディスク圧迫またはメモリ圧迫

すべてのノードについて、そのノードがディスク圧迫かメモリ圧迫なのかを指定します。そのようになると、こうしたノードでのワークロードに問題が出始める可能性があります。こうしたノードで実行中の他のプロセスがリソースを消費していないかどうかを確認し、該当するプロセスがあれば削除します。

Ceph サービスのステータス

UiPath では、さまざまなアプリケーションからのログやファイルを保存する S3 オブジェクト ストレージとして、Ceph を使用します。Ceph のサービスのステータスは表示することができます。サービスが停止している場合は、再実行が必要になることがあります。Ceph によるディスク使用量がフルになっていないかどうかも確認してください。

ポート 443 および 31443

ポート 443 と 31443 は、指定されたホスト名で開かれている必要があります。レポートには、これらのポートがアクセス不可であるかどうかが示されます。ここでアクセスできないことが指摘された場合、適切なポートを開いてください。

証明書の有効性

このツールは、アップロードされた証明書が指定のホスト名で有効かどうか、有効期限が切れていないかどうかをチェックします。証明書がこれらの基準を満たしていない場合、エラーが発生します。この問題を回避するには、アップロードされた証明書をチェックし、必要に応じて変更します。

GPU

サービスによっては、クラスター内の一部のノードに GPU が存在する必要があります。したがって、GPU ノードがあるかどうかを Automation Suite 診断ツールがチェックし、該当するノードの数を出力します。GPU ノードが存在すると予想されるものの、ここに表示されない場合は、GPU のセットアップに何らかの問題があります。

RabbitMQ と DockerRegistry

RabbitMQ と DockerRegistry は、一部のサービスで使用される 2 つの重要なコンポーネントです。どちらか 1 つでも停止している場合は、問題を調査し、再起動する必要があります。

ArgoCD サービスの停止

ArgoCD は、アプリケーション ライフサイクル管理 (ALM) ツールです。そのいずれかのサービスが停止している場合、他のアプリケーションが古くなっているか、他の問題が発生している可能性があります。こうしたサービスの回復は重要であり、場合によってはさらなるデバッグが必要になります。

存在しないか、機能が低下している ArgoCD アプリケーション

Automation Suite 診断ツールは、ArgoCD アプリケーションが見つからないかどうか、および機能低下していないかどうかを示します。

• アプリケーションが見つからない場合は、ArgoCD UI に移動し、これを同期します。
• アプリケーションが機能低下している場合は、ArgoCD がスローするエラーを調査するために追加のデバッグが必要です。