Dell geautomatiseerd platform: Een logboekbundel ophalen voor probleemoplossing

Deze tool is gemaakt om alle Dell Automation Platform Kubernetes-logboeken te verzamelen voor On Prem-installaties. Het verzamelt ook native Kubernetes-logboeken en verzamelt podbeschrijvingen in hun huidige status. Het verzamelt ook systeemlogboeken en logboeklogboeken. Na het verzamelen wordt er een tarball gemaakt om aan het technische team te verstrekken. Het is niet ontworpen voor gebruik bij installatie van Software as a Service (SAAS) Dell Automation Platform.

Deze tool doorkruist Dell Automation Platform en Knative pods en geeft een overzicht van de containers in de pods. Zie onderstaand voorbeeld voor 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

De gebruiker krijgt bijvoorbeeld de volgende bestandsstructuur in de 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

Deze bestanden worden dus opgeslagen in de volgende structuur:

namespace/pod-name/namespace-container.log

Gebruik:
Eerst moet de gebruiker verbinding maken met en inloggen op uw virtuele Dell Automation Platform machine.

Vervolgens moet de gebruiker rootrechten inschakelen (sudo -i of su indien ingeschakeld).

Om alle relevante logboeken te verzamelen, moet de gebruiker de bijlage met de naam logs_pkb.zip uit dit artikel downloaden naar de virtuele Dell Automation Platform-machine.

Pak de inhoud van het archief uit:

unzip logs_pkb.zip -d logs-tool

Ga naar die map en voer het script uit:

./logs.sh

Na uitvoering ziet de gebruiker een informatief bericht over de beschikbare ruimte en een prompt om verder te gaan (voer 'y' in om door te gaan):

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.

Vanaf versie 1.0-rc detecteert de tool voor het verzamelen van logboeken of NativeEdge of Dell Automation Platform is geïnstalleerd in een niet-standaard naamruimte. Als de tool geen standaardnaamruimte vindt, wordt de gebruiker gevraagd een geldige Orchestrator-naamruimte in te voeren. Zie voorbeeld hieronder:

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:

Als er standaard een namespace is geïnstalleerd, laat de tool zien welke namespaces in de lijst staan voor verzameling:

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

Evenementen vastleggen:

Vanaf versie 0.9-bèta van het hulpprogramma krijgt de gebruiker een melding over EdgeOrchestrator/Dell Automation Platform gebeurtenissen vastleggen:

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

Dit legt gebeurtenissen van de EdgeOrchestrator/Dell Automation Platform rechtstreeks vast in de logboekentarball en verbetert de probleemoplossing. Het wordt aangeraden om EdgeOrchestrator/Dell Automation Platform-gebeurtenissen uit te voeren wanneer u voldoende ruimte op de machine hebt.

In het geval dat de gebruiker aanvullende instructies heeft, kan de gebruiker de beschikbare opties van het script controleren voordat deze wordt uitgevoerd:

./logs.sh -h

De gebruiker kan de huidige versie controleren met:

logs.sh -v

Deze tool kan worden gebruikt bij ALLE On Prem Dell Automation Platform installatieversies 1.0 en hoger.
Deze tool kan worden gebruikt op ALLE NativeEdge Orchestrator-versies 2.0 en hoger.