VMware Cloud Director weist unterschiedliche Protokollierungsstufen auf. Die Standardkonfiguration für die Protokollierung reicht für ausgelastete Umgebungen oder für die Erfassung von Ereignissen während der Fehlerbehebung möglicherweise nicht aus. Möglicherweise müssen Sie die Protokollierungsstufe und auch die Größe und Anzahl der beibehaltenen Dateien ändern.

Wichtig: Stellen Sie sicher, dass Sie sich über die Konsequenzen für Ihre VMware Cloud Director-Servergruppe im Klaren sind, wenn ohne Anleitung des globalen VMware-Supportteams Änderungen an der Protokollkonfiguration vorgenommen werden. Wenn Sie eine ausführlichere Protokollierungsstufe verwenden, werden die Protokolle möglicherweise sehr schnell sehr groß, wodurch Ihrer VMware Cloud Director-Umgebung der Festplattenspeicher ausgehen kann.

Die VMware Cloud Director-Protokolle befinden sich im Verzeichnis /opt/vmware/vcloud-director/logs/.

Die VMware Cloud Director-Protokollkonfigurationsdatei befindet sich im Verzeichnis /opt/vmware/vcloud-director/etc/. Der Name der Protokollkonfigurationsdatei lautet log4j.properties.

Wenn Sie die log4j.properties-Protokollkonfigurationsdatei anpassen, müssen Sie vor einem VMware Cloud Director-Upgrade eine Kopie der Datei log4j.properties erstellen und nach dem Upgrade alle fehlenden Abschnitte manuell einfügen.

Um Ihre Protokollaufbewahrung zu verbessern und sicherzustellen, dass die VMware Cloud Director-Protokolle für eine bestimmte Zeit gespeichert werden, sollten Sie einen Syslog-Server verwenden.

Tabelle 1. Protokollierungsebenen
Protokollierungsstufe Beschreibung
FATAL Diese Stufe protokolliert sehr schwerwiegende Fehlerereignisse, die dazu führen können, dass die Anwendung fehlschlägt.
ERROR Diese Stufe umfasst Fehlerereignisse, bei denen die Anwendung möglicherweise trotzdem noch ausgeführt werden kann.
WARN Diese Stufe protokolliert potenziell schädliche Situationen und Warnungen.
INFO Diese Stufe protokolliert Informationsmeldungen, die den übergeordneten Fortschritt der Anwendung angeben.
DEBUG Diese Stufe protokolliert Informationsereignisse, die für das präzise Debugging einer Anwendung am nützlichsten sind.
TRACE Diese Stufe protokolliert Informationsereignisse mit einem noch höheren Detailgrad als die Protokollierungsstufe DEBUG.

Voraussetzungen

Erstellen Sie eine Sicherungskopie der Datei /opt/vmware/vcloud-director/etc/log4j.properties.

Beachten Sie Folgendes:

Prozedur

  1. Melden Sie sich direkt oder mithilfe eines SSH-Clients bei der VMware Cloud Director-Konsole als root an.
  2. Öffnen Sie die Datei /opt/vmware/vcloud-director/etc/log4j.properties in einem Texteditor.
  3. Suchen Sie die Protokolldateidefinition, die Sie aktualisieren möchten.
    log4j.appender.Feature.File=logs/File_Name
    Sie können beispielsweise die Protokollierungsstufe für den Abschnitt # Component appender for container debug ändern. In der letzten Zeile des Abschnitts wird die Protokollierungsstufe konfiguriert, die von der Datei erfasst wird.
  4. Legen Sie die Protokollierungsstufe auf den gewünschten Wert fest.
    Wichtig: Stellen Sie sicher, dass Sie sich über die Konsequenzen für Ihre VMware Cloud Director-Servergruppe im Klaren sind, wenn ohne Anleitung des globalen VMware-Supportteams Änderungen an der Protokollkonfiguration vorgenommen werden.
    TRACE ist die ausführlichste Stufe und FATAL ist am wenigsten ausführlich. Im folgenden Beispiel wird die Zeile so geändert, dass sie mit der ausführlichsten Ebene übereinstimmt.
    log4j.appender.vcloud.system.debug.threshold=TRACE
  5. Wenn Sie die Aufzeichnung auf eine ausführlichere Stufe einstellen, müssen Sie möglicherweise die Anzahl der Protokollsicherungen und die Größe der Protokolldateien erhöhen.
    1. Suchen Sie nach den Zeilen MaxFileSize und MaxBackupIndex.
      log4j.appender.vcloud.system.debug.MaxFileSize=
      log4j.appender.vcloud.system.debug.MaxBackupIndex=
    2. Ändern Sie die Standardeinstellungen.
      Wenn Sie beispielsweise möchten, dass die Protokolldateien vor dem Rollover auf 50 MB erweitert und die letzten 18 Protokolle beibehalten werden, ändern Sie die Zeilen wie folgt:
      log4j.appender.vcloud.system.debug.MaxFileSize=50000KB
      log4j.appender.vcloud.system.debug.MaxBackupIndex=18
      Wenn eine Datei die ausgewählte Größe von 50 MB erreicht, protokolliert VMware Cloud Director weiterhin Daten in einer neuen Datei und speichert bis zu 18 Sicherungen.
    Wichtig: Wenn Sie eine ausführlichere Protokollierungsstufe verwenden, werden die Protokolle möglicherweise sehr schnell sehr groß, wodurch Ihrer VMware Cloud Director-Umgebung der Festplattenspeicher ausgehen kann.
  6. Speichern Sie die Datei /opt/vmware/vcloud-director/etc/log4j.properties.
    VMware Cloud Director wendet die Änderungen sofort an. Die Datei Log4J.properties enthält keine expliziten Zeilen zum Ändern der Größe und Menge der Protokolle, die VMware Cloud Director speichert.