Registros de Essentials de AKS Edge
Si experimenta problemas al ejecutar AKS Edge Essentials IoT Edge en su entorno, use este artículo como guía para recopilar y usar registros.
Obtención de registros
Al solucionar problemas de AKS Edge Essentials, el primer paso debe ser recopilar registros. La manera más cómoda es usar el Get-AksEdgeLogs
comando . De forma predeterminada, este cmdlet recopila registros diferentes en torno a la administración de máquinas virtuales, redes, servicios de Kubernetes, etc. y, luego, lo comprime todo en un solo archivo para poder compartirlo fácilmente.
Para obtener los registros de Essentials de AKS Edge, siga estos pasos:
Abra una sesión de PowerShell con privilegios elevados.
Ejecute el cmdlet para obtener los registros:
Get-AksEdgeLogs
Todos los registros se almacenan en un archivo .zip en la siguiente ruta de acceso: C:\ProgramData\AksEdge\logs\aksedge-logs-ddmmyy-hhmm.zip.
Vaya a la carpeta C:\ProgramData\AksEdge\logs y descomprima el archivo de registros deaksedge-logs-ddmmyy-hhmm.zip .
Comprender los registros
El archivo de registro comprimido consta de diferentes archivos de configuración, registros de implementación y servicios, e información sobre el sistema operativo host y el clúster implementado. En función del estado del clúster, la distribución de Kubernetes y el sistema operativo host, es posible que algunos archivos no estén disponibles.
Registros del sistema operativo host de Windows
Nombre de archivo | Grupo | Descripción |
---|---|---|
aksedgeevents.xml | Registro de sucesos de Windows | Eventos de Windows registrados durante la implementación o el ciclo de vida de la máquina virtual. Para comprobar manualmente estos eventos, use la aplicación Visor de eventos y compruebe los eventos en Registros de aplicaciones y servicios ->AKS Edge Essentials- K3s/K8s. |
aksedgehost-systeminfo | Information | Información del sistema operativo host de Windows, incluida: versión de PowerShell, versión del sistema operativo Windows, CPU, memoria y almacenamiento. |
Microsoft-Windows-Host-Network-Service-Admin.xml | Registro de sucesos de Windows | Registro de eventos de Windows del servicio HNS: solo uso interno. |
Microsoft-Windows-Host-Network-Service-Operational.xml | Registro de sucesos de Windows | Registro de eventos de Windows del servicio operativo HNS: solo uso interno. |
Microsoft-Windows-Hyper-V-Compute-Admin.xml | Registro de sucesos de Windows | Los eventos del servicio de proceso de host (HCS) se recopilan aquí: solo uso interno. |
Microsoft-Windows-Hyper-V-Compute-Operational.xml | Registro de sucesos de Windows | Los eventos del servicio de proceso de host (HCS) se recopilan aquí: solo uso interno. |
Microsoft-Windows-Hyper-V-VMMS-Admin.xml | Registro de sucesos de Windows | Los eventos del servicio de administración de máquinas virtuales (VMMS) se pueden encontrar aquí: solo uso interno. |
Microsoft-Windows-Hyper-V-VMMS-Networking.xml | Registro de sucesos de Windows | Los eventos de la pila de redes del servicio de administración de máquinas virtuales (VMMS) se pueden encontrar aquí: solo uso interno. |
Microsoft-Windows-Hyper-V-VMMS-Operational.xml | Registro de sucesos de Windows | Los eventos de la operación del servicio de administración de máquinas virtuales (VMMS) se pueden encontrar aquí: solo uso interno. |
Registros de Wssdagent
WSSDAgent es el servicio de Essentials de AKS Edge que se usa para la creación y administración del ciclo de vida de las máquinas virtuales. Este servicio se ejecuta en el sistema operativo host de Windows y usa implementaciones de API de Hyper-V (HCS o VMMS) para administrar las máquinas virtuales.
Nombre de archivo | Grupo | Descripción |
---|---|---|
agent-log-0 | Información de máquina virtual | Registros de ciclo de vida de máquinas virtuales: solo uso interno. |
wssdagent | Información de máquina virtual | Registros de ciclo de vida de máquinas virtuales: solo uso interno. |
Otros archivos | Configuración de implementación. | Solo para uso interno. |
Registros de contenedores de Linux
Los contenedores de Linux que se ejecutan dentro de los nodos de Linux usan /var/log/continers/<container-name>.log
archivos para almacenar registros de contenedor. Todos estos .log
archivos se copian y comprimen en la carpeta linux-containers .
Registros de nodos perimetrales de AKS
Estos registros deben ser independientes del tipo de clúster y la distribución de Kubernetes que se usa (K3s o K8s).
Nombre de archivo | Grupo | Descripción |
---|---|---|
aksedgeconfig.txt | Configuraciones de implementación | Almacena la configuración de implementación que se usa para crear el clúster. Tanto las configuraciones internas como las proporcionadas por el usuario se almacenan en este archivo. |
aksedgelogs-summary | Information | Detalles sobre qué registros se recopilaron e incluyeron en el archivo comprimido de registros. |
AksEdgenetworkConfig_LinuxVm | Información de la máquina virtual | Salida de configuraciones de red: direcciones IP de interfaces de red (sudo ip a ), rutas que se usan (sudo route ) y reglas de firewall de iptables (sudo iptables -L ). |
<Windows-hostname-ledge_cloudinit> y <Windows-hostname-ledge_cloudinit-output> | Información de máquina virtual | Salida de la configuración de cloudinit usada para la creación de máquinas virtuales Linux. Para más información, consulte la documentación de cloudinit. |
<Windows-hostname-ledge_systemd> | Información de la máquina virtual | Registros de Linux systemd (sudo journalctl ). |
<Windows-hostname-ledge_vmconfig> | Configuración de la implementación | Configuración de máquina virtual Linux: solo uso interno. |
<Windows-hostname-ledge-aksedge-agent> | Información de la máquina virtual | Registros de implementación de máquinas virtuales Linux: solo uso interno. |
<Windows-hostname-ledge-aksedge-agent-config> | Configuración de la implementación | Configuración de máquina virtual Linux: solo uso interno. |
<Windows-hostname-ledge-aksedge-lifecycle-config> | Configuración de la implementación | Configuración de máquina virtual Linux: solo uso interno. |
<Windows-hostname-wedge_cloudbase-init> y <Windows-hostname-ledge_cloudbase-init-unattend> | Información de la máquina virtual | Salida de la configuración de cloudinit usada para la creación de máquinas virtuales Windows. Para más información, consulte la documentación de cloudbase-init. |
<Windows-hostname-wedge_ipconfig> | Información de la máquina virtual | Salida de la configuración de red: direcciones IP de interfaces de red (ipconfig /all ). |
<Windows-hostname-wedge_vmconfig> | Configuración de la implementación | Configuraciones de máquina virtual Windows: solo uso interno. |
<Windows-hostname-wedge-aksedge-agent> | Información de la máquina virtual | Registros de implementación de máquinas virtuales Windows: solo uso interno. |
<Windows-hostname-wedge-aksedge-agent-config> | Configuración de la implementación | Configuración de máquina virtual Windows: solo uso interno. |
<Windows-hostname-ledge-aksedge-lifecycle-mgmt> | Información de la máquina virtual | Registros de administración del ciclo de vida de las máquinas virtuales Windows: solo uso interno. |
config | Configuración de la implementación | Copia de la configuración json usada para la implementación. No se incluye información confidencial. |
hcsdiag_list | Información de máquina virtual | Ejecución de máquinas virtuales creadas por HCS. Solo es válido para las implementaciones del sistema operativo host del cliente windows. Los nodos de Essentials de AKS Edge deben ejecutarse bajo el nombre de wssdagent. |
hnsdiag_list_all | Información de la máquina virtual | Información de red relacionada con las máquinas virtuales. Solo es válido para las implementaciones del sistema operativo host del cliente windows. |
kubectl_describe | Información de Kubernetes | Salida de la ejecución kubectl describe nodes de . Para obtener más información sobre este comando, consulte la documentación de referencia de Kubectl. |
kubectl_pods | Información del clúster | Salida de la ejecución kubectl describe pods de . Para obtener más información sobre este comando, consulte la documentación de referencia de Kubectl. |
Registros específicos de K3s
Estos registros solo están disponibles si se instaló la versión de AKS Edge Essentials K3s y se implementaron nodos de Linux o Windows.
Nombre de archivo | Grupo | Descripción |
---|---|---|
<Windows-hostname-ledge_k3s> | Información de Kubernetes | Registros del servicio del sistema Linux K3S (sudo journalctl -u k3s o sudo journalctl -u k3s-agent ). |
<Windows-hostname-wedge_k3s> | Información de Kubernetes | Registros del servicio del sistema de Windows K3S (C:\tmp\K3s.log ). |
<Windows-hostname-wedge_k3s-config> | Información de Kubernetes | Archivo de configuración usado para agregar nodos de Windows K3s. |
Registros específicos de K8s
Estos registros solo están disponibles si se instaló la versión de AKS Edge Essentials K8s y se implementaron nodos de Linux o Windows.
Nombre de archivo | Grupo | Descripción |
---|---|---|
<Windows-hostname-ledge_k8s> | Información de Kubernetes | Registros del servicio del sistema Linux K8s (sudo journalctl -u kubelet ). |
<Windows-hostname-wedge_k8s> | Información de Kubernetes | Registros del servicio del sistema de Windows K8s (C:\tmp\kubelet.log ). |
<Windows-hostname-wedge_k8s-config> | Información de Kubernetes | Archivo de configuración que se usa para agregar el nodo De Windows K8s. |