Diverse services genereren automatisch logboeken. U kunt logboekbundels genereren in vRealize Automation. U kunt ook uw omgeving configureren om logboeken te sturen naar vRealize Log Insight.

Informatie over het gebruik van het hulpprogramma voor de vracli-opdrachtregel om logboekbundels te genereren, is beschikbaar via het argument --help in de vracli-opdrachtregel (bijvoorbeeld vracli log-bundle --help).

Zie Hoe configureer ik het doorsturen van logboeken naar vRealize Log Insight voor gerelateerde informatie over het gebruik van vRealize Log Insight.

Opdrachten voor logboekbundels

U kunt een logboekbundel maken om alle logboeken te bevatten die worden gegenereerd door de services die u uitvoert. Een logboekbundel bevat al uw servicelogboeken en is nodig voor het oplossen van problemen.

In een geclusterde omgeving (hoge beschikbaarheidsmodus) voert u de opdracht vracli log-bundle uit op slechts één knooppunt. Logboeken worden opgehaald van alle knooppunten in de omgeving. In het geval van een netwerkprobleem of een ander clusterprobleem worden logboeken echter opgehaald van het aantal knooppunten dat kan worden bereikt. Bijvoorbeeld: als een knooppunt in een cluster met drie knooppunten wordt ontkoppeld, worden logboeken alleen van de twee gezonde knooppunten verzameld. De uitvoer van de opdracht vracli log-bundle bevat informatie over eventuele gevonden problemen en de stappen voor een tijdelijke oplossing.

  • Als u een logboekbundel wilt maken, moet u SSH gebruiken om verbinding te maken met een knooppunt en voert u de volgende vracli-opdracht uit:

    vracli log-bundle

  • Als u de time-outwaarde voor het verzamelen van logboeken van elk knooppunt wilt wijzigen, voert u de volgende vracli-opdracht uit:

    vracli log-bundle --collector-timeout $CUSTOM_TIMEOUT_IN_SECONDS

    In een omgeving met grote logboekbestanden, een traag netwerk of hoog CPU-gebruik kunt u de time-out bijvoorbeeld instellen op een grotere waarde dan de standaardwaarde van 1000 seconden.

  • Als u andere opties, zoals time-out van Assembly en bufferlocatie, wilt configureren, gebruikt u de volgende Help-opdracht vracli:

    vracli log-bundle --help

Indeling van logboekbundels

De logboekbundel is een tar-bestand met tijdstempel. De naam van de bundel komt overeen met het patroon log-bundle-<datum>T<tijd>.tar, bijvoorbeeld log-bundle-20200629T131312.tar. Een logboekbundel bevat doorgaans logboeken van alle knooppunten in de omgeving. In geval van een fout bevat deze zo veel mogelijk logboeken. Deze bevat minimaal logboeken van het lokale knooppunt.

De logboekbundel bestaat uit de volgende inhoud:
  • Omgevingsbestand

    Het omgevingsbestand bevat de uitvoer van diverse Kubernetes-onderhoudsopdrachten. Het geeft informatie over het huidige resourceverbruik per knooppunt en per pod. Tevens bevat het clusterinformatie en beschrijvingen van alle beschikbare Kubernetes-entiteiten.

  • Hostlogboeken en -configuratie

    De configuratie van elke host (bijvoorbeeld de directory /etc) en de hostspecifieke logboeken (bijvoorbeeld journald) worden in één directory verzameld voor elk clusterknooppunt of elke host. De naam van de directory komt overeen met de hostnaam van het knooppunt. De interne inhoud van de directory komt overeen met het bestandssysteem van de host. Het aantal dergelijke directory's komt overeen met het aantal clusterknooppunten.

  • Services-logboeken
    Logboeken voor Kubernetes-services vindt u in de volgende mapstructuur:
    • <hostnaam>/services-logs/<naamruimte>/<appnaam>/file-logs/<containernaam>.log
    • <hostnaam>/services-logs/<naamruimte>/<appnaam>/console-logs/<containernaam>.log

    Een voorbeeld van een bestandsnaam is my-host-01/services-logs/prelude/vco-app/file-logs/vco-server-app.log.

    • hostnaam is de hostnaam van het knooppunt waarop de applicatiecontainer actief is of was. Doorgaans is er één instantie voor elk knooppunt voor elke service. Bijvoorbeeld: 3 knooppunten = 3 instanties.
    • naamruimte is de Kubernetes-naamruimte waarin de applicatie is of was geïmplementeerd. Voor gebruikersgerichte services is deze waarde prelude.
    • appnaam is de naam van de Kubernetes-applicatie die de logboeken heeft geproduceerd, bijvoorbeeld provisioning-service-app.
    • containernaam is de naam van de container die de logboeken heeft geproduceerd. Sommige apps bestaan uit meerdere containers. vco-app bevat bijvoorbeeld de vco-server-app- en vco-controlcenter-app-containers.
  • (Oudere) Pod-logboeken

    Vóór de wijzigingen in de architectuur van de logboekregistratie in vRealize Automation 8.2, bevonden de servicelogboeken (zoals beschreven in het vorige punt) zich in de directory van elke pod in de logboekbundel. Hoewel u kunt doorgaan met het genereren van pod-logboeken in de bundel met behulp van de vracli log-bundle --include-legacy-pod-logs-opdrachtregel, wordt dit niet aanbevolen, omdat alle logboekinformatie al in de logboeken van de services aanwezig is. Het opnemen van pod-logboeken kan de tijd en ruimte verhogen die vereist zijn om de logboekbundel te genereren.

De grootte van de logboekbundel verkleinen

Als u een kleinere logboekbundel wilt genereren, gebruikt u een van de volgende commando's met vracli log-bundle:

  • vracli log-bundle --since-days n

    Gebruik dit commando om alleen de logboekbestanden te verzamelen die in de afgelopen dagen zijn gegenereerd. Anders worden logboeken 7 dagen bewaard en verzameld. Bijvoorbeeld:

    vracli log-bundle --since-days 3

  • vracli log-bundle --services service_A,service_B,service_C

    Gebruik dit commando om alleen de logboeken te verzamelen voor de benoemde opgegeven services. Bijvoorbeeld:

    vracli log-bundle --services ebs-app,vco-app

  • vracli log-bundle --skip-heap-dumps

    Gebruik dit commando om alle heapdumps uit de gegenereerde logboekbundel uit te sluiten.