Udostępnij za pośrednictwem


Dzienniki usługi AKS Edge Essentials

Jeśli wystąpią problemy z uruchamianiem usługi AKS Edge Essentials IoT Edge w środowisku, skorzystaj z tego artykułu jako przewodnika dotyczącego zbierania dzienników i korzystania z nich.

Pobieranie dzienników

Podczas rozwiązywania problemów z usługą AKS Edge Essentials pierwszym krokiem powinno być zebranie dzienników. Najwygodniejszym sposobem jest użycie Get-AksEdgeLogs polecenia . Domyślnie to polecenie cmdlet zbiera różne dzienniki dotyczące zarządzania maszynami wirtualnymi, sieci, usług Kubernetes i nie tylko. Kompresuje je do jednego pliku w celu łatwego udostępniania.

Aby uzyskać dzienniki usługi AKS Edge Essentials, wykonaj następujące kroki:

  1. Otwórz sesję programu PowerShell z podwyższonym poziomem uprawnień.

  2. Uruchom polecenie cmdlet , aby pobrać dzienniki:

    Get-AksEdgeLogs
    
  3. Wszystkie dzienniki są przechowywane w pliku .zip w następującej ścieżce: C:\ProgramData\AksEdge\logs\aksedge-logs-ddmmyy-hhmm.zip.

  4. Przejdź do folderu C:\ProgramData\AksEdge\logs i rozpakuj plik dzienników aksedge-logs-ddmmyy-hhmm.zip .

Informacje o dziennikach

Skompresowany plik dziennika składa się z różnych plików konfiguracji, dzienników wdrażania i usług oraz informacji o systemie operacyjnym hosta i wdrożonym klastrze. W zależności od stanu klastra dystrybucja Kubernetes i system operacyjny hosta niektóre pliki mogą być niedostępne.

Dzienniki systemu operacyjnego hosta systemu Windows

Nazwa pliku Grupa Opis
aksedgeevents.xml Dzienniki zdarzeń systemu Windows Zdarzenia systemu Windows rejestrowane podczas wdrażania lub cyklu życia maszyny wirtualnej. Aby ręcznie sprawdzić te zdarzenia, użyj aplikacji Podgląd zdarzeń i sprawdź zdarzenia w obszarze Dzienniki aplikacji i usług ->AKS Edge Essentials- K3s/K8s.
aksedgehost-systeminfo Informacje Informacje o systemie operacyjnym hosta systemu Windows, w tym: wersja programu PowerShell, wersja systemu operacyjnego Windows, procesor CPU, pamięć i magazyn.
Microsoft-Windows-Host-Network-Service-Admin.xml Dzienniki zdarzeń systemu Windows Dziennik zdarzeń systemu Windows usługi HNS — tylko do użytku wewnętrznego.
Microsoft-Windows-Host-Network-Service-Operational.xml Dzienniki zdarzeń systemu Windows Dziennik zdarzeń systemu Windows usługi operacyjnej HNS — tylko do użytku wewnętrznego.
Microsoft-Windows-Hyper-V-Compute-Admin.xml Dzienniki zdarzeń systemu Windows Zdarzenia z usługi obliczeniowej hosta (HCS) są zbierane tutaj — tylko do użytku wewnętrznego.
Microsoft-Windows-Hyper-V-Compute-Operational.xml Dzienniki zdarzeń systemu Windows Zdarzenia z usługi obliczeniowej hosta (HCS) są zbierane tutaj — tylko do użytku wewnętrznego.
Microsoft-Windows-Hyper-V-VMMS-Admin.xml Dzienniki zdarzeń systemu Windows Zdarzenia z usługi zarządzania maszynami wirtualnymi (VMMS) można znaleźć tutaj — tylko do użytku wewnętrznego.
Microsoft-Windows-Hyper-V-VMMS-Networking.xml Dzienniki zdarzeń systemu Windows Zdarzenia z stosu sieciowego usługi zarządzania maszynami wirtualnymi (VMMS) można znaleźć tutaj — tylko do użytku wewnętrznego.
Microsoft-Windows-Hyper-V-VMMS-Operational.xml Dzienniki zdarzeń systemu Windows Zdarzenia z operacji usługi zarządzania maszynami wirtualnymi (VMMS) można znaleźć tutaj — tylko do użytku wewnętrznego.

Dzienniki programu Wssdagent

WSSDAgent to usługa usługi AKS Edge Essentials używana do tworzenia maszyn wirtualnych i zarządzania cyklem życia. Ta usługa działa w systemie operacyjnym hosta systemu Windows i używa implementacji interfejsu API funkcji Hyper-V (HCS lub VMMS) do zarządzania maszynami wirtualnymi.

Nazwa pliku Grupa Opis
agent-log-0 Informacje o maszynie wirtualnej Dzienniki cyklu życia maszyn wirtualnych — tylko do użytku wewnętrznego.
wssdagent Informacje o maszynie wirtualnej Dzienniki cyklu życia maszyn wirtualnych — tylko do użytku wewnętrznego.
Inne pliki Konfiguracja wdrożenia. Tylko do użytku wewnętrznego.

Dzienniki kontenerów systemu Linux

Kontenery systemu Linux uruchomione wewnątrz węzłów systemu Linux używają /var/log/continers/<container-name>.log plików do przechowywania dzienników kontenerów. Wszystkie te .log pliki są kopiowane i kompresowane w folderze linux-containers .

Dzienniki węzłów usługi AKS Edge

Te dzienniki powinny być niezależne od typu klastra i używanej dystrybucji Kubernetes (K3s lub K8s).

Nazwa pliku Grupa Opis
aksedgeconfig.txt Konfiguracje wdrożeń Przechowuje konfigurację wdrożenia używaną do tworzenia klastra. Zarówno konfiguracje wewnętrzne, jak i konfiguracje udostępniane przez użytkownika są przechowywane w tym pliku.
aksedgelogs-summary Informacje Szczegółowe informacje o tym, które dzienniki zostały zebrane i uwzględnione w skompresowanym pliku dzienników.
AksEdgenetworkConfig_LinuxVm Informacje o maszynie wirtualnej Dane wyjściowe konfiguracji sieci: adresy IP interfejsów sieciowych (sudo ip a), trasy używane (sudo route) i reguły zapory iptables (sudo iptables -L).
<Windows-hostname-ledge_cloudinit> i <Windows-hostname-ledge_cloudinit-output> Informacje o maszynie wirtualnej Dane wyjściowe konfiguracji cloudinit używanej do tworzenia maszyny wirtualnej z systemem Linux. Aby uzyskać więcej informacji, zobacz dokumentację narzędzia cloudinit.
<Nazwa> hosta systemu Windows ledge_systemd Informacje o maszynie wirtualnej Dzienniki systemu Linux (sudo journalctl).
<Nazwa> hosta systemu Windows ledge_vmconfig Konfiguracja wdrożenia Konfiguracja maszyny wirtualnej z systemem Linux — tylko do użytku wewnętrznego.
<Nazwa-hosta> systemu Windows-ledge-aksedge-agent Informacje o maszynie wirtualnej Dzienniki wdrażania maszyn wirtualnych z systemem Linux — tylko do użytku wewnętrznego.
<Nazwa-hosta> systemu Windows-ledge-aksedge-agent-config Konfiguracja wdrożenia Konfiguracja maszyny wirtualnej z systemem Linux — tylko do użytku wewnętrznego.
<Nazwa-hosta> systemu Windows-ledge-aksedge-lifecycle-config Konfiguracja wdrożenia Konfiguracja maszyny wirtualnej z systemem Linux — tylko użycie wewnętrzne.
<Windows-hostname-wedge_cloudbase-init> i <Windows-hostname-ledge_cloudbase-init-unattend> Informacje o maszynie wirtualnej Dane wyjściowe konfiguracji cloudinit używanej do tworzenia maszyny wirtualnej z systemem Windows. Aby uzyskać więcej informacji, zapoznaj się z dokumentami cloudbase-init.
<Nazwa hosta> systemu Windows wedge_ipconfig Informacje o maszynie wirtualnej Dane wyjściowe konfiguracji sieci: adresy IP interfejsów sieciowych (ipconfig /all).
<Nazwa> hosta systemu Windows — wedge_vmconfig Konfiguracja wdrożenia Konfiguracje maszyn wirtualnych z systemem Windows — tylko do użytku wewnętrznego.
<Windows-hostname-wedge-aksedge-agent> Informacje o maszynie wirtualnej Dzienniki wdrażania maszyn wirtualnych z systemem Windows — tylko do użytku wewnętrznego.
<Windows-hostname-wedge-aksedge-agent-config> Konfiguracja wdrożenia Konfiguracja maszyny wirtualnej z systemem Windows — tylko użycie wewnętrzne.
<Windows-hostname-ledge-aksedge-lifecycle-mgmt> Informacje o maszynie wirtualnej Dzienniki zarządzania cyklem życia maszyny wirtualnej z systemem Windows — tylko do użytku wewnętrznego.
config Konfiguracja wdrożenia Kopia konfiguracji JSON używanej do wdrożenia. Informacje poufne nie są uwzględniane.
hcsdiag_list Informacje o maszynie wirtualnej Uruchamianie maszyn wirtualnych utworzonych przez rozwiązanie HCS. Tylko prawidłowe dla wdrożeń systemu operacyjnego hosta systemu operacyjnego Windows. Węzły usługi AKS Edge Essentials powinny być uruchamiane pod nazwą wssdagent.
hnsdiag_list_all Informacje o maszynie wirtualnej Informacje o sieci związane z maszynami wirtualnymi. Tylko prawidłowe dla wdrożeń systemu operacyjnego hosta systemu operacyjnego Windows.
kubectl_describe Informacje o platformie Kubernetes Dane wyjściowe z uruchomionym poleceniem kubectl describe nodes. Aby uzyskać więcej informacji na temat tego polecenia, zobacz dokumentację referencyjną platformy Kubectl.
kubectl_pods Informacje o klastrze Dane wyjściowe z uruchomionym poleceniem kubectl describe pods. Aby uzyskać więcej informacji na temat tego polecenia, zobacz dokumentację referencyjną platformy Kubectl.

Dzienniki specyficzne dla K3s

Te dzienniki są dostępne tylko wtedy, gdy zainstalowano wersję usługi AKS Edge Essentials K3s, a węzły z systemem Linux i/lub Windows zostały wdrożone.

Nazwa pliku Grupa Opis
<Nazwa hosta> systemu Windows ledge_k3s Informacje o platformie Kubernetes Dzienniki usługi systemu K3S Linux (sudo journalctl -u k3s lub sudo journalctl -u k3s-agent).
<Nazwa hosta> systemu Windows wedge_k3s Informacje o platformie Kubernetes Dzienniki usługi systemu Windows K3S (C:\tmp\K3s.log).
<Windows-hostname-wedge_k3s-config> Informacje o platformie Kubernetes Plik konfiguracji używany do dodawania węzłów systemu Windows K3s.

Dzienniki specyficzne dla K8s

Te dzienniki są dostępne tylko wtedy, gdy zainstalowano wersję usługi AKS Edge Essentials K8s, a węzły z systemem Linux i/lub Windows zostały wdrożone.

Nazwa pliku Grupa Opis
<Nazwa hosta> systemu Windows ledge_k8s Informacje o platformie Kubernetes Dzienniki usługi systemu K8s Linux (sudo journalctl -u kubelet).
<Nazwa hosta> systemu Windows — wedge_k8s Informacje o platformie Kubernetes Dzienniki usługi systemu Windows K8s (C:\tmp\kubelet.log).
<Windows-hostname-wedge_k8s-config> Informacje o platformie Kubernetes Plik konfiguracji używany do dodawania węzła windows K8s.

Następne kroki