Skriptbeispiel im Jitterbit App Builder - Protokollierung

Logging nutzt die Logging-API von Microsoft. Logging hilft beim Debuggen und Warten eines Plugins und gibt Einblick in aktuelle Werte sowie erwartetes und unerwartetes Verhalten. Das Beispiel in diesem Artikel zeigt, wie Nachrichten protokolliert werden.

Schweregrad des Protokolls

Eine Nachricht wird nur protokolliert, wenn der Schweregrad gleich oder höher als der unter App Server-Protokollkonfiguration für jede Protokollzielkonfiguration (Speicher, Datenbank und Festplatte) unter Mindestschweregrad konfigurierte Wert ist.

Schweregrade

Microsoft-Schweregrad	App Builder Schweregrad	Beschreibung
`Off`	`Off`	Konfigurationsstatus, bei dem das Zielprotokoll keine Nachrichten schreibt; nicht zur Verwendung beim Protokollieren vorgesehen.
`Trace`	`Trace`	Detaillierte Meldung der kleinsten Schritte, dieser Status sollte in Produktionsumgebungen vermieden werden.
`Debug`	`Debug`	Wird während der Entwicklung verwendet, um Zustand und Verhalten zu untersuchen.
`Information`	`Info`	Wird verwendet, um das erwartete Verhalten zu verfolgen, z. B. die erfolgreiche Verarbeitung einer Datei.
`Warning`	`Warn`	Wird verwendet, wenn ein Verhalten oder Zustand noch nicht schädlich ist, aber beachtet werden sollte, z. B. wenn auf der Festplatte nicht genügend Speicherplatz vorhanden ist.
`Error`	`Error`	Wird verwendet, wenn der aktuelle Prozess aufgrund eines Fehlers angehalten werden muss, beispielsweise aufgrund eines unerwarteten Datenwerts aus einer Datei.
`Critical`	`Fatal`	Wird verwendet, wenn ein Fehler sofortige Aufmerksamkeit erfordert.

App-Server-Konfigurationsbildschirm, der den für die Speicherprotokollkonfiguration festgelegten Info-Schweregrad veranschaulicht

Script

using Microsoft.Extensions.Logging;

var logger = Services.GetRequiredService<ILogger>();

logger.LogWarning("My warning message");

Bild

Umfang

Die Bereichseinteilung wird unterstützt und ermöglicht das Anhängen zusätzlicher Informationen an den Protokolldatensatz.

using Microsoft.Extensions.Logging;
using System.Collections.Generic;

var logger = Services.GetRequiredService<ILogger>();

logger.LogError("My unscoped error message");

// Appends "MyScope" to the log source
using (logger.BeginScope("MyScope")) {

    logger.LogWarning("My scoped warning");

    // Tags log records with the extra identifing properties.
    using (logger.BeginScope(new Dictionary<string, object>{
       `["Kunden-ID"] `= 123,
       `["Bestell-Nr"] `= 12
    })) {

        logger.LogWarning("My warning with extra data");

    }
}

Beispielausgabe von Speicherprotokollen mit konfiguriertem Gültigkeitsbereich

Hinweis

Jede vom Bereich hinzugefügte Eigenschaft wird gesichert, d. h. sie muss aufgezeichnet und angezeigt werden Sichere Daten protokollieren muss ON.

Weitere Informationen

Weitere Informationen zur Logger API von Microsoft sowie seine Erweiterungsmethoden im .NET API Browser von Microsoft.