Logboeken worden automatisch gegenereerd door de verschillende services. U kunt logboekbundels genereren in vRealize Automation. U kunt ook uw omgeving configureren om logboeken automatisch door 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. Uitvoer van de vracli log-bundle-opdracht bevat informatie over eventuele gevonden problemen en de stappen voor de 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. Het 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 van de actieve Kubernetes-services zijn beschikbaar in <hostnaam>/services-logs/<naamruimte>/<appnaam>/<containernaam>.log. Een voorbeeld van een bestandsnaam is my-host-01/services-logs/prelude/vco-app/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.