Definieren Sie, welcher Teil der Prozessausführung protokolliert wird und wie lange.
Geschrieben vonOssi Galkin Vor über einer Woche aktualisiertTable of contentsSie können konfigurieren, welche Informationen für jede Ausführung eines Prozesses protokolliert werden und wie lange die Daten gespeichert werden. Sie definieren diese Prozessprotokolleinstellungen pro Umgebung. Sie können die Einstellungen auf Umgebungsebene bei Bedarf auch pro Prozess überschreiben.
Die Standardeinstellungen für das Prozessprotokoll auf Umgebungsebene werden in der Prozesslistenansicht für die Umgebung verwaltet. Durch Klicken auf die Schaltfläche „Protokolleinstellungen“ wird das Dialogfeld „Prozessprotokolleinstellungen“ für die ausgewählte Umgebung geöffnet.
Protokollebene
Die Protokollebene bestimmt, wie viele Informationen für jeden ausgeführten Prozessschritt protokolliert werden. Die folgenden Protokollebenen sind verfügbar, von der geringsten bis zur größten Menge protokollierter Daten:
Die Protokollebene bestimmt, wie viele Informationen für jeden ausgeführten Prozessschritt protokolliert werden. Die folgenden Protokollebenen sind verfügbar, von der geringsten bis zur größten Menge protokollierter Daten:
Nur Fehler
Wie der Name schon sagt, werden mit dieser Einstellung der Protokollebene nur Fehler protokolliert. Es werden keine Daten zur Ausführung von Schritten oder Unterprozessen protokolliert, was die Prozessausführung und die Verarbeitung von Protokollnachrichten insgesamt beschleunigt.
Wenn innerhalb des Prozesses eine Ausnahme auftritt, werden die für diese Aufgabe oder diesen Unterprozess verwendeten Parameter zusammen mit der Ausnahme protokolliert. Die Ergebnisse von Schritten, die so eingestellt sind, dass sie das Ergebnis fördern, werden wie immer ebenfalls protokolliert.
Beachten Sie, dass, wenn Sie Ergebnisse in Unterprozessen hochgestuft haben oder Ausnahmen behandeln, ohne sie erneut auszulösen, die Unterprozessinstanzen selbst nicht unter der Protokollebene „Nur Fehler“ protokolliert werden, die Schritte jedoch schon. Dies kann zu einer redundanten Protokollierung von Daten führen, die Sie eigentlich nicht anzeigen können. Die Daten werden schließlich gelöscht, aber für eine optimale Leistung sollten Sie Ergebnisse von Unterprozessen nicht unter der Protokollebene „Nur Fehler“ hochstufen.
Standard
Die Standardprotokollebene protokolliert Ergebnisse für jeden in einem Diagramm ausgeführten Schritt, mit Ausnahme von Foreach-Elementen. Parameter für Aufgaben und Unterprozesse werden standardmäßig nicht protokolliert, ebenso wenig wie die in Ausdrücken für Bedingungszweige oder While-Schleifen verwendeten Variablenreferenzen. Falls Parameter oder Ergebnisse sehr groß sind (über 10.000 Zeichen), wird der protokollierte Wert abgeschnitten.
Die Standardprotokollebene protokolliert Ergebnisse für jeden in einem Diagramm ausgeführten Schritt, mit Ausnahme von Foreach-Elementen. Parameter für Aufgaben und Unterprozesse werden standardmäßig nicht protokolliert, ebenso wenig wie die in Ausdrücken für Bedingungszweige oder While-Schleifen verwendeten Variablenreferenzen. Falls Parameter oder Ergebnisse sehr groß sind (über 10.000 Zeichen), wird der protokollierte Wert abgeschnitten.
In Arrays werden nur die ersten 100 Elemente protokolliert, auch die, die als Parameter in Foreach-Schleifen verwendet werden. Jedes Element kann maximal 10.000 Zeichen lang sein, bevor der protokollierte Wert abgeschnitten wird.
Alles
Manchmal müssen Sie alles wissen, was innerhalb eines Prozesses passiert. Dies ist besonders nützlich, wenn Sie einen neuen Prozess entwickeln. Mit der Protokollebene „Alles“ werden alle Parameter und Ergebnisse protokolliert. Bei bedingten Ausdrücken werden auch referenzierte Variablenwerte protokolliert. Die Protokollebene „Alles“ protokolliert die vollständigen Werte und kürzt keine großen Ergebnis- oder Parametersätze, wie dies bei der Standardprotokollebene der Fall wäre.
Protokollprozessparameter und Rückgabewert
Bei manchen Prozessen sind Sie möglicherweise vor allem an der Ausführungsleistung und Latenzzeit interessiert. Dies gilt insbesondere für häufig aufgerufene API-Prozesse. Wenn Sie die Protokollebene für solche Prozesse auf „Nur Fehler“ einstellen, wird die Ausführung beschleunigt und die Menge redundanter Protokolldaten reduziert.
Möglicherweise möchten Sie jedoch trotzdem die vollständigen Anforderungs- und Antwortdaten für den Prozess protokollieren, z. B. für interne Prüfzwecke. Dazu können Sie die Option „Prozessparameter und Rückgabewert protokollieren“ aktivieren. Wenn diese Option aktiviert ist, werden alle vom Trigger übergebenen Prozesseingabeparameter sowie alle zurückgegebenen Werte (einschließlich Zwischenrückgabewerte) protokolliert. Die Daten sind dann in der Prozessinstanzliste sichtbar.
Aufbewahrungszeitraum für den Prozessinstanzverlauf
Um zu verhindern, dass die Größe der Protokolldatenbank unkontrolliert wächst, löscht der Frends Log Service regelmäßig alte Prozessinstanzen aus der Datenbank. Standardmäßig werden alle Prozessinstanzen gelöscht, die älter als 60 Tage sind. Sie können jedoch die Aufbewahrungsdauer für eine bestimmte Agentengruppe oder einzelne Prozesse nach Bedarf festlegen. SieheDatenbankwartungfür weitere Informationen.
Einstellungen auf Prozessebene
Wenn ein oder mehrere in einer Umgebung bereitgestellte Prozesse andere Protokollierungsanforderungen haben als die übrigen Prozesse, können Sie die Einstellungen auf Umgebungsebene für einzelne Prozesse überschreiben. Wenn Sie im Aktionsmenü des Prozesses auf „Protokolleinstellungen“ klicken, wird das Dialogfeld „Prozessspezifische Protokolleinstellungen“ geöffnet. Dort können Sie die Einstellungen auf Umgebungsebene überschreiben, indem Sie die Option „Umgebungseinstellungen verwenden“ deaktivieren.
Um zu verhindern, dass Sie vergessen, alles in einem Prozess zu protokollieren, können Sie festlegen, dass alles in einem Prozess bis zu 24 Stunden lang protokolliert wird. „Alles protokollieren für“ überschreibt die Umgebungseinstellung für die ausgewählte Zeit und somit wird alles protokolliert. Wenn „Umgebungseinstellung verwenden“ ausgewählt ist, wird die aktuell aktive Umgebungseinstellung mit einer Schattenfarbe angezeigt.
Wenn „Umgebungseinstellungen verwenden“ nicht aktiviert ist, überschreiben die Einstellungen alle Einstellungen auf Umgebungsebene. Wenn Sie später zu den Einstellungen auf Umgebungsebene zurückkehren möchten, aktivieren Sie die Option einfach erneut.
Empfehlungen
Da das Protokollieren großer Datenmengen die Leistung beeinträchtigen kann, empfiehlt es sich, Produktionsumgebungen so einzurichten, dass so wenig wie möglich protokolliert wird. Beispiel:
Stellen Sie die Protokollebene auf „Nur Fehler“ ein.
Deaktivieren Sie „Prozessparameter und Rückgabewert protokollieren“.
Legen Sie den Aufbewahrungszeitraum für den Prozessinstanzverlauf auf den kürzesten Zeitraum fest, den Sie voraussichtlich benötigen.
Sie können dann die Protokolleinstellungen für Prozesse mit strengeren Anforderungen außer Kraft setzen, indem Sie beispielsweise eine längere Protokollaufbewahrungsfrist festlegen.
Verwandte ArtikelSo verwenden Sie einen bedingten Trigger, um einen Prozess zu starten, wenn die Datei auf dem SFTP-Server gefunden wirdEinführung in den Call-SubprozessEinführung in die Verwendung von Unterprozessen in anderen ProzessenBest Practices zum Anmelden bei FreundenEinführung in die Protokollebene