Plataforma automatizada de Dell: Cómo recuperar un paquete de registros para la solución de problemas

Esta herramienta se creó para recopilar todos los registros de Kubernetes de Dell Automation Platform para instalaciones en las instalaciones. También recopila registros nativos de Kubernetes y la descripción de pods en sus estados actuales. También recopila el registro del sistema y el registro de diario. Después de la recopilación, crea un tarball para proporcionar al equipo de ingeniería. No está diseñado para utilizarse en instalaciones de la plataforma de automatización de Dell con software como servicio (SAAS).

Esta herramienta recorre los pods de Dell Automation Platform y Knative, y enumera los contenedores que contiene. Consulte el siguiente ejemplo para hzp-product-svc:

root@labmachine01:/nas/tools# kubectl get po -n hzp hzp-product-svc-00001-deployment-5695678c66-79zwm -o jsonpath="{.spec.containers[*].name}"
hzp-ese-svc hzp-product-svc queue-proxy hzp-iam-proxy

Por ejemplo, el usuario obtiene la siguiente estructura de archivos dentro del tarball:

root@labmachine01:/nas/tools# tar -tf /tmp/native_edge_eo-logs_default_2023-08-30T07-13-39.750/native_edge_eo-logs_default_2023-08-30T07-13-39.750.tar.gz | grep product
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-iam-proxy.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc-00001-deployment-5695678c66-79zwm.hzp-iam-proxy-init.init.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc-00001-deployment-5695678c66-79zwm.describe
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-ese-svc.previous.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/queue-proxy.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/queue-proxy.previous.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-ese-svc.current.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-product-svc.previous.log
./native_edge_eo-logs_default_2023-08-30T07-13-39.750/hzp/hzp-product-svc-00001-deployment-5695678c66-79zwm/hzp-iam-proxy.previous.log

Por lo tanto, estos archivos se almacenan en la siguiente estructura:

namespace/pod-name/namespace-container.log

Uso:
En primer lugar, el usuario debe conectarse e iniciar sesión en la máquina virtual de Dell Automation Platform.

A continuación, el usuario debe habilitar privilegios de raíz (sudo -i o su si están habilitados).

Para recopilar todos los registros pertinentes, el usuario debe descargar el archivo adjunto denominado logs_pkb.zip de este artículo a la máquina virtual de Dell Automation Platform.

Extraiga el contenido del archivo:

unzip logs_pkb.zip -d logs-tool

Vaya a ese directorio y ejecute el script:

./logs.sh

Después de la ejecución, el usuario ve un mensaje informativo sobre el espacio disponible y un indicador para continuar (ingrese "y" para continuar):

This script will access your local k3s secrets (secret values are not going to be printed).
This script will collect all logs from all pods in NativeEdge-controlled namespaces and archive it in tarball.
Please press "y" if you agree with this.
You have 69G available on your storage. Consider that logs may require to have more that 1Gb of free space.

A partir de la versión 1.0-rc, la herramienta de recopilación de registros detecta si NativeEdge o Dell Automation Platform están instalados en un espacio de nombres no predeterminado. Si la herramienta no encuentra un espacio de nombres estándar, solicita al usuario que ingrese un espacio de nombres de Orchestrator válido. Consulte el ejemplo a continuación:

Available namespaces:
- default
- nativeedge
- kube-node-lease
- kube-public
- kube-system
- longhorn-system
- metallb-system
Warning: Namespace 'hzp' not found.
Please enter the namespace containing the 'nativeedge' containers:

Si hay una instalación predeterminada del espacio de nombres, la herramienta mostrará qué espacios de nombres se encuentran en la lista para la recopilación:

Namespace 'hzp' found. Logs will be collected from following namespaces:
- hzp
- kube-system
- istio-system
- knative-eventing
- knative-serving
- longhorn-system

Captura de eventos:

A partir de la versión 0.9-beta de la herramienta, se le preguntará al usuario sobre la captura de eventos de EdgeOrchestrator/Dell Automation Platform:

Do you want to collect the EO events (WARNING: this may require significant space on disk)?

Esto captura eventos de EdgeOrchestrator/Dell Automation Platform directamente en el tarball de registros y mejora la solución de problemas. Se recomienda obtener eventos de EdgeOrchestrator/Dell Automation Platform si tiene suficiente espacio en la máquina.

En caso de que el usuario tenga instrucciones adicionales, puede comprobar las opciones disponibles del script antes de ejecutarlo:

./logs.sh -h

El usuario puede comprobar la versión actual con:

logs.sh -v

Esta herramienta se puede utilizar en TODAS las versiones de instalación de la plataforma de automatización de Dell en las instalaciones, 1.0 y superiores.
Esta herramienta se puede utilizar en TODAS las versiones de NativeEdge Orchestrator, 2.0 y superiores.