Skriptbeispiel im Jitterbit App Builder - Protokollierung

Logging nutzt die Logging-API von Microsoft. Die Protokollierung unterstützt das Debuggen und die Wartung eines Plugin und gibt Einblick in aktuelle Werte sowie erwartetes und unerwartetes Verhalten. Das Beispiel in diesem Artikel zeigt, wie Nachrichten protokolliert werden.

Protokollschweregrad

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

Schweregrade

Microsoft-Schweregrad	App Builder-Schweregrad	Beschreibung
Off	Off	Konfigurationsstatus, bei dem das Zielprotokoll keine Nachricht 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, beispielsweise 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.

Script

using Microsoft.Extensions.Logging;

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

logger.LogWarning("My warning message");

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");

    }
}

Hinweis

Jede vom Bereich hinzugefügte Eigenschaft ist gesichert. Das bedeutet, dass sie aufgezeichnet und angezeigt werden muss Sichere Daten protokollieren muss ON.

Weitere Informationen

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