Konfigurieren Sie die Protokollierung für den PowerShell-Schritt

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer

    • Fügen Sie den Skripts in Ihrem PowerShell-Schritt Protokollnachrichten hinzu. Verwenden Sie Protokollebenen, um die Protokollierung und das Debugging zu verbessern.

    Vorbereitungen

    Um Ihrem Skript Protokollnachrichten hinzuzufügen, müssen Sie die Funktion Write-SNCLog verwenden. Diese Funktion ist im Modul IH\Logging.psm1 definiert. Verwenden Sie PSScript.ps1, um dieses Modul zu importieren, damit Inline-Skripts Zugriff auf Write-SNCLoghaben. Weitere Informationen finden Sie unter MID Server PowerShell-Dateien.

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > MID-Server > Eigenschaften.
    2. Legen Sie mid.property.powershell.log_info auf true fest.
      Diese Eigenschaft aktiviert oder deaktiviert die Protokollierung. Weitere Informationen finden Sie unter PowerShell-Protokolleigenschaft.
    3. Legen Sie mid.property.powershell.ih.log_level auf die gewünschte Protokollebene fest.
      Die Protokollebene gibt den Schwellenwert an, der zum Protokollieren einer Nachricht erforderlich ist. Nachrichten werden ab der angegebenen Ebene protokolliert. Wenn diese Eigenschaft beispielsweise auf WARN festgelegt ist, werden Nachrichten mit der Ebene WARN oder ERROR protokolliert. Nachrichten mit der Ebene INFO, DEBUG oder TRACE werden nicht protokolliert. Die Ebenen sind von niedrig nach hoch aufgelistet:
      • TRACE
      • DEBUG
      • INFO
      • WARN
      • FEHLER
      Der Standardwert ist INFO.
    4. Wahlweise: Konfigurieren Sie eine Systemeigenschaft, damit Sie die Protokolle in der Instanz anzeigen können.
      1. Navigieren zu Alle > Prozessautomatisierung > Flow Designer > Eigenschaften.
      2. Suchen Geben Sie die Protokollebene der Systemprotokolleinträge an, die im Flow-Protokoll repliziert werden sollen. Das System repliziert nur Protokolleinträge der angegebenen Ebene oder höher und legt sie auf INFO oder DEBUGfest.

      Nachdem Sie das PowerShell-Skript erstellt und ausgeführt haben, sind die Protokolle im MID Agent-Protokoll verfügbar. Durch die Konfiguration dieser Eigenschaft können Sie sie auch direkt in der Instanz anzeigen.

      Dieser Schritt legt die Eigenschaft com.glide.hub.flow_engine.listener_trace.threshold fest. Sie repliziert die Protokolle in die Tabelle „Flow-Engine-Protokolleinträge“ [sys_flow_log].

    5. Fügen Sie in Ihrem PowerShell-Skript Protokollnachrichten und -ebenen mit der Funktion Write-SNCLog hinzu.
      Tabelle : 1. Write-SNCLog-Funktion und -Parameter
      Name Beschreibung
      Write-SNCLog- Funktion Protokollieren Sie eine Nachricht für den PowerShell-Schritt. Write-SNCLog verfügt über zwei Parameter: -Level und -Message. Beide Parameter sind erforderlich, die Parameternamen jedoch nicht. Wenn die Namen ausgelassen werden, wird die Position verwendet, um die Ebene und die Nachricht zu bestimmen. Beispiele:
      • Write-SNCLog -Level WARN – Nachricht „Protokollwarnung“
      • Write-SNCLog WARN „Protokollwarnung“
      In beiden Beispielen wird WARN: log warning protokolliert.
      -Level Parameter Geben Sie die Ebene für die Protokollnachricht an. Gültige Werte sind:
      • FEHLER
      • WARN
      • INFO
      • DEBUG
      • TRACE
      Dieser Parameter ist erforderlich.
      -Message Parameter Geben Sie die zu protokollierende Nachricht an. Als Zeichenfolge eingegeben. Dieser Parameter ist erforderlich.
    6. Erstellen Sie Ihre Aktion oder Ihren Flow weiter, testen Sie sie und führen Sie sie aus.

    Nächste Maßnahme

    Die neuen Protokolle sind im MID Agent-Protokoll verfügbar und können vom MID Server heruntergeladen werden. Weitere Informationen finden Sie unter MID Server-Dateien herunterladen.

    Wenn Sie die Systemeigenschaft so festlegen, dass die Protokolle in der Instanz angezeigt werden, werden sie auf der Registerkarte Flow-Engine-Protokolleinträge des Flow-Engine-Kontextdatensatzes angezeigt. Weitere Informationen finden Sie unter Flow-Ausführungsdetails.