Ü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 auf dieser Seite.

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.

Wenn diese Option ausgewählt ist, werden ausgeführte Aktivitäten blau angezeigt, ausstehende Aktivitäten blinken, Warnungen orange und Fehler rot. Diese Option zeigt auch das Ergebnis der Aktivitäten in der ausgehenden Transition an, gefolgt vom Titel des Ergebnisses, wie in den Aktivitätseigenschaften definiert, und der Dauer des Vorgangs, wenn dieser eine Sekunde überschreitet

Protokoll anzeigen displaying-logs

Das Protokoll enthält den Verlauf oder das Audit-Protokoll des Workflows. Es werden alle Benutzeraktionen, alle ausgeführten Vorgänge und aufgetretenen Fehler registriert. Sie haben folgende Möglichkeiten:

  • Wählen Sie die Tracking im Detail aus. Diese Liste enthält alle Workflow-Nachrichten.

  • 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
    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.

    Mit Schaltfläche „Details… können Sie alle zusätzlichen Informationen zur Aktivitätsausführung anzeigen. Sie können beispielsweise den validierenden Benutzer und ggf. den Kommentar anzeigen, den dieser während der Validierung eingegeben hat.

NOTE
Das Protokoll wird beim Neustart eines Workflows nicht gelöscht. Alle Nachrichten werden beibehalten. Wenn Sie die Nachrichten einer früheren Ausführung verwerfen möchten, müssen Sie den Verlauf bereinigen.

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

    Sie können auch das Ausführungsprotokoll und Details jeder Aktivität anzeigen. Dazu gibt es zwei Möglichkeiten:

    1. 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.

    2. 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

Der Workflow übermittelt Arbeitstabellen, die über bestimmte Aktivitäten bearbeitet werden können. Adobe Campaign ermöglicht es Ihnen, mithilfe von Daten-Management-Aktivitäten die Spalten der Workflow-Arbeitstabellen zu ändern, umzubenennen und anzureichern, z. B. um sie an die Nomenklatur gemäß den Anforderungen des Kunden anzupassen, um zusätzliche Informationen über den Mitbegünstigten eines Vertrags zu sammeln usw.

Es ist auch möglich, Verknüpfungen zwischen verschiedenen Arbeitsdimensionen zu erstellen und Dimensionsänderungen zu definieren. So ist beispielsweise für jeden in der Datenbank gespeicherten Vertrag der Hauptinhaber anzugeben und die Daten des Mitinhabers in den Zusatzinformationen zu verwenden.

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 Workflow-Manager-Benachrichtigung konfiguriert: Diese Vorlage wird auf der Registerkarte Ausführung der Workflow-Eigenschaften ausgewählt. Die Benachrichtigung zeigt den Namen des Fehler-Workflows und der betroffenen Aufgabe an.

Beispiel einer Benachrichtigung:

Über den Link können Sie im Web-Modus auf die Adobe Campaign-Client-Konsole 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 Fehleraufgabe abgebrochen. Dieser Modus eignet sich besonders für Workflows, mit denen die Kampagne später erneut versucht wird (periodische Aktionen).

NOTE
Es besteht die Möglichkeit, diese Vorgehensweise individuell für jede Aktivität zu konfigurieren. Bearbeiten Sie dazu die Aktivitätseigenschaften und wählen Sie den Modus „Umgang mit Fehlern“ auf der Registerkarte Erweitert aus.

Fehler verarbeiten processing-errors

Bei Aktivitäten zeigt die Option Fehler verarbeiten eine bestimmte Transition an, die aktiviert wird, wenn ein Fehler auftritt. In diesem Fall wechselt der Workflow nicht in den Fehlermodus und die Ausführung wird fortgesetzt.

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, beispielsweise durch Angabe von ungültigen Werten (z. B. inexistentes Verzeichnis), werden nicht verarbeitet. Fehler im Zusammenhang mit der fehlerhaften Konfiguration werden diese Transition nicht ermöglichen (Verzeichnis existiert nicht usw.).

Wenn ein Workflow angehalten wurde (manuell oder automatisch nach einem Fehler), wird die Workflow Ausführung mit der Schaltfläche Starten“ dort neu gestartet, wo er gestoppt wurde. Die fehlerhafte Aktivität (oder angehaltene Aktivität) wird erneut ausgeführt. Die vorherigen Aktivitäten werden nicht erneut ausgeführt.

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 neu gestartet wird.

Änderungen an noch nicht ausgeführten Aktivitäten werden jedoch berücksichtigt, wenn die Workflow-Ausführung neu gestartet wird.

Änderungen an der ausgesetzten Aktivität werden beim Neustart 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 alle Workflows anzuzeigen, klicken Sie auf den Link Workflows. Verwenden Sie die Dropdown-Liste, um die Workflows in der Plattform basierend auf ihrem Status anzuzeigen.

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

In einem Workflow können mehrere Ausführungen gleichzeitig ausgeführt werden. In einigen Fällen sollten Sie dies verhindern.

Beispielsweise kann eine Planung die Workflow-Ausführung stündlich auslösen, während die Ausführung des gesamten Workflows aber mehr als eine Stunde dauert. Sie können die Ausführung ggf. überspringen, wenn der Workflow bereits ausgeführt wird.

Wenn vor dem Beginn eines Workflows eine Signalaktivität erfolgt und der Workflow bereits läuft, sollte das Signal übersprungen werden.

Allgemein gilt:

Die Lösung besteht darin, eine Instanzvariable zu verwenden. Instanzvariablen werden von allen parallelen Ausführungen der Workflows gemeinsam genutzt.

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:

NOTE
isRunning ist ein Variablenname, der für dieses Beispiel ausgewählt wurde. Dies ist keine integrierte Variable.

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 Neustart 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

In Workflows werden zahlreiche Arbeitstabellen verwendet, die Speicherplatz benötigen und mit der Zeit die gesamte Plattform verlangsamen, wenn sie nicht gewartet wird.

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 vermeiden. Der Workflow wird automatisch ohne Benutzereingriff ausgelöst.

Sie können auch spezifische technische Workflows erstellen, um unnötige Daten zu bereinigen, die Speicherplatz belegen. Näheres dazu finden Sie in diesem Abschnitt.

Handhaben von ausgesetzten Workflows handling-of-paused-workflows

Wenn ein Workflow angehalten wird, werden dessen Arbeitstabellen standardmäßig nie bereinigt. Ab Build 8880 werden Workflows, die zu lange in einem angehaltenen Zustand waren, automatisch angehalten und ihre 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.

Workflow-Verantwortliche werden benachrichtigt. Die Person, die den Workflow erstellt und zuletzt geändert hat, wird ebenfalls benachrichtigt. Administratoren erhalten die Benachrichtigungen nicht.

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:

  1. Klicken Sie mit der rechten Maustaste auf den Ordner, in dem Sie die Ansicht hinzufügen möchten.
  2. Wählen Sie unter Ordner hinzufügen / Administration die Ansicht aus, die Sie hinzufügen möchten.
  3. 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:

  1. Rufen Sie einen Ordner vom Typ „Workflow“ auf und wählen Sie dann das Menü Filter / Erweiterter Filter.
  2. Konfigurieren Sie den Filter so, dass das Feld @status des Workflows dem Status Ihrer Wahl entspricht.
  3. Speichern und benennen Sie den Filter. Er ist dann direkt in der Filterliste verfügbar.

Weitere Informationen finden Sie in den folgenden Abschnitten:

recommendation-more-help
campaign-help-automation