次の方法で共有


AKS Edge Essentials ログ

環境内で AKS Edge Essentials IoT Edgeの実行に関する問題が発生した場合は、この記事をログの収集と使用のガイドとして使用してください。

ログを取得する

AKS Edge Essentialsのトラブルシューティングを行う場合、最初の手順はログを収集することです。 最も便利な方法は、 コマンドを Get-AksEdgeLogs 使用することです。 既定では、このコマンドレットは VM 管理、ネットワーク、Kubernetes サービスなどのさまざまなログを収集します。 共有しやすいように、それらが 1 つのファイルに圧縮されます。

AKS Edge Essentials ログを取得するには、次の手順に従います。

  1. 管理者特権の PowerShell セッションを開きます。

  2. コマンドレットを実行してログを取得します。

    Get-AksEdgeLogs
    
  3. すべてのログは、C:\ProgramData\AksEdge\logs\aksedge-logs-ddmmyy-hhmm.zipのパスの下の .zip ファイルに格納されます。

  4. 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 ノードの追加に使用される構成ファイル。

次のステップ