Konfigurieren der Protokollierungsebene mit Nlog

IT Asset Management (Cloud)

In IT Asset Management werden von der Nlog-Protokollierungsplattform Protokolldateien für die Inventarisierungsstation generiert. Hinweis: Die Nlog-Protokollierungsplattform hat keine Relevanz für den Agenten.

Mit NLog können Benutzer die Dateien in verschiedene Ziele schreiben (Datenbank, Datei, Konsole) und die Protokollierungskonfiguration spontan ändern. Weitere Informationen zu Nlog finden Sie auf der Website von Nlog.

Es ist üblich, dass Kunden den Wert für die Protokollierungsebene in einer config-Datei ändern. Der höchste Protokollierungsebenenwert ist FATAL, gefolgt von ERROR, WARN, INFO, DEBUG und dem niedrigsten Protokollierungsebenenwert TRACE. Wenn in einer config-Datei eine bestimmte Protokollierungsebene gesetzt ist, werden auch höhere Protokollierungsebenen angezeigt. Beispiel: Wenn Sie die Protokollierungsebene auf INFO setzen, werden auch die Protokollierungsebenen FATAL, ERROR und WARN angezeigt.

Dies bestimmt über den Protokolltyp. INFO generiert zum Beispiel informative Meldungen in den Protokolldateien.

Einige Kunden ändern möglicherweise auch den Wert für MaxAgeDays (Standard = 30) in 90 (dieser Wert legt fest, wie viele Tage die Protokolle aufbewahrt werden). Für manche Protokolldateien gibt es Einstellungen in config dafür, wie groß die Protokolldatei werden darf, bevor sie gelöscht wird (10 MB, 50 MB).

Das für Nlog-config-Dateien für IT Asset Management vorgegebene Basisverzeichnis ist C:\ProgramData\Flexera Software\Compliance\Logging\. Generierte Protokolldateien werden in diesem Verzeichnis gespeichert.

Das Basisverzeichnis kann durch ein Festlegen des Registry-Eintrags HKLM\SOFTWARE\WOW6432Node\ManageSoft Corp\ManageSoft\Compliance\CurrentVersion\LoggingBaseDirectory überschrieben werden.

Alle config-Dateien sind XML-Dokumente, die Nlog-Konfigurationsoptionen enthalten. Die Protokollierungsebene kann mit einem Texteditor bearbeitet werden. Als Beispiel finden Sie unten die Nlog-config-Datei der Inventarisierungsstation.

Die Nlog-config-Datei der Inventarisierungsstation:

<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      autoReload="true">
      <extensions>
      <add assembly="Flexera.Common.Logging"/>
      </extensions>
      <!-- the targets to write to -->
      <targets>
      <!-- write logs to file -->
      <target xsi:type="Console" name="console" layout="[${date:format=yyyy-MM-dd HH\:mm\:ss.fff}] [${level:padding=-5:fixedLength=true:uppercase=true}] ${message:exceptionSeparator=\r\n:withException=true}" />
      <target xsi:type="File" name="file" maxArchiveFiles="1000" archiveNumbering="Date" filename="${gdc:item=ComplianceLoggingPath:whenEmpty=${baseDir}}/InventoryBeacon/inventorybeacon.log"
      archiveEvery="Day" archiveDateFormat="yyyy-MM-dd" layout="${date:format=yyyy-MM-dd HH\:mm\:ss,fff} [${logger:padding=-22:fixedLength=true}] [${level:padding=-5:fixedLength=true:uppercase=true}] ${message:exceptionSeparator=\r\n:withException=true}" />
      </targets>
      <rules>
      <logger name="*" minlevel="Info" writeTo="file" />
      <logger name="*" minlevel="Info" writeTo="console" />
      </rules>
      </nlog>

Um den Wert der Protokollierungsebene zu ändern, können gegen Ende der config-Datei zwei verschiedene Ebenen konfiguriert werden: <logger name="*" minlevel="Info" writeTo="file" /> und <logger name="*" minlevel="Info" writeTo="console" />. Eine Ebene/Stufe gibt die Daten in einer Datei aus, die andere schreibt ein Protokoll in die Konsole. Es gibt sechs Ebenen (Stufen):

Protokollierungsebene	Details
INFO	Informative Meldungen
ERROR	Fehlermeldungen
WARN	Warnungen, die dem Benutzer der Anwendung nicht angezeigt werden
DEBUG	Weniger detaillierte und/oder weniger häufige Debugging-Meldungen
TRACE	Sehr detaillierte Protokollmeldungen, möglicherweise sehr häufig und umfangreich
FATAL	Fehlermeldungen über einen schwerwiegenden (fatalen) Fehler; nach einem solchen Fehler wird die Anwendung in der Regel beendet.

Konfigurieren der Protokollierung für den Inventarisierungsstationsserver

Die folgende Tabelle enthält Standarddaten der Protokollierungskonfiguration für verschiedene Komponenten und Subsysteme des Inventarisierungsstationsservers.

Komponente / Subsystem	Speicherort unter C:\ProgramData\Flexera Software\Compliance\Logging
Active-Directory-Import In diesem Protokoll wird die Ausführung der Active-Directory-Importe aufgezeichnet, die auf der Seite „Active Directory Imports“ (Active-Directory-Importe) der Benutzeroberfläche der Inventarisierungsstation konfiguriert sind. Dieses Protokoll zeichnet die LDAP-Verbindung auf, die mit dem Domänencontroller hergestellt wird, sowie den Import der Active-Directory-Informationen. Der Import erzeugt eine .actdir-Datei, die auf den Inventarisierungsserver hochgeladen wird.	ActiveDirectoryImport\ADImport.log
Beacon engine service (Dienst der Inventarisierungsstationsengine) Dieses Protokoll zeichnet Ereignisse vom Dienst der Inventarisierungsstationsengine auf. Es ist eines der Hauptprotokolle auf einem Inventarisierungsstationsserver und erfasst Informationen zu vielen Hintergrundaktivitäten der Inventarisierungsstation. Zu den Hauptereignissen, die erfasst werden, gehören beispielsweise: Herunterladen und Laden der Inventarisierungsstationsrichtlinie, Herunterladen von Updates für Ermittlungs- und Inventarisierungsregeln, Herunterladen der Exportdateien mit Ermittlungsergebnissen, Herunterladen aktualisierter XML-Dateien für den Importer.	BeaconEngine\BeaconEngine.log
Beacon IIS app (IIS-App der Inventarisierungsstation) Erfasst Ereignisse der Webserver-Komponente der Inventarisierungsstation. Der Webserver der Inventarisierungsstation generiert und verteilt die Agentenrichtlinie, Einstellungen und Upgrade-Dateien und akzeptiert vom Agenten eingehende Dateien.	BeaconIIS\BeaconIIS.log
Compliance Reader logs (Protokolle des Compliance-Reader) Erfasst Ereignisse von Compliance-Reader-Importen, die Daten aus externen Systemen lesen. Um die auf einer Inventarisierungsstation konfigurierten Importe einzusehen, können Sie die Seite „Inventory systems“ (Inventarisierungssysteme) auf der Benutzeroberfläche der Inventarisierungsstation anzeigen.	ComplianceReader\importer-[TTMMJJJJ]-[pid].log
Compliance upload (Compliance-Upload) Protokolliert Ereignisse beim Upload von Inventar, das aus externen Datenbanken extrahiert wurde, sowie Businessadapter-Daten. ComplianceUpload.exe wird vom geplanten Task zum Hochladen von Fremdanbieter-Inventardaten (Upload third party inventory data) gestartet. Dieser Vorgang umfasst nicht das Hochladen von Dateien, die von FlexNet-Inventarisierungsagenten (wie .ndi-Inventardateien usw.) eingegangen sind.	ComplianceUpload\upload.log
Discovery and inventory rules (Ermittlungs- und Inventarisierungsregeln) Zeichnet Ereignisse bei der Ausführung der Ermittlungs- und Inventarisierungsregeln auf. Sie können die konfigurierten Regeln auf der Benutzeroberfläche der Inventarisierungsstation auf der Seite mit den Regeln (Rules) einsehen. Jede Regelausführung generiert eine neue GUID (die eindeutige SessionUID des Tasks), die beim Speichern der Protokolldateien im Verzeichnispfad verwendet wird. Tipp: Sortieren Sie bei der Fehlerbehebung den Protokollierungsordner InventoryRule nach dem Datum der letzten Änderung, um den nach der manuellen Auslösung der Regelausführung zuletzt erstellten Ordner zu finden.	InventoryRule\<GUID>\*.log
Inventory Beacon UI and processes (Inventarisierungsstations-UI und -prozesse) Erfasst Ereignisse auf der Benutzeroberfläche der Inventarisierungsstation und verschiedene andere Tasks, die von der lokalen Inventarisierungsstation ausgeführt werden. Die Datei BeaconEngine.log ist in der Regel die wichtigste Datei, die Sie sich ansehen sollten, wenn Sie Fehler auf einer Inventarisierungsstation beheben wollen, aber auch ein Blick in diese Datei lohnt sich.	InventoryBeacon\inventorybeacon.log

IT Asset Management (Cloud)

Current