Dell Automated Platform: トラブルシューティングのためにログ バンドルを取得する方法

このツールは、オンプレミス インストール用のすべてのDell Automation Platform Kubernetesログを収集するために作成されます。また、ネイティブのKubernetesログを収集し、現在の状態のポッドの説明を収集します。システム ログとjournaldログも収集します。収集後、エンジニアリング チームに提供するtarballが作成されます。ソフトウェア アズ ア サービス(SAAS)のDell Automation Platformのインストールに使用するようには設計されていません。

このツールは、Dell Automation PlatformとKnativeのポッドをトラバースし、内部のコンテナーを一覧表示します。hzp-product-svc については、次の例を参照してください。

root@labmachine01:/nas/tools# kubectl get po -n hzp hzp-product-svc-00001-deployment-5695678c66-79zwm -o jsonpath="{.spec.containers[*].name}"
hzp-ese-svc hzp-product-svc queue-proxy hzp-iam-proxy

たとえば、ユーザーは tarball 内で次のファイル構造を取得します。

root@labmachine01:/nas/tools# tar -tf /tmp/native_edge_eo-logs_default_2023-08-30T07-13-39.750/native_edge_eo-logs_default_2023-08-30T07-13-39.750.tar.gz | grep product
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-iam-proxy.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc-00001-deployment-5695678c66-79zwm.hzp-iam-proxy-init.init.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc-00001-deployment-5695678c66-79zwm.describe
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-ese-svc.previous.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/queue-proxy.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/queue-proxy.previous.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-ese-svc.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc.previous.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-iam-proxy.previous.log

したがって、これらのファイルは次の構造で格納されます。

namespace/pod-name/namespace-container.log

使用方法:
まず、ユーザーはDell Automation Platform仮想マシンに接続してログインする必要があります。

次に、ユーザーはroot権限を有効にする必要があります(sudo -iまたは有効になっている場合はsu)。

関連するすべてのログを収集するには、この記事の「logs_pkb.zip」という添付ファイルをDell Automation Platform仮想マシンにダウンロードする必要があります。

アーカイブの内容を抽出します。

unzip logs_pkb.zip -d logs-tool

そのディレクトリーに移動し、スクリプトを実行します。

./logs.sh

実行後、使用可能なスペースに関する情報メッセージと、続行するためのプロンプトが表示されます(続行するには「y」を入力)。

This script will access your local k3s secrets (secret values are not going to be printed).
This script will collect all logs from all pods in NativeEdge-controlled namespaces and archive it in tarball.
Please press "y" if you agree with this.
You have 69G available on your storage. Consider that logs may require to have more that 1Gb of free space.

バージョン1.0-rc以降では、ログ収集ツールは、NativeEdgeまたはDell Automation Platformがデフォルト以外のネームスペースにインストールされているかどうかを検出します。ツールが標準の名前空間を見つけられない場合は、有効な Orchestrator 名前空間を入力するようにユーザーに求めます。以下の例を参照してください。

Available namespaces:
- default
- nativeedge
- kube-node-lease
- kube-public
- kube-system
- longhorn-system
- metallb-system
Warning: Namespace 'hzp' not found.
Please enter the namespace containing the 'nativeedge' containers:

デフォルトのネームスペースがインストールされている場合、このツールは、コレクションのリストに含まれているネームスペースを表示します。

Namespace 'hzp' found. Logs will be collected from following namespaces:
- hzp
- kube-system
- istio-system
- knative-eventing
- knative-serving
- longhorn-system

イベント キャプチャ:

ツールのバージョン0.9-beta以降では、EdgeOrchestrator/Dell Automation Platformイベント キャプチャーに関するプロンプトがユーザーに表示されます。

Do you want to collect the EO events (WARNING: this may require significant space on disk)?

これにより、EdgeOrchestrator/Dell Automation Platformからイベントがログtarballに直接キャプチャされ、トラブルシューティングが向上します。マシンに十分なスペースがある場合は、EdgeOrchestrator/Dell Automation Platformイベントを取得することをお勧めします。

追加の手順がある場合、ユーザーは実行する前にスクリプトの使用可能なオプションを確認できます。

./logs.sh -h

現在のバージョンは、次の方法で確認できます。

logs.sh -v

このツールは、オンプレミスのDell Automation Platformインストール バージョン1.0以降のすべてのバージョンで使用できます
このツールは、すべてのNativeEdge Orchestratorバージョン2.0以降で使用できます。