AKS Edge Essentials ログ
環境内で AKS Edge Essentials IoT Edgeの実行に関する問題が発生した場合は、この記事をログの収集と使用のガイドとして使用してください。
ログを取得する
AKS Edge Essentialsのトラブルシューティングを行う場合、最初の手順はログを収集することです。 最も便利な方法は、 コマンドを Get-AksEdgeLogs
使用することです。 既定では、このコマンドレットは VM 管理、ネットワーク、Kubernetes サービスなどのさまざまなログを収集します。 共有しやすいように、それらが 1 つのファイルに圧縮されます。
AKS Edge Essentials ログを取得するには、次の手順に従います。
管理者特権の PowerShell セッションを開きます。
コマンドレットを実行してログを取得します。
Get-AksEdgeLogs
すべてのログは、C:\ProgramData\AksEdge\logs\aksedge-logs-ddmmyy-hhmm.zipのパスの下の .zip ファイルに格納されます。
C:\ProgramData\AksEdge\logs フォルダーに移動し、aksedge-logs-ddmmyy-hhmm.zip ログ ファイルを解凍します。
ログの理解
圧縮ログ ファイルは、さまざまな構成ファイル、展開とサービスのログ、ホスト OS とデプロイされたクラスターに関する情報で構成されます。 クラスターの状態、Kubernetes ディストリビューション、ホスト OS によっては、一部のファイルが使用できない場合があります。
Windows ホスト OS ログ
ファイル名 | グループ化 | 説明 |
---|---|---|
aksedgeevents.xml | Windows イベント ログ | デプロイまたは VM のライフサイクル中にログに記録される Windows イベント。 これらのイベントを手動でチェックするには、イベント ビューアー アプリケーションを使用し、アプリケーションとサービス ログ ->AKS Edge Essentials- K3s/K8s でイベントをチェックします。 |
aksedgehost-systeminfo | Information | Windows ホスト OS 情報 (PowerShell バージョン、Windows OS バージョン、CPU、メモリ、ストレージなど)。 |
Microsoft-Windows-Host-Network-Service-Admin.xml | Windows イベント ログ | HNS サービス Windows イベント ログ - 内部使用のみ。 |
Microsoft-Windows-Host-Network-Service-Operational.xml | Windows イベント ログ | HNS 運用サービス Windows イベント ログ - 内部使用のみ。 |
Microsoft-Windows-Hyper-V-Compute-Admin.xml | Windows イベント ログ | ホスト コンピューティング サービス (HCS) からのイベントは、ここで収集されます。内部使用のみ。 |
Microsoft-Windows-Hyper-V-Compute-Operational.xml | Windows イベント ログ | ホスト コンピューティング サービス (HCS) からのイベントは、ここで収集されます。内部使用のみ。 |
Microsoft-Windows-Hyper-V-VMMS-Admin.xml | Windows イベント ログ | 仮想マシン管理サービス (VMMS) からのイベントについては、内部使用のみをご覧ください。 |
Microsoft-Windows-Hyper-V-VMMS-Networking.xml | Windows イベント ログ | 仮想マシン管理サービス (VMMS) ネットワーク スタックからのイベントについては、内部使用のみをご覧ください。 |
Microsoft-Windows-Hyper-V-VMMS-Operational.xml | Windows イベント ログ | 仮想マシン管理サービス (VMMS) 操作のイベントについては、内部使用のみをご覧ください。 |
Wssdagent ログ
WSSDAgent は、仮想マシンの作成とライフサイクル管理に使用される AKS Edge Essentials サービスです。 このサービスは Windows ホスト OS 上で実行され、Hyper-V API 実装 (HCS または VMMS) を使用して VM を管理します。
ファイル名 | グループ化 | 説明 |
---|---|---|
agent-log-0 | VM 情報 | 仮想マシンのライフサイクル ログ - 内部使用のみ。 |
wssdagent | VM 情報 | 仮想マシンのライフサイクル ログ - 内部使用のみ。 |
その他のファイル | デプロイの構成。 | 内部使用のみです。 |
Linux-containers ログ
Linux ノード内で実行されている Linux コンテナーは、ファイルを使用 /var/log/continers/<container-name>.log
してコンテナー ログを格納します。 これらの .log
ファイルはすべて、 linux-containers フォルダーの下にコピーおよび圧縮されます。
AKS Edge ノードのログ
これらのログは、使用されているクラスターの種類と Kubernetes ディストリビューション (K3s または K8s) とは独立している必要があります。
ファイル名 | グループ化 | 説明 |
---|---|---|
aksedgeconfig.txt | 配置構成 | クラスターの作成に使用されているデプロイ構成を格納します。 このファイルには、内部構成とユーザー指定構成の両方が格納されます。 |
aksedgelogs-summary | Information | どのログが収集され、ログ圧縮ファイルに含まれていたかについての詳細。 |
AksEdgenetworkConfig_LinuxVm | VM 情報 | ネットワーク構成の出力: ネットワーク インターフェイスの IP アドレス (sudo ip a )、使用されているルート (sudo route ) および iptables ファイアウォール規則 (sudo iptables -L )。 |
<Windows-hostname-ledge_cloudinit> と <Windows-hostname-ledge_cloudinit-output> | VM 情報 | Linux VM の作成に使用される cloudinit 構成の出力。 詳細については、 cloudinit のドキュメントを参照してください。 |
<Windows-hostname-ledge_systemd> | VM 情報 | Linux systemd のログ (sudo journalctl )。 |
<Windows-hostname-ledge_vmconfig> | デプロイの構成 | Linux 仮想マシンの構成 - 内部使用のみ。 |
<Windows-hostname-ledge-aksedge-agent> | VM 情報 | Linux 仮想マシンのデプロイ ログ - 内部使用のみ。 |
<Windows-hostname-ledge-aksedge-agent-config> | デプロイの構成 | Linux 仮想マシンの構成 - 内部使用のみ。 |
<Windows-hostname-ledge-aksedge-lifecycle-config> | デプロイの構成 | Linux 仮想マシンの構成 - 内部使用のみ。 |
<Windows-hostname-wedge_cloudbase-init> と <Windows-hostname-ledge_cloudbase-init-unattend> | VM 情報 | Windows VM の作成に使用される cloudinit 構成の出力。 詳細については、cloudbase-init ドキュメントチェック。 |
<Windows-hostname-wedge_ipconfig> | VM 情報 | ネットワーク構成の出力: ネットワーク インターフェイスの IP アドレス (ipconfig /all )。 |
<Windows-hostname-wedge_vmconfig> | デプロイの構成 | Windows 仮想マシンの構成 - 内部使用のみ。 |
<Windows-hostname-wedge-aksedge-agent> | VM 情報 | Windows 仮想マシンのデプロイ ログ - 内部使用のみ。 |
<Windows-hostname-wedge-aksedge-agent-config> | デプロイの構成 | Windows 仮想マシンの構成 - 内部使用のみ。 |
<Windows-hostname-ledge-aksedge-lifecycle-mgmt> | VM 情報 | Windows 仮想マシンのライフサイクル管理ログ - 内部使用のみ。 |
config | デプロイの構成 | デプロイに使用される JSON 構成のコピー。 機密情報は含まれません。 |
hcsdiag_list | VM 情報 | HCS によって作成された仮想マシンの実行。 Windows クライアント ホスト OS の展開でのみ有効です。 AKS Edge Essentials ノードは wssdagent 名で実行する必要があります。 |
hnsdiag_list_all | VM 情報 | 仮想マシンに関連するネットワーク情報。 Windows クライアント ホスト OS の展開でのみ有効です。 |
kubectl_describe | Kubernetes の情報 | 実行中 kubectl describe nodes の の出力。 このコマンドの詳細については、 Kubectl リファレンス ドキュメントを参照してください。 |
kubectl_pods | クラスター情報 | 実行中 kubectl describe pods の の出力。 このコマンドの詳細については、 Kubectl リファレンス ドキュメントを参照してください。 |
K3s 固有のログ
これらのログは、AKS Edge Essentials K3s バージョンがインストールされていて、Linux ノードまたは Windows ノードがデプロイされている場合にのみ使用できます。
ファイル名 | グループ化 | 説明 |
---|---|---|
<Windows-hostname-ledge_k3s> | Kubernetes の情報 | K3S Linux システム サービス (sudo journalctl -u k3s または sudo journalctl -u k3s-agent ) のログ。 |
<Windows-hostname-wedge_k3s> | Kubernetes の情報 | K3S Windows システム サービスのログ (C:\tmp\K3s.log )。 |
<Windows-hostname-wedge_k3s-config> | Kubernetes の情報 | Windows K3s ノードの追加に使用される構成ファイル。 |
K8s 固有のログ
これらのログは、AKS Edge Essentials K8s バージョンがインストールされ、Linux ノードまたは Windows ノードがデプロイされている場合にのみ使用できます。
ファイル名 | グループ化 | 説明 |
---|---|---|
<Windows-hostname-ledge_k8s> | Kubernetes の情報 | K8s Linux システム サービスのログ (sudo journalctl -u kubelet )。 |
<Windows-hostname-wedge_k8s> | Kubernetes の情報 | K8s Windows システム サービスのログ (C:\tmp\kubelet.log )。 |
<Windows-hostname-wedge_k8s-config> | Kubernetes の情報 | Windows K8s ノードの追加に使用される構成ファイル。 |