Beispiel-Runbook: Überwachen eines Ordners mit einem Runbook

Wichtig

Diese Version von Orchestrator hat das Ende des Support erreicht. Es wird empfohlen, ein Upgrade auf Orchestrator 2019 zu durchführen.

In diesem Beispiel wird gezeigt, wie Sie ein einfaches Runbook erstellen, das einen Ordner auf neue Textdateien überwacht. Wenn eine Datei gelöscht wird, wird vom Runbook eine Ereignisprotokollmeldung gesendet und dann ein anderes Runbook gestartet.

Monitor Folder

Erstellen und Testen eines Monitor-Runbooks

Die Vorgehensweise zum Erstellen, Konfigurieren und Testen eines Beispielrunbooks zum Überwachen eines Ordners wird im Folgenden beschrieben.

So erstellen Sie den Workflow

  1. Klicken Sie im Bereich Verbindungen von Runbook Designer mit der rechten Maustaste auf den Ordner Runbooks , wählen Sie Neuaus, und klicken Sie dann auf Runbook.

  2. Klicken Sie mit der rechten Maustaste auf die Registerkarte Neues Runbook , und wählen Sie Umbenennenaus.

  3. Klicken Sie im Dialogfeld Auschecken bestätigen auf Ja.

  4. Geben Sie einen Namen für das Runbook ein, z. B. Monitor-Runbook, und drücken Sie die EINGABETASTE.

  5. Klicken Sie im Bereich Aktivitäten auf Dateiverwaltung , um die Kategorie zu erweitern, und ziehen Sie dann die Aktivität Ordner überwachen in den Designbereich von Runbook Designer .

  6. Klicken Sie im Bereich Aktivitäten auf Benachrichtigung , um die Kategorie zu erweitern, und ziehen Sie dann die Aktivität Ereignisprotokollmeldung senden in den Designbereich von Runbook Designer , rechts von der Aktivität Ordner überwachen .

  7. Bewegen Sie im Designbereich von Runbook Designer den Cursor über die rechte Seite der Aktivität Ordner überwachen , um den Pfeil für den intelligenten Link anzuzeigen.

  8. Klicken Sie auf den Pfeil für den intelligenten Link, und ziehen Sie dann auf die Aktivität Ereignisprotokollmeldung senden .

  9. Klicken Sie im Bereich Aktivitäten auf Runbooksteuerung , um die Kategorie zu erweitern, und ziehen Sie dann die Aktivität Runbook aufrufen in den Designbereich von Runbook Designer , rechts von der Aktivität Ereignisprotokollmeldung senden .

  10. Bewegen Sie im Designbereich von Runbook Designer den Cursor über die rechte Seite der Aktivität Ereignisprotokollmeldung senden , um den Pfeil für den intelligenten Link anzuzeigen.

  11. Klicken Sie auf den Pfeil für den intelligenten Link, und ziehen Sie dann auf die Aktivität Runbook aufrufen .

So konfigurieren Sie den Workflow

  1. Doppelklicken Sie im Designbereich von Runbook Designer auf die Aktivität Ordner überwachen .

  2. Klicken Sie im Dialogfeld Eigenschaften 'Ordner überwachen' auf die Registerkarte Allgemein .

  3. Geben Sie der Aktivität im Feld Name einen aussagekräftigen Namen, z. B. Monitor C:\Monitor-Ordner.

  4. Klicken Sie auf die Registerkarte Details.

  5. Geben Sie auf der Registerkarte Details im Feld Pfad den Pfad des überwachenden Ordners ein, z. B. C:\Monitor.

  6. Klicken Sie unter der Liste Dateifilter auf Hinzufügen.

  7. Legen Sie Dialogfeld Filtereinstellungen Folgendes fest:

    1. Wählen Sie im Listenfeld Name den Eintrag Dateinameaus.

    2. Wählen Sie im Listenfeld Beziehung die Option Entspricht dem Musteraus.

    3. Geben Sie im Feld Wert *.txt.

      Durch diese Einstellung wird der Monitor angewiesen, nach Dateien mit der Erweiterung txt zu suchen. In diesem Feld kann Syntax für reguläre Ausdrücke verwendet werden.

  8. Klicken Sie auf OK.

  9. Wählen Sie die Registerkarte Trigger aus.

  10. Wählen Sie die Option Die Anzahl der Dateien beträgt aus, legen Sie den Wert in der Liste auf größer alsfest, und geben Sie dann in das Eingabefeld 0 ein.

  11. Klicken Sie auf Fertig stellen.

  12. Doppelklicken Sie im Designbereich von Runbook Designer auf die Aktivität Ereignisprotokollmeldung senden.

  13. Legen Sie im Dialogfeld Eigenschaften 'Ereignisprotokollmeldung senden' auf der Registerkarte Details im Abschnitt Eigenschaften Folgendes fest:

    1. Geben Sie im Feld Computer den Namen des Computers ein, an den die Ereignismeldungen gesendet werden sollen.

      Dies ist normalerweise der Computer, auf dem Runbook Designer ausgeführt wird.

    2. Geben Sie im Feld Nachricht die im Ereignisprotokoll anzuzeigende Meldung ein, z. B. Datei erkannt.

    3. Lassen Sie die Einstellung für Schweregrad unverändert auf Informationen.

  14. Klicken Sie auf Fertig stellen.

    Hinweis

    In diesem Beispiel ist die Aktivität Runbook aufrufen nicht konfiguriert.

So ändern Sie Runbookeinstellungen

  1. Klicken Sie oberhalb des Designbereichs von Runbook Designer mit der rechten Maustaste auf die Registerkarte Runbook überwachen , und wählen Sie Eigenschaftenaus.

  2. Klicken Sie im Dialogfeld Eigenschaft 'Runbook überwachen' auf die Registerkarte Protokollierung , und wählen Sie dann sowohl Aktivitätsspezifische veröffentlichte Daten speichern als auch Gemeinsame veröffentlichte Daten speichernaus.

  3. Klicken Sie auf Fertig stellen.

  4. Klicken Sie mit der rechten Maustaste auf die Registerkarte Runbook überwachen , und wählen Sie Eincheckenaus.

Testen des Runbooks

In Runbook Tester können Sie Runbooks in einer simulierten Laufzeit- und Debugumgebung testen. Sie können ein gesamtes Runbook ausführen, die Aktivitäten schrittweise durchlaufen oder Haltepunkte zum Anhalten der Simulation an einer von Ihnen ausgewählten Aktivität hinzufügen.

Gehen Sie folgendermaßen vor, um Ihr Runbook in Runbook Testerzu testen.

So bereiten Sie Ihren Computer vor

  1. Klicken Sie mit der rechten Maustaste auf Start , und wählen Sie Windows-Explorer öffnenaus.

  2. Erstellen Sie auf Ihrem Computer einen Ordner C:\Monitor .

  3. Erstellen Sie auf Ihrem Computer einen Ordner C:\Source .

  4. Erstellen Sie im Ordner C:\Source eine Datei mit der Erweiterung txt , z. B. text.txt.

So testen Sie das Runbook

  1. Klicken Sie im Designbereich von Runbook Designer auf die Registerkarte Runbook überwachen .

  2. Klicken Sie auf der Symbolleiste über dem Designbereich von Runbook Designer auf Runbook Tester.

  3. Klicken Sie im Dialogfeld Auschecken bestätigen auf Ja.

  4. Klicken Sie auf der Symbolleiste in Runbook Testerauf Prozedurschritt , um die schrittweise Ausführung des Runbooks zu starten.

    Tipp

    Zur Vergrößerung des Bereichs Protokoll entfernen Sie den Bereich Resourcenbrowser , in dem Sie im Menü die Option Ansicht auswählen und dann die Option Ressourcenbrowser deaktivieren.

  5. Gehen Sie in Windows-Explorer zum Ordner C:\Source .

  6. Kopieren Sie test.txt nach C:\Monitor.

  7. Schließen Sie Windows-Explorer.

  8. Klicken Sie auf der Symbolleiste von Runbook Tester auf Weiter.

    Nach kurzer Zeit werden die Einträge im Bereich Protokoll aktualisiert, und es wird ein Ereignis für die Aktivität Ordner überwachen angezeigt.

  9. Klicken Sie im Bereich Protokoll auf den Link Details anzeigen , um den Inhalt des Datenbusses für dieses Runbook anzuzeigen.

  10. Führen Sie einen Bildlauf durch die Liste der Eigenschaften aus. Sie werden bemerken, dass der Aktivitätsstatus success ist, d. h., die Änderung im Ordner wurde von der Aktivität Ordner überwachen erkannt.

  11. Klicken Sie auf der Symbolleiste von Runbook Tester auf Weiter.

    Der Bereich Protokoll wird aktualisiert und ein Ereignis für die Aktivität Ereignisprotokollmeldung senden angezeigt.

  12. Klicken Sie auf den Link Details anzeigen . Sie werden sehen, dass der Aktivitätsstatus success ist, d. h., die Änderung im Ordner wurde von der Aktivität Ereignisprotokollmeldung senden erkannt.

  13. Schließen Sie Runbook Tester.

  14. Klicken Sie auf der Symbolleiste von Runbook Designer auf Einchecken.

Nächste Schritte

Lesen Sie Entwerfen und Erstellen von Runbooks, um mehr über das Erstellen von Runbooks zu erfahren und best practices guidance for designing runbooks (Bewährte Methoden für das Entwerfen von Runbooks) zu erhalten. Weitere Informationen zu den Optionen zum Steuern der Runbookausführung finden Sie unter Steuern von Runbookaktivitäten.