Dellin automatisoitu alusta: Lokipaketin noutaminen vianmääritystä varten

Tämä työkalu kerää kaikki Dellin automaatioalustan Kubernetes-lokit paikallisista asennuksista. Se kerää myös alkuperäisiä Kubernetes-lokeja ja kerää podien kuvaukset niiden nykyisissä tiloissa. Se kerää myös järjestelmälokin ja päiväkirjalokin. Keräyksen jälkeen se luo tarballin, joka toimitetaan suunnittelutiimille. Sitä ei ole suunniteltu käytettäväksi Software as a Service (SAAS) Dell Automation Platform -asennuksissa.

Tämä työkalu kulkee Dellin automaatioalustan ja Knative-podien läpi ja luettelee sisällä olevat säiliöt. Katso alla oleva esimerkki hzp-product-svc:stä:

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

Esimerkiksi käyttäjä saa seuraavan tiedostorakenteen tarballin sisään:

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

Joten nämä tiedostot tallennetaan seuraavaan rakenteeseen:

namespace/pod-name/namespace-container.log

Käyttö:
Ensin käyttäjän on muodostettava yhteys Dell Automation Platform -virtuaalikoneeseen ja kirjauduttava sisään.

Tämän jälkeen käyttäjän on otettava käyttöön root-oikeudet (sudo -i tai su, jos käytössä).

Kaikkien asiaankuuluvien lokien keräämiseksi käyttäjän on ladattava tämän artikkelin logs_pkb.zip-liite Dell Automation Platform -virtuaalikoneeseen.

Pura arkiston sisältö:

unzip logs_pkb.zip -d logs-tool

Siirry kyseiseen hakemistoon ja suorita komentosarja:

./logs.sh

Suorituksen jälkeen käyttäjä näkee tiedotusviestin käytettävissä olevasta tilasta ja kehotteen jatkaa (jatka kirjoittamalla y):

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.

Versiosta 1.0-rc alkaen lokien keräystyökalu havaitsee, onko NativeEdge tai Dell Automation Platform asennettu muuhun kuin oletusnimitilaan. Jos työkalu ei löydä vakionimitilaa, se kehottaa käyttäjää antamaan kelvollisen Orchestrator-nimitilan. Katso esimerkki alla:

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:

Jos nimitilan oletusasennus on olemassa, työkalu näyttää, mitkä nimitilat ovat kerättävässä luettelossa:

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

Tapahtumien tallennus:

Työkalun versiosta 0.9 alkaen käyttäjältä kysytään EdgeOrchestrator-/Dell Automation Platform -tapahtumien tallennuksesta:

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

Tämä tallentaa tapahtumat EdgeOrchestrator-/Dell Automation Platform -ympäristöstä suoraan lokiin ja parantaa vianmääritystä. Suosittelemme hankkimaan EdgeOrchestrator-/Dell Automation Platform -tapahtumat, jotta koneessa on riittävästi tilaa.

Jos käyttäjällä on lisäohjeita, käyttäjä voi tarkistaa komentosarjan käytettävissä olevat vaihtoehdot ennen suorittamista:

./logs.sh -h

Käyttäjä voi tarkistaa nykyisen version seuraavilla tavoilla:

logs.sh -v

Tämä työkalu on käytettävissä KAIKISSA paikallisissa Dell Automation Platform -asennusversioissa 1.0 ja sitä uudemmissa versioissa.
Tätä työkalua voidaan käyttää KAIKISSA NativeEdge Orchestrator -versioissa, 2.0 ja uudemmissa.