Compartir a través de


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:

  1. Abra una sesión de PowerShell con privilegios elevados.

  2. Ejecute el cmdlet para obtener los registros:

    Get-AksEdgeLogs
    
  3. Todos los registros se almacenan en un archivo .zip en la siguiente ruta de acceso: C:\ProgramData\AksEdge\logs\aksedge-logs-ddmmyy-hhmm.zip.

  4. 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 nodesde . 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 podsde . 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.

Pasos siguientes