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 FATAL ist die am wenigsten ausführliche Stufe. 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 TRACE ist die ausführlichste Stufe. 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 nach dem Abschnitt Default vCloud loggers und ändern Sie die Protokollierungsebene für die Logger.
    Das folgende Beispiel zeigt die Protokollierungsebene, die auf die ausführlichste Stufe festgelegt ist.
    log4j.logger.com.vmware.vcloud=TRACE 
    log4j.logger.com.vmware.ssdc=TRACE
  4. 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.
  5. 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.
    Im folgenden Beispiel wird die Zeile so geändert, dass sie mit der ausführlichsten Ebene übereinstimmt.
    log4j.appender.vcloud.system.debug.threshold=TRACE
  6. 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.
  7. 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.

Steuern der API-Anforderungsprotokollierung in VMware Cloud Director

Sie können den Prozess zur Erfassung und Speicherung von Informationen zu eingehenden Anforderungen in VMware Cloud Director steuern.

VMware Cloud Director protokolliert die eingehenden Anforderungen in den VMware Cloud Director-Zellen in den Anforderungsprotokollen. Die Protokolle haben Namen im Format YYYY_MM_DD.request.log. Die VMware Cloud Director request.log-Dateien befinden sich im Verzeichnis /opt/vmware/vcloud-director/logs/, aber Sie können die Protokolle nicht über die Datei log4j.properties konfigurieren.

Sie können den Unterbefehl manage-config des Befehlszeilentools verwenden, um die Protokollierung von API-Anforderungen zu steuern. Der Unterbefehl manage-config ändert die Einstellungen für die gesamte Servergruppe. Weitere Informationen zu den Optionen und Argumenten des Unterbefehls manage-config finden Sie unter Aktualisieren von Anwendungskonfigurationseinstellungen in VMware Cloud Director.

Die Protokollrotation kann maximal einmal pro Tag erfolgen und ist nicht mit der Größe der einzelnen Protokolldateien oder der Gesamtgröße aller Protokolldateien verknüpft. Sie können die Rotationsrichtlinie steuern, indem Sie die Anzahl der Tage ändern, für die VMware Cloud Director die Protokolle speichert.

Prozedur

  1. Melden Sie sich direkt oder mithilfe eines SSH-Clients beim Betriebssystem der VMware Cloud Director-Zelle als root an.
  2. Wenn Sie die Aufbewahrungsrichtlinie der Anforderungsprotokolle ändern möchten, verwenden Sie den Unterbefehl manage-config des Zellenverwaltungstools.
    Der Wert für die Aufbewahrungsrichtlinie stellt die Anzahl der Tage dar, für die VMware Cloud Director das Kompatibilitätsprotokoll (NCSA) aufbewahrt. Der Standardwert ist 0, wobei 0 dauerhaft bedeutet. Durch das Löschen des Werts werden auch die Protokolle dauerhaft beibehalten. Die kürzeste Dauer, die Sie die Protokolle aufbewahren können, beträgt 1 Tag.
    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config --name "vcloud.http.log.retainDays" --value New_Value
  3. Damit die Änderungen wirksam werden, müssen Sie die Zellen neu starten.
    Wenn Sie eine Zelle neu gestartet haben, beginnt sie mit der Verwendung des aktualisierten Werts. Sie können einen Teil der Zellen oder alle Zellen gleichzeitig neu starten.