診断ツールを実行する

Automation Suite 診断ツールを実行してクラスターの健全性レポートを生成し、データベースや資格情報のエラーなどの問題を特定します。

Automation Suite 診断ツールは、一連のチェックを実行してクラスターの健全性に関するレポートを生成します。このレポートを分析することで、問題および考えられる根本原因を特定できます。このツールは、データベースの接続が失われた、資格情報が無効または期限切れであるといった一般的な問題の特定に役立ちます。

Automation Suite 診断ツールは、uipathctl と uipathtools の両方で利用でき、管理マシンにダウンロードできます。

ダウンロード手順については、「 uipathctl 」および「 uipathtools」をご覧ください。

uipathtools は、健全性コマンドに固有の uipathctl 機能のサブセットを含む CLI ツールです。このツールには後方互換性があり、サポートされているすべての Automation Suite バージョンで動作します。問題が発生した場合は、uipathtools を第一段階として使用することをお勧めします。

前提条件と健全性のチェック/テストは、uipath-check の名前空間で実行されます。チェック/テストを実行する前に、uipath-check の名前空間の作成を許可するか、自分で名前空間を作成する必要があります。さらに、一部のチェック/テストでは、uipath-check と uipath の名前空間同士の通信を許可するか、hostNetwork の使用を有効化する必要があります。

クイック検証

クイック検証

check コマンドと test コマンドを使用すると、詳細分析を実行することなくクラスターのステートに対する洞察を素早く得ることができます。

• check は ArgoCD の健全性と同期ステータスに依存しており、クラスターのステートを一切変更しません。
• test は、アプリケーション、デプロイ、ポッドを調べ、クラスターのステートを一時的に変更して洞察を提供します。

健全性チェック

健全性チェックを実行するには、使用するCLIツールに応じて、次のいずれかのコマンドを使用します。

• uipathctl を使用する場合は、次のコマンドを実行します。

  ./uipathctl health check
  

• uipathtools を使用する場合は、次のコマンドを実行します。

  ./uipathtools health check
  

注:

input.jsonを指定しない場合は、--namespace フラグ (任意) を使用します。フラグは、インストールが uipath 名前空間にない場合にのみ使用する必要があります。 フラグを指定しない場合、健全性チェックはすべての名前空間から診断データを取得します。

生成されるレポートの出力例:

Checks run on cluster/
 ✓ [NOTIFICATIONSERVICE]
    ✓ [NOTIFICATIONSERVICE_HEALTH] Application is healthy and in sync
 ✓ [ACTION_CENTER]
    ✓ [ACTIONCENTER_HEALTH] Application is healthy and in sync
 ❌ [SYNC]
    ❌ [namespace:"argocd" | kind:"Application" | name:"dataservice"] Application health check failed: health status is Progressing and sync status is Synced
 ✓ [RELOADER]
    ✓ [RELOADER_HEALTH] Application is healthy and in sync
 ❌ [POD]
    ✓ [LIST_NAMESPACES] Retrieved 25 namespaces to check pod health
    ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-runtime-8f5bb7d56-v5krg cannot mount volume: MountVolume.SetUp failed for volume "external-storage-creds" : secret "dataservice-external-storage-secret" not found
    ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-runtime-8f5bb7d56-xs9t5 cannot mount volume: MountVolume.SetUp failed for volume "external-storage-creds" : secret "dataservice-external-storage-secret" not found
    ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-taskrunner-787df76c74-98h5l cannot mount volume: MountVolume.SetUp failed for volume "external-storage-creds" : secret "dataservice-external-storage-secret" not found
 ✓ [ISTIO]
    ✓ [LIST_PODS] Found 2 pods for Istio
    ✓ [ISTIOD_EXISTS] The Istio pods are present and running version - 
    ✓ [ISTIOD_READY] Istio pods are healthy
 ✓ [AIEVENTS]
    ✓ [AIEVENTS_HEALTH] Application is healthy and in sync
 ❌ [DATASERVICE]
    ❌ [DATASERVICE_HEALTH] Application health check failed: health status is Progressing and sync status is Synced
 ✓ [PLATFORM]
    ✓ [PLATFORM_HEALTH] Application is healthy and in sync
 ✓ [TASK_MINING]
    ✓ [TASKMINING_HEALTH] Application is healthy and in sync
 ✓ [LOGGING]
    ✓ [LOGGING_HEALTH] Application is healthy and in sync
 ✓ [WEBHOOK]
    ✓ [WEBHOOK_HEALTH] Application is healthy and in sync

既定では、uipathctl health check コマンドはすべてのコンポーネントの健全性を確認します。ただし、関心のあるコンポーネントのみを確認することもできます。

• コンポーネントを実行から除外するには、--excluded フラグを使用します。たとえば SQL の健全性を確認しない場合は、uipathctl health check --excluded SQL を実行します。このコマンドは、SQL を除くすべてのコンポーネントの健全性を確認します。
• 特定のコンポーネントのみを実行時に含めるには、 --included フラグを使用します。たとえば、DNS と ObjectStore の健全性のみを確認する場合は、uipathctl health check --included DNS,OBJECTSTORAGE を実行します。
  注:

  健全性の確認に含められる/除外できるコンポーネントの名前はこちらをご覧ください。この例では、アウトデントされている各行の最初の単語がコンポーネント名を表しています。例: SQL、OBJECTSTORE、DNS など。

ログを分析する

1. 健全性チェックの実行後、ログに、Data Service アプリケーションの健全性チェックが失敗したことが示されます。

   ❌ [DATASERVICE]
       ❌ [DATASERVICE_HEALTH] Application health check failed: health status is Progressing and sync status is Synced
   

2. 詳しく調べると、Data Service アプリケーションが失敗した理由は、dataservice-runtime-8f5bb7d56-v5krg ポッドと dataservice-taskrunner-787df76c74-98h5l ポッドが「失敗」ステートであることが明らかになります。さらに分析すると、dataservice-external-storage-secret が見つからないことがわかります。

   ❌ [POD]
       ✓ [LIST_NAMESPACES] Retrieved 25 namespaces to check pod health
       ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-runtime-8f5bb7d56-v5krg cannot mount volume: MountVolume.SetUp failed for volume "external-storage-creds" : secret "dataservice-external-storage-secret" not found
       ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-runtime-8f5bb7d56-xs9t5 cannot mount volume: MountVolume.SetUp failed for volume "external-storage-creds" : secret "dataservice-external-storage-secret" not found
       ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-taskrunner-787df76c74-98h5l cannot mount volume: MountVolume.SetUp failed for volume "external-storage-creds" : secret "dataservice-external-storage-secret" not found
   

3. この問題を修正するには、 input.jsonで ObjectStore に正しい資格情報を指定していることを確認します。詳しくは、「 資格情報の更新」をご覧ください。

健全性テスト

健全性テストを実行するには、使用するCLIツールに応じて、次のいずれかのコマンドを使用します。

• uipathctl を使用する場合は、次のコマンドを実行します。

  ./uipathctl health test
  

• uipathtools を使用する場合は、次のコマンドを実行します。

  ./uipathtools health test
  

注:

input.jsonを指定しない場合は、--namespace フラグ (任意) を使用します。フラグは、インストールが uipath 名前空間にない場合にのみ使用する必要があります。

生成されるレポートの出力例:

Checks run on cluster/
 ✓ [GATEKEEPER]
    ✓ [CREATE_CONSTRAINT] Created test constraint
    ✓ [VERIFY] Constraint verified
    ✓ [CLEANUP] Cleaned up the test constraint
 ✓ [ACTION_CENTER]
    ✓ [CREATE_NAMESPACE] Created namespace prereqk6b72
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqk6b72
    ✓ [CREATE_NAMESPACE] Created namespace prereqbxjx8
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqbxjx8
    ✓ [CREATE_NAMESPACE] Created namespace prereq8zvw4
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereq8zvw4
 ✓ [DATASERVICE]
    ✓ [CREATE_NAMESPACE] Created namespace prereqxwlsb
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqxwlsb
    ✓ [CREATE_NAMESPACE] Created namespace prereq5szsn
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereq5szsn
 ✓ [APPS]
    ✓ [CREATE_NAMESPACE] Created namespace prereq9z6nb
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereq9z6nb
    ✓ [CREATE_NAMESPACE] Created namespace prereq6v7lm
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereq6v7lm
    ✓ [CREATE_NAMESPACE] Created namespace prereqxxn5v
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqxxn5v
 ✓ [AUTOMATION_HUB]
    ✓ [CREATE_NAMESPACE] Created namespace prereq4jkbt
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereq4jkbt
 ✓ [TEST_MANAGER]
    ✓ [CREATE_NAMESPACE] Created namespace prereqnvvpc
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqnvvpc
 ✓ [ORCHESTRATOR]
    ✓ [CREATE_NAMESPACE] Created namespace prereq8pf2f
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereq8pf2f
    ✓ [CREATE_NAMESPACE] Created namespace prereq4w4v4
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereq4w4v4
    ✓ [CREATE_NAMESPACE] Created namespace prereqkzwqg
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqkzwqg
 ✓ [INSIGHTS]
    ✓ [CREATE_NAMESPACE] Created namespace prereqqmgjc
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqqmgjc
    ✓ [CREATE_NAMESPACE] Created namespace prereq4vnjx
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereq4vnjx
    ✓ [CREATE_NAMESPACE] Created namespace prereqgtg9g
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqgtg9g
 ✓ [AUTOMATION_OPS]
    ✓ [CREATE_NAMESPACE] Created namespace prereqgkkrz
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqgkkrz
 ✓ [AICENTER]
    ✓ [CREATE_NAMESPACE] Created namespace prereqdls88
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqdls88
    ✓ [CREATE_NAMESPACE] Created namespace prereq6m7x9
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereq6m7x9

既定では、uipathctl health test コマンドはすべてのコンポーネントに対して健全性のテストを実行します。ただし、関心のあるコンポーネントのみを確認することもできます。

• コンポーネントを実行から除外するには、--excluded フラグを使用します。たとえば SQL の健全性を確認しない場合は、uipathctl health test --excluded SQL を実行します。このコマンドは、SQL を除くすべてのコンポーネントの健全性を確認します。
• 特定のコンポーネントのみを実行時に含めるには、 --included フラグを使用します。たとえば、DNS と ObjectStore の健全性のみを確認する場合は、uipathctl health test --included DNS,OBJECTSTORAGE を実行します。
  注:

  健全性のテストに含められる/除外できるコンポーネントの名前はこちらをご覧ください。この例では、アウトデントされている各行の最初の単語がコンポーネント名を表しています。例: SQL、OBJECTSTORE、DNS など。

注:

Data Service アプリケーションに対する check コマンドと test コマンドの出力を比較すると、前者がアプリケーションの健全性を検証するのに対し、後者はルーティングを確認することがわかります。

既知の問題

次のサンプルのようなエラー メッセージが表示されることがあります。ユーザー側での操作は不要であるため、無視してかまいません。

E0621 23:32:56.426321   24470 reflector.go:138] external/io_k8s_client_go/tools/cache/reflector.go:167: Failed to watch *v1.Pod: context deadline exceeded
E0621 23:32:56.426392   24470 reflector.go:138] external/io_k8s_client_go/tools/cache/reflector.go:167: Failed to watch *v1.Pod: context deadline exceeded
E0621 23:32:56.444420   24470 reflector.go:138] external/io_k8s_client_go/tools/cache/reflector.go:167: Failed to watch *v1.Pod: context deadline exceeded
E0621 23:32:56.446150   24470 reflector.go:138] external/io_k8s_client_go/tools/cache/reflector.go:167: Failed to watch *v1.Pod: context deadline exceeded
E0621 23:32:56.513357   24470 reflector.go:138] external/io_k8s_client_go/tools/cache/reflector.go:167: Failed to watch *v1.Pod: context deadline exceeded

詳細な検証

詳細な検証

diagnose コマンドを使用すると、クラスターのステートに関する詳細な洞察が得られます。SQL、ObjectStore、ノード、シークレット、Istio、ネットワークなど、あらゆるレベルの問題を特定するのに役立ちます。

• check コマンドと test コマンドの両方をカバーしています。
• Automation Suite のインストール前に実行される前提条件の確認を実行し、インストール後に環境の構成に加えられた変更と、問題の原因と考えられる変更を検証します。
• すべてのノードで実行され、ノード固有の問題 (リソースが利用不可、ネットワークの干渉など) を収集します。

診断チェックを実行するには、使用するCLIツールに応じて、次のいずれかのコマンドを使用します。

• uipathctl を使用する場合は、次のコマンドを実行します。

  ./uipathctl health diagnose input.json --versions version.json
  

• uipathtools を使用する場合は、次のコマンドを実行します。

  ./uipathtools health diagnose input.json --versions version.json
  

注:

input.jsonを指定しない場合は、--namespace フラグ (任意) を使用します。フラグは、インストールが uipath 名前空間にない場合にのみ使用する必要があります。 フラグを指定しない場合、診断データはすべての名前空間から取得されます。

生成されるレポートの出力例:

Checks run on nodes/aks-pool0-27031798-vmss000001
 ✓ [REDIS(PORT=6380)]
    ✓ [CONNECTIVITY] Successfully made Redis connection on ci-asaks4011056.redis.cache.windows.net:6380
 ✓ [OBJECTSTORAGE(PRODUCT=ORCHESTRATOR)]
    ✓ [CHECK_API] Object storage test passed for orchestrator
 ✓ [SQL(PRODUCT=PROCESSMINING, TYPE=ADO)]
    ✓ [EXECUTE_NATIVE] Successfully executed command
    ✓ [BUILD_CLIENT] Successfully built ADO client
    ✓ [CONNECT] Successfully connected ADO client to DB
    ✓ [DB_ROLES] SQL user has the required roles to DB
 ✓ [DNS(FQDN=INSIGHTS.<FQDN>)]
    ✓ [VALIDATE_FQDN] FQDN is valid
    ✓ [RESOLVE_SUBDOMAIN] Resolved insights.ci-asaks4011056.infra-sf-ea.infra.uipath-dev.com to [{20.71.155.129 }]
    ✓ [IPS_MATCH] Subdomain resolves to top domain
 ✓ [DNS(FQDN=ALM.<FQDN>)]
    ✓ [VALIDATE_FQDN] FQDN is valid
    ✓ [RESOLVE_SUBDOMAIN] Resolved alm.ci-asaks4011056.infra-sf-ea.infra.uipath-dev.com to [{20.71.155.129 }]
    ✓ [IPS_MATCH] Subdomain resolves to top domain
 Checks run on cluster/
 ✓ [NODE]
    ✓ [NODE_EXISTS] 12 Nodes present in the cluster
    ✓ [NODE_READY] All the nodes are in ready state
 ✓ [GATEKEEPER]
    ✓ [GATEKEEPER_HEALTH] Application is healthy and in sync
    ✓ [CREATE_CONSTRAINT] Created test constraint
    ✓ [VERIFY] Constraint verified
    ✓ [CLEANUP] Cleaned up the test constraint
 ✓ [LOGGING]
    ✓ [LOGGING_HEALTH] Application is healthy and in sync
 ✓ [DATASERVICE]
    ✓ [CREATE_NAMESPACE] Created namespace prereqctzhp
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqctzhp
 ✓ [ROBOTUBE]
    ✓ [ROBOTUBE_HEALTH] Application is healthy and in sync
 ✓ [AIRFLOW]
    ✓ [AIRFLOW_HEALTH] Application is healthy and in sync
 ✓ [ARGOCD]
    ✓ [ARGOCD_SERVER_PODS] Component argocd-server has ready Pods
    ✓ [ARGOCD_REPO_SERVER_PODS] Component argocd-repo-server has ready Pods
    ✓ [ARGOCD_APP_CONTROLLER_PODS] Component argocd-application-controller has ready Pods
    ✓ [ARGOCD_REDIS_PODS] Component redis-ha has ready Pods
 ✓ [ISTIO]
    ✓ [LIST_PODS] Found 2 pods for Istio
    ✓ [ISTIOD_EXISTS] The Istio pods are present and running version - 
    ✓ [ISTIOD_READY] Istio pods are healthy
 ✓ [AICENTER]
    ✓ [AICENTER_HEALTH] Application is healthy and in sync
    ✓ [CREATE_NAMESPACE] Created namespace prereqn6sqn
    ✓ [CREATE_POD] Created test pod curl-pod in namespace prereqn6sqn
Checks run on local/
 ✓ [CONNECTIVITY]
    ✓ [OVERLAY_CONNECTIVITY_TEST] echo-a-4rffj on aks-pool0-27031798-vmss000002 can reach echo-a-4rffj's IP 10.240.1.86 on aks-pool0-27031798-vmss000002
    ✓ [OVERLAY_CONNECTIVITY_TEST] echo-a-4rffj on aks-pool0-27031798-vmss000002 can reach echo-a-8c6t5's IP 10.240.3.57 on aks-pool3-27031798-vmss000000
    ✓ [POD_TO_A] Scenario: http check between two random pods completed successfully
    ✓ [POD_TO_B_MULTI_NODE_CLUSTERIP] Scenario: http check between from pod to a multinode ClusterIP completed successfully
    ✓ [POD_TO_B_MULTI_NODE_HEADLESS] Scenario: http check between from pod to a multinode ClusterIP without a clusterIP set completed successfully
    ✓ [POD_TO_B_INTRA_NODE_CLUSTERIP] Scenario: http check between from two pods colocated on the same node via ClusterIP completed successfully
 ✓ [INGRESS]
    ✓ [INGRESS_GATEWAY_FOUND] Found service istio-ingressgateway in the cluster
    ✓ [INGRESS_GATEWAY_PORT_CHECK] Service istio-ingressgateway is configured to allow traffic on http://ci-asaks4011056.infra-sf-ea.infra.uipath-dev.com
    ✓ [INGRESS_GATEWAY_PORT_CHECK] Service istio-ingressgateway is configured to allow traffic on https://ci-asaks4011056.infra-sf-ea.infra.uipath-dev.com:443
 ✓ [OSS(COMPONENT=MONITORING)]
    ✓ [OSS(component=monitoring)] Check for component monitoring passed
 ✓ [OSS(COMPONENT=GATEKEEPER)]
    ✓ [OSS(component=gatekeeper)] Check for component gatekeeper passed
 ✓ [STORAGECLASS(NAME=STORAGE_CLASS_SINGLE_REPLICA)]
    ✓ [STORAGE_CLASS_EXISTS] Storage class azurefile-csi exists
    ✓ [LIST_NODES] Listed 12 nodes
    ✓ [CREATE_NAMESPACE] Created namespace prereqhcpkc
    ✓ [CREATE_STATEFULSET] Created statefulset storage-class-check-5n272
    ✓ [LIST_PODS] Listed 1 pods on node aks-pool3-27031798-vmss000001
    ✓ [POD_RUNNING] Found one pod running on node aks-pool3-27031798-vmss000001
 ✓ [REGISTRY]
    ✓ [CONNECTIVITY] Successfully made Registry connection on sfbrdevhelmweacr.azurecr.io
 ✓ [NETWORK-POLICIES]
    ✓ [CREATE_NAMESPACE] Namespace prereqw4t9b created
    ✓ [CREATE_EGRESS_NETWORK_POLICY] Created the egress network policies allow-coredns-egress and block-external-traffic
    ✓ [CREATE_INGRESS_NETWORK_POLICY] Created the ingress network policy: block-echo-server-ingress
    ✓ [CREATE_SERVICE] Service echo-server-svc created
 ✓ [STORAGECLASS(NAME=STORAGE_CLASS)]
    ✓ [STORAGE_CLASS_EXISTS] Storage class managed-premium exists
    ✓ [LIST_NODES] Listed 12 nodes
    ✓ [CREATE_NAMESPACE] Created namespace prereqgjhcb
    ✓ [CREATE_STATEFULSET] Created statefulset storage-class-check-nm9th
    ✓ [LIST_PODS] Listed 1 pods on node aks-pool0-27031798-vmss000003
    ✓ [POD_RUNNING] Found one pod running on node aks-pool0-27031798-vmss000003
    ✓ [LIST_PODS] Listed 1 pods on node aks-pool0-27031798-vmss000001
    ✓ [POD_RUNNING] Found one pod running on node aks-pool0-27031798-vmss000001
 ✓ [DNS(FQDN=INSIGHTS.<FQDN>)]
    ✓ [VALIDATE_FQDN] FQDN is valid
    ✓ [RESOLVE_TOP_DOMAIN] Resolved ci-asaks4011056.infra-sf-ea.infra.uipath-dev.com to [{20.71.155.129 }]
    ✓ [RESOLVE_SUBDOMAIN] Resolved insights.ci-asaks4011056.infra-sf-ea.infra.uipath-dev.com to [{20.71.155.129 }]
    ✓ [IPS_MATCH] Subdomain resolves to top domain
 ✓ [NODE(CPU >= 8, RAM >= 16GI)]
    ✓ [LIST_NODES] Listed 12 nodes
    ✓ [AT_LEAST_ONE_NODE] At least one node found
    ✓ [CPU_USAGE] Node aks-pool0-27031798-vmss000000 has 12.50% CPU usage
    ✓ [MEMORY_USAGE] Node aks-pool0-27031798-vmss000000 has 38.27% memory usage
    ✓ [POD_USAGE] Node aks-pool0-27031798-vmss000000 has 40.00% of pods in use. Number of pods: 40.00 max allowed: 100.00
 ✓ [OSS(COMPONENT=CERT-MANAGER)]
    ✓ [OSS(component=cert-manager)] Check for component cert-manager passed
 ✓ [RESOURCE]
    ✓ [Capacity] Automation suite already installed on cluster
 ✓ [OSS(COMPONENT=LOGGING)]
    ✓ [OSS(component=logging)] Check for component logging passed
 ✓ [GPU(PRODUCT=DOCUMENTUNDERSTANDING)]
    ✓ [BASIC_GPU_SUCCESS] Was able to start a CUDA job on a GPU node
Checks run on cluster/
 ❌ [DATASERVICE]
    ❌ [DATASERVICE_HEALTH] Application health check failed: health status is Progressing and sync status is Synced
 ❌ [ISTIO]
    ✓ [ISTIO_SYNC_STATUS] Istio sync is up-to-date
    ❌ [ISTIO_ENVOY_CONFIG_STATUS] Istio Envoy configs are not healthy: Error [IST0101] (VirtualService uipath/du-platform-vs) Referenced host:port not found: "aistorage:5000"
    ✓ [ISTIO_SERVICEMESH_VALIDATION_GET_REGISTRY_FQDN] Successfully retrieved registry url
    ✓ [ISTIO_SERVICEMESH_VALIDATION_GET_CLUSTER_FQDN] Successfully retrieved cluster fqdn
    ✓ [ISTIO_SERVICEMESH_VALIDATION_CREATE_TEST_DEPLOYMENT] Successfully created the test deployment istio-validation-deployment
    ✓ [ISTIO_SERVICEMESH_VALIDATION_CREATE_TEST_SERVICE] Successfully created the test service istio-validation-service
    ✓ [ISTIO_SERVICEMESH_VALIDATION_CREATE_TEST_GATEWAY] Successfully created the test gateway istio-validation-gateway
    ✓ [ISTIO_SERVICEMESH_VALIDATION_CREATE_TEST_VIRTUALSERVICE] Successfully created the test virtual service istio-validation-vs
    ✓ [ISTIO_SERVICEMESH_VALIDATION_URL_ACCESS] Success exposing the service via servicemesh
 ❌ [POD]
    ✓ [LIST_NAMESPACES] Retrieved 25 namespaces to check pod health
    ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/ah-tenant-service-sync-insights-data-job-28122960-p6rzg cannot mount volume: MountVolume.SetUp failed for volume "ah-insights-secrets" : failed to sync secret cache: timed out waiting for the condition
    ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-runtime-8f5bb7d56-v5krg cannot mount volume: (combined from similar events): Unable to attach or mount volumes: unmounted volumes=[external-storage-creds], unattached volumes=[workload-socket is-secrets openssl istio-podinfo temp-location cert-location istio-data external-storage-creds workload-certs istio-envoy java domain-cert-config edk2 credential-socket tmp additional-ca-cert-config pem istiod-ca-cert istio-token app-secrets ceph-storage-creds]: timed out waiting for the condition
    ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-runtime-8f5bb7d56-xs9t5 cannot mount volume: MountVolume.SetUp failed for volume "external-storage-creds" : secret "dataservice-external-storage-secret" not found
    ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-taskrunner-787df76c74-98h5l cannot mount volume: MountVolume.SetUp failed for volume "external-storage-creds" : secret "dataservice-external-storage-secret" not found
    ❌ [POD_UNHEALTHY] Latest event for pod uipath/du-documentmanager-dm-maintenance-cron-28122960-4sm5z: Error: failed to sync configmap cache: timed out waiting for the condition
 ❌ [SYNC]
    ❌ [namespace:"argocd" | kind:"Application" | name:"dataservice"] Application health check failed: health status is Progressing and sync status is Synced

注:

前述のサンプルはトリミングされています。実際のログには他の情報も含まれます。diagnose コマンドは、インフラストラクチャ、ネットワーク、ストレージ、ポッド、DNS など、複数のレベルで実行されます。

ログを分析する

前のログで確認できる潜在的な問題として次の 2 つがあります。

• Istio の設定が不適切である。このため、Document Understanding プラットフォームへのアクセスに問題が発生する可能性があります。

  ❌ [ISTIO]
      ✓ [ISTIO_SYNC_STATUS] Istio sync is up-to-date
      ❌ [ISTIO_ENVOY_CONFIG_STATUS] Istio Envoy configs are not healthy: Error [IST0101] (VirtualService uipath/du-platform-vs) Referenced host:port not found: "aistorage:5000"
  

• Data Service が利用不可である。コードの例で Ceph をご覧ください。

  ❌ [DATASERVICE]
      ❌ [DATASERVICE_HEALTH] Application health check failed: health status is Progressing and sync status is Synced
  ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-runtime-8f5bb7d56-v5krg cannot mount volume: (combined from similar events): Unable to attach or mount volumes: unmounted volumes=[external-storage-creds], unattached volumes=[workload-socket is-secrets openssl istio-podinfo temp-location cert-location istio-data external-storage-creds workload-certs istio-envoy java domain-cert-config edk2 credential-socket tmp additional-ca-cert-config pem istiod-ca-cert istio-token app-secrets ceph-storage-creds]: timed out waiting for the condition
      ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-runtime-8f5bb7d56-xs9t5 cannot mount volume: MountVolume.SetUp failed for volume "external-storage-creds" : secret "dataservice-external-storage-secret" not found
      ❌ [CANNOT_MOUNT_VOLUME] Pod uipath/dataservice-taskrunner-787df76c74-98h5l cannot mount volume: MountVolume.SetUp failed for volume "external-storage-creds" : secret "dataservice-external-storage-secret" not found
  

既知の問題

次のサンプルのようなエラー メッセージが表示されることがあります。ユーザー側での操作は不要であるため、無視してかまいません。

I0622 01:31:28.917107   28815 request.go:601] Waited for 1.017599292s due to client-side throttling, not priority and fairness, request: GET:https://ci-asaks4011056-fwwpyxm7.hcp.westeurope.azmk8s.io:443/apis/networking.istio.io/v1alpha3

その他のユーティリティ

その他のツール

Automation Suite 診断ツールのすべてのコマンド (check、test、diagnose) では、他のフィルター処理と出力形式もサポートされています。

フィルター処理

フィルター	説明	用途
--included	検証に含めるサービスのコンマ区切りのリストです。	/uipathctl health diagnose input.json --versions.json --included ISTIO,INSIGHTS このコマンドは、Istio と Insights に対してのみ診断を実行します。
--excluded	検証から除外するサービスの、コンマ区切りのリストです。	/uipathctl health test --excluded ISTIO,INSIGHTS このコマンドは、Istio と Insights を除くクラスター全体でテストを実行します。

出力フォーマット

Automation Suite 診断ツールでは、json、yaml、text、junit の複数の形式でレポートを生成できます。--output フラグを使用して、これらの値を任意のコマンドに渡すことができます。これらの出力形式は、各ツールを利用して独自のトラブルシューティング フレームワークを構築する場合に便利です。

使用例

使用状況	出力例
./uipathctl health check --included DATASERVICE --output json ./uipathtools health check --included DATASERVICE --output json	{ "cluster/": { "DATASERVICE": [ { "name": "DATASERVICE_HEALTH", "description": "Application health check failed: health status is Progressing and sync status is Synced", "status": "failed" } ] } }
./uipathctl health check --included DATASERVICE --output yaml ./uipathtools health check --included DATASERVICE --output yaml	? locationType: cluster : DATASERVICE: - name: DATASERVICE_HEALTH description: 'Application health check failed: health status is Progressing and sync status is Synced' status: failed
./uipathctl health check --included DATASERVICE --output text ./uipathtools health check --included DATASERVICE --output text	Checks run on cluster/ ❌ [DATASERVICE] ❌ [DATASERVICE_HEALTH] Application health check failed: health status is Progressing and sync status is Synced
./uipathctl health check --included DATASERVICE --output junit ./uipathtools health check --included DATASERVICE --output junit	<testsuite name="Health" tests="1" errors="0" failures="1" time="0" timestamp="2023-06-22T01:59:08.313362+05:30" hostname=""> <testcase name="DATASERVICE_HEALTH" classname="" time="0"> <failure message="Application health check failed: health status is Progressing and sync status is Synced" type=""> </failure> </testcase> </testsuite>