Überwachen der Workflow-Ausführung monitoring-workflow-execution
Dieser Abschnitt enthält Informationen zur Überwachung der Ausführung Ihrer Workflows.
Ein Anwendungsbeispiel zum Erstellen eines Workflows, mit dem Sie den Status einer Reihe von Workflows überwachen können, die „ausgesetzt“, „angehalten“ oder „Mit Fehlern“ sind, finden Sie zudem in diesem Abschnitt.
Darüber hinaus können Administratoren der Instanz das Audit-Protokoll verwenden, um Aktivitäten und letzte Änderungen an Workflows und somit den Zustand Ihrer Workflows zu überprüfen. Weitere Informationen zum Audit-Protokoll finden Sie in der Dokumentation zu Campaign Classic v7.
Fortschritt anzeigen displaying-progress
Die Ausführung des Workflows kann am Bildschirm verfolgt werden.
Wenn Sie auf das Symbol Fortschritt anzeigen klicken, werden Workflow-Ausführung, -Status und Ergebnis der Aktivitäten am Bildschirm dargestellt.
In diesem Fall erscheinen laufende Aktivitäten in Blau, ausstehende Aktivitäten blinken und Warnhinweise und Fehler werden in Orange bzw. Rot angezeigt. Des Weiteren werden auf den ausgehenden Transitionen die Ergebnisse der Aktivitäten eingeblendet, gefolgt vom in der Aktivität definierten Ergebnistitel sowie der Ausführungsdauer, wenn sie mehr als eine Sekunde beträgt.
Protokoll anzeigen displaying-logs
Das Protokoll enthält den Verlauf der Workflow-Ausführung. Es speichert die von den Benutzern angeforderten Befehle, ausgeführte Vorgänge und aufgetretene Fehler. Sie haben die Möglichkeit:
-
im Tab Verfolgung das Workflow-Protokoll einzusehen.
-
Filtern Sie die Protokollnachrichten nach Aktivität. Klicken Sie dazu auf Aufgaben und Protokoll anzeigen in der Symbolleiste über dem Diagramm, um die Registerkarten Protokoll und Aufgaben unterhalb des Diagramms anzuzeigen. Wählen Sie eine Aktivität aus, um alle zugehörigen Nachrichten anzuzeigen. Diese Liste enthält alle Nachrichten, wenn keine Aktivität ausgewählt ist.
note note NOTE Durch Klicken auf den Diagrammhintergrund werden alle Markierungen entfernt. -
Sie können entscheiden, nur die Nachrichten anzuzeigen, die mit einer bestimmten Aufgabe verknüpft sind. Wählen Sie dazu zunächst die Registerkarte Aufgaben und anschließend eine Aktivität im Diagramm aus, um die Liste einzuschränken. Doppelklicken Sie auf eine Aufgabe, um die Informationen anzuzeigen. Die letzte Registerkarte im Fenster enthält das Protokoll.
Durch Klicken auf die Schaltfläche Details… können Sie zusätzliche Informationen bezüglich der Aktivitätsausführung einsehen. Beispielsweise erscheinen hier die validierende Person und gegebenenfalls der Kommentar, den diese eingegeben hat.
Die Nachrichten bezüglich der Ausführung der Workflow-Aktivitäten werden im Protokoll in chronologischer Reihenfolge aufgelistet.
-
Protokoll einer Zielgruppenbestimmung
Klicken Sie nach einer Zielgruppenbestimmung auf den Tab Verfolgung, um die einzelnen Schritte der Ausführung nachzuvollziehen.
Alle Vorgänge, Warnhinweise und Fehler werden protokolliert.
-
Protokoll einer Aktivität
Auch die Ausführung von Aktivitäten wird detailliert protokolliert. Sie haben zwei Möglichkeiten, die Nachrichten einzusehen:
-
Markieren Sie die gewünschte Aktivität und klicken Sie auf die Schaltfläche Aufgaben und Protokoll anzeigen.
Unter dem Diagramm erscheinen nun die Tabs Protokoll und Aufgaben.
Die Markierung einer Aktivität im Diagramm arbeitet wie ein Filter in Bezug auf das Protokoll und die Aufgabenliste.
-
Klicken Sie mit der rechten Maustaste auf die gewünschte Aktivität und wählen Sie die Option Protokoll anzeigen.
Das Protokoll öffnet sich in einem separaten Fenster.
-
Verläufe bereinigen purging-the-logs
Workflow-Verläufe werden nicht automatisch bereinigt: Alle Nachrichten werden standardmäßig beibehalten. Der Verlauf kann über das Menü Datei > Aktionen oder durch Klicken auf die Schaltfläche Aktionen in der Symbolleiste oberhalb der Liste bereinigt werden. Wählen Sie Verlauf bereinigen aus. Die im Menü Aktionen verfügbaren Optionen werden im Abschnitt Aktionen-Symbolleiste beschrieben.
Arbeitstabellen und Workflow-Schemata worktables-and-workflow-schema
Workflows verwenden diverse Arbeitstabellen, die mithilfe bestimmter Aktivitäten bearbeitet werden können. Adobe Campaign bietet über Data-Management-Aktivitäten die Möglichkeit, Spalten aus Workflow-Arbeitstabellen umzuwandeln, umzubenennen oder anzureichern. Auf diese Weise können beispielsweise Nomenklaturen angepasst oder zusätzliche Informationen erhoben werden.
Es ist des Weiteren möglich, Relationen zwischen verschiedenen Arbeitsdimensionen herzustellen und Dimensionswechsel zu definieren. So können Sie beispielsweise festlegen, dass Kommunikationen an den Beitragszahler einer Police gerichtet werden, dabei aber die Daten des Mitversicherten in den Zusatzinformationen zu berücksichtigen sind.
Die Arbeitstabellen des Workflows werden automatisch gelöscht, wenn der Workflow passiviert. Wenn Sie eine Arbeitstabelle beibehalten möchten, speichern Sie sie über die Aktivität Listen-Update in einer Liste (siehe Listen-Update).
Fehler beheben managing-errors
Wenn ein Fehler auftritt, wird der Workflow ausgesetzt und die bei Fehlerauftritt ausgeführte Aktivität blinkt rot. In der Workflow-Übersicht können Sie über den Link Workflows im Tab Monitoring wie unten dargestellt nur Workflows mit Fehlern anzeigen.
Im Explorer enthält die Listenansicht der Workflows standardmäßig die Spalte Fehlgeschlagen.
Wenn ein Workflow fehlerhaft ist, werden die zur Workflow-Überwachungsgruppe gehörenden Benutzenden per E-Mail benachrichtigt, sofern ihre E-Mail-Adresse in ihrem Profil angegeben ist. Diese Gruppe ist im Feld Verantwortliche® der Workflow-Eigenschaften ausgewählt.
Der Benachrichtigungsinhalt wird in der Standardvorlage Benachrichtigung des Workflow-Verantwortlichen konfiguriert, welche im Tab Ausführung der Workflow-Eigenschaften ausgewählt werden kann. Die Benachrichtigung enthält den Namen des fehlgeschlagenen Workflows und die vom Fehler betroffene Aufgabe.
Beispiel einer Benachrichtigung:
Über den Link können Sie im Web-Modus auf die Client-Konsole in Adobe Campaign zugreifen. Nach Anmeldung können Sie dann den fehlgeschlagenen Workflow bearbeiten.
Es besteht die Möglichkeit, das Aussetzen des Workflows im Falle von Fehlern zu vermeiden und die sich anschließenden Aufgaben wie geplant auszuführen. Bearbeiten Sie dazu den Workflow Eigenschaften und wählen Sie im Abschnitt Umgang mit Fehlern die Option Ignorieren im Feld Bei Fehler aus. Sie können dann die Anzahl der aufeinanderfolgenden Fehler angeben, die ignoriert werden können, bevor der Prozess angehalten wird.
In diesem Fall wird die fehlerhafte Aufgabe abgebrochen. Dieser Modus ist insbesondere bei Workflows mit wiederkehrenden Aktionen angebracht, die darauf ausgelegt sind, die Kampagne zu einem späteren Zeitpunkt erneut zu starten.
Fehler verarbeiten processing-errors
Auf Aktivitätsniveau erscheint im Falle von Fehlern eine zusätzliche Transition, wenn die Option Fehler verarbeiten aktiviert wurde. Auf diese Weise wird der Workflow nicht ausgesetzt, sondern bis zum Ende ausgeführt.
Dies gilt für Fehler des Dateisystems (Datei kann nicht verschoben werden, Zugriff auf das Verzeichnis nicht möglich usw.).
Fehler, die aus der Konfiguration der Aktivität resultieren, d. h. ungültige Werte (z. B. inexistentes Verzeichnis), aktivieren die zusätzliche Transition nicht.
Die Ausführung eines - manuell oder aufgrund eines Fehlers - ausgesetzten Workflows kann mithilfe der Schaltfläche Starten dort wieder aufgenommen werden, wo sie unterbrochen wurde. Die fehlerhafte oder ausgesetzte Aktivität wird erneut ausgeführt, nicht jedoch die vorangehenden Aktivitäten.
Verwenden Sie die Schaltfläche Neu starten, um alle Workflow-Aktivitäten erneut auszuführen.
Änderungen an bereits ausgeführten Aktivitäten werden somit nicht berücksichtigt, wenn die Workflow-Ausführung wiederaufgenommen wird.
Änderungen an noch nicht ausgeführten Aktivitäten werden jedoch berücksichtigt, wenn die Workflow-Ausführung wiederaufgenommen wird.
Änderungen an der ausgesetzten Aktivität werden bei der Wiederaufnahme der Workflow-Ausführung unter Umständen nicht korrekt berücksichtigt.
Es wird daher empfohlen, die Workflow-Ausführung nach Änderungen komplett neu zu starten.
Instanz-Monitoring instance-supervision
Die Seite Instanz-Monitoring bietet die Möglichkeit, den Adobe Campaign-Server zu überwachen. Sie enthält die Liste fehlgeschlagener Workflows und Sendungen.
Auf diese Seite können Sie über den Tab Monitoring zugreifen. Klicken Sie auf die Schaltfläche Übersicht.
Um nur die fehlgeschlagenen Workflows anzuzeigen, klicken Sie auf die Schaltfläche Workflows und wählen Sie aus der Dropdown-Liste den Status aus.
Durch Klick auf den Namen eines Workflows öffnet sich dieser und Sie können das Protokoll einsehen.
Mehrere gleichzeitige Ausführungen verhindern preventing-simultaneous-multiple-executions
Ein einzelner Workflow kann mehrere gleichzeitig ablaufende Ausführungen enthalten. In manchen Situationen sollte dies verhindert werden.
Beispielsweise könnte die Workflow-Ausführung stündlich ausgelöst werden, manchmal aber länger als eine Stunde dauern. Wenn der Workflow bereits ausgeführt wird, ist es empfehlenswert, den Start einer weiteren Ausführung zu überspringen.
Wenn vor dem Beginn eines Workflows eine Signalaktivität erfolgt und der Workflow bereits läuft, sollte das Signal übersprungen werden.
Allgemein gilt:
In dieser Situation wird eine Instanzvariable verwendet, die für alle parallelen Ausführungen von Workflows gültig ist.
Hier ist ein einfacher Test-Workflow:
Die Planung löst jede Minute ein Ereignis aus. Mit der folgenden Test-Aktivität wird die Instanzvariable isRunning getestet, um zu entscheiden, ob die Ausführung fortgesetzt werden soll oder nicht:
In der Aktivität, die unmittelbar auf Test im Zweig yes folgt, muss die Instanzvariable im Initialisierungsscript auf true gesetzt werden:
instance.vars.isRunning = true
In der letzten Aktivität im Zweig yes muss die Variable in im Initialisierungsscript wieder auf false gesetzt werden:
instance.vars.isRunning = false
Bitte beachten Sie Folgendes:
-
Den aktuellen Wert der Instanzvariable können Sie im Tab Variablen im Workflow Eigenschaften prüfen.
-
Beim erneuten Start eines Workflows werden die Instanzvariablen zurückgesetzt.
-
In JavaScript ist ein nicht definierter Wert in einem Test auf false gesetzt. Dadurch kann die Instanzvariable noch vor ihrer Initialisierung geprüft werden.
-
Sie können die aufgrund dieses Mechanismus nicht verarbeiteten Aktivitäten überwachten, indem Sie dem Initialisierungsscript des "Nein"-Zweigs eine Protokollierungsanweisung hinzufügen.
code language-none logInfo("Workflow already running, parallel execution not allowed.");
Im Abschnitt Datenaktualisierungen koordinieren wird ein Anwendungsbeispiel vorgestellt.
Wartung der Datenbank database-maintenance
Workflows verwenden zahlreiche Arbeitstabellen, die Speicherplatz belegen und die gesamte Plattform verlangsamen, wenn sie nicht gewartet werden.
Der Workflow Datenbankbereinigung, auf den Sie über den Knoten Administration > Produktion > Technische Workflows zugreifen können, ermöglicht das Löschen veralteter Daten, um das exponentielle Anwachsen der Datenbank zu verhindern. Der Workflow wird automatisch ohne das Eingreifen der benutzenden Person ausgelöst.
Sie können auch spezifische technische Workflows erstellen, um unnötige Daten zu entfernen, die Speicherplatz belegen. Näheres dazu finden Sie in diesem Abschnitt.
Handhaben von ausgesetzten Workflows handling-of-paused-workflows
Die Arbeitstabellen ausgesetzter Workflows werden standardmäßig nie bereinigt. Ab Build 8880 werden Workflows, die zu lange in einem ausgesetzten Zustand angehalten werden, automatisch gestoppt und deren Arbeitstabellen bereinigt. Dieses Verhalten wird wie folgt ausgelöst:
- Sind Workflows länger als sieben Tage ausgesetzt, erscheint ein Warnhinweis im Monitoring-Dashboard (und in der Monitoring-API) und es wird eine Benachrichtigung an die Supervisoren-Gruppe gesendet.
- Dasselbe passiert jede Woche, wenn der technische Workflow cleanupPausedWorkflows ausgelöst wird. Weitere Informationen zum Workflow finden Sie in diesem Abschnitt.
- Nach vier Benachrichtigungen (d. h. standardmäßig nach einem Monat im ausgesetzten Zustand) wird der Workflow bedingungslos gestoppt. Ein Protokoll wird im Workflow angezeigt, nachdem er angehalten wurde. Die Tabellen werden bei der nächsten Ausführung des Workflows Bereinigung bereinigt
Diese Zeiträume können mit der Option NmsServer_PausedWorkflowPeriod konfiguriert werden.
Die Verantwortlichen des Workflows sowie der Ersteller und der letzte Benutzer, der den Workflow modifiziert hat, werden benachrichtigt. Administratoren erhalten keine Benachrichtigung.
Filtern von Workflows nach ihrem Status filtering-workflows-status
Mit der Oberfläche von Campaign Classic können Sie den Ausführungsstatus aller Workflows in Ihrer Instanz mithilfe vordefinierter Ansichten überwachen. Um auf diese Ansichten zuzugreifen, öffnen Sie den Knoten Administration / Verfolgung / Status des Workflows.
Folgende Ansichten stehen zur Verfügung:
- Wird ausgeführt: listet alle ausgeführten Workflows auf.
- Ausgesetzt: listet alle ausgesetzten Workflows auf.
- Fehlgeschlagen: listet alle fehlgeschlagenen Workflows auf.
- ** ).
Standardmäßig sind diese Ansichten im Ordner Verfolgung aufrufbar. Sie können sie jedoch an einer Stelle Ihrer Wahl in der Ordnerstruktur neu erstellen. Auf diese Weise sind sie für Standardbenutzer ohne Administratorrechte verfügbar.
Gehen Sie dazu wie folgt vor:
- Klicken Sie mit der rechten Maustaste auf den Ordner, in dem Sie die Ansicht hinzufügen möchten.
- Wählen Sie unter Ordner hinzufügen / Administration die Ansicht aus, die Sie hinzufügen möchten.
- Nachdem der Ordner zum Baum hinzugefügt wurde, stellen Sie sicher, dass Sie ihn als Ansicht konfigurieren, damit alle Workflows unabhängig vom Ursprungsordner angezeigt werden. Weiterführende Informationen zum Einfügen von Ansichten finden Sie auf dieser Seite.
Zusätzlich zu diesen Ansichten können Sie Filterordner einrichten, mit denen Sie die Liste der Workflows nach ihrem Ausführungsstatus filtern können. Gehen Sie dazu wie folgt vor:
- Rufen Sie einen Ordner vom Typ „Workflow“ auf und wählen Sie dann das Menü Filter / Erweiterter Filter.
- Konfigurieren Sie den Filter so, dass das Feld @status des Workflows dem Status Ihrer Wahl entspricht.
- Speichern und benennen Sie den Filter. Er ist dann direkt in der Filterliste verfügbar.
Weitere Informationen finden Sie in den folgenden Abschnitten: