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:
Otwórz sesję programu PowerShell z podwyższonym poziomem uprawnień.
Uruchom polecenie cmdlet , aby pobrać dzienniki:
Get-AksEdgeLogs
Wszystkie dzienniki są przechowywane w pliku .zip w następującej ścieżce: C:\ProgramData\AksEdge\logs\aksedge-logs-ddmmyy-hhmm.zip.
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. |