Runbookprotokolle

Veröffentlicht: März 2016

Gilt für: System Center 2012 SP1 - Orchestrator, System Center 2012 - Orchestrator, System Center 2012 R2 Orchestrator

Bei jeder Ausführung eines Runbooks wird ein Protokoll erstellt. Mit Runbook Designer können Sie sowohl Echtzeitprotokolldaten als auch frühere Protokolle anzeigen.

Sie können das Echtzeitprotokoll eines Runbooks im Bereich Protokoll von Runbook Designer auf der Registerkarte Protokoll anzeigen. Das Protokoll enthält einen Eintrag für jede ausgeführte Instanz des Runbooks sowie den Startzeitpunkt. Wenn Sie diesen Eintrag erweitern, können Sie die momentan ausgeführte Aktivität anzeigen. Doppelklicken Sie auf die Aktivität, um die Details anzuzeigen. Wenn Sie bei der Konfiguration der Arbeitsmappenprotokollierung die veröffentlichten Daten eingeschlossen haben, sind diese Informationen Bestandteil der Aktivitätsdetails.

Sie können das Verlaufsprotokoll eines Runbooks im Bereich Protokoll von Runbook Designer auf der Registerkarte Protokollverlauf anzeigen. Dieses Protokoll enthält für jede abgeschlossene Instanz des Runbooks einen Eintrag mit Angabe des Startzeitpunkts, des Endzeitpunkts und des Abschlussstatus. Wenn Sie auf einen Eintrag doppelklicken, wird das Dialogfeld Runbookdetails geöffnet, das jede Aktivität im Runbook und deren Abschlussstatus enthält. Doppelklicken Sie auf eine Aktivität, um die Details anzuzeigen. Wenn Sie bei der Konfiguration der Arbeitsmappenprotokollierung die veröffentlichten Daten eingeschlossen haben, sind diese Informationen Bestandteil der Aktivitätsdetails.

Die veröffentlichten Daten der einzelnen Aktivitäten sind standardmäßig nicht in Runbookprotokollen enthalten. Eine Liste der für die einzelnen Standardaktivitäten verfügbaren veröffentlichten Datenelemente finden Sie unter Standardaktivitäten. Informationen zu Integrationspaketen finden Sie im Handbuch für das jeweilige Integrationspaket. Sie können die Protokollierungseigenschaften für ein bestimmtes Runbook ändern, um diese Informationen in die Protokolle einzuschließen. Sie können beide oder nur eine der folgenden Arten von veröffentlichten Daten einschließen:

• Aktivitätsspezifische veröffentlichte Daten sind veröffentlichte Daten für eine bestimmte Aktivität. In der Regel sollte diese Option nur für Debugzwecke aktiviert werden.

• Gemeinsame veröffentlichte Daten sind eine Reihe von Datenelementen, die alle Aktivitäten gemein haben. Dazu zählen:

  • Aktivitätsname

  • Aktivitätstyp

  • ID der Aktivität

  • Endzeitpunkt (Jahr, Monat, Tag, Wochentag, Stunde, Minute, Sekunde) der Aktivität

  • Aktivitätsdauer

  • Vorherige Aktivität

  • Name der vorherigen Aktivität

  • Veröffentlichte Uhrzeitdaten

Achtung
Standardmäßig sind die Protokollierungsoptionen deaktiviert. Beachten Sie, dass der Datenspeicher sich durch Hinzufügen dieser Elemente vergrößert.

Vom Runbook-Überwachungsverlauf werden die Änderungen an jeder Aktivität in einem Runbook erfasst. Dazu zählen der Benutzer, der die Änderung vorgenommen hat, das Datum und die Uhrzeit der Änderung, die geänderte Aktivität sowie der aktuelle und vorherige Wert jeder geänderten Eigenschaft. Der Überwachungsverlauf wird so lange geführt, wie das Runbook vorhanden ist. Er kann nicht gelöscht werden.

Sie können den Runbook-Überwachungsverlauf auf der Registerkarte Überwachungsverlauf von Runbook Designer anzeigen. Es werden die Einträge für das aktuell ausgewählte Runbook angezeigt. Doppelklicken Sie auf einen Eintrag, um das Dialogfeld Details zu öffnen. In diesem Dialogfeld können Sie eine Liste aller Aktivitäten anzeigen, die Teil der Änderung waren. Wählen Sie einen der Einträge aus, um neben den alten und neuen Werten aller geänderten Eigenschaften auch die durchgeführte Aktivität anzuzeigen.

Runbook Designerverfügt über eine Funktion Protokoll löschen.Orchestrator-Protokolldaten können bei Bedarf oder auf Basis eines Zeitplans gelöscht werden. Es ist sinnvoll, diese Löschvorgänge zur Datenbankwartung in regelmäßigen Abständen außerhalb der Spitzenzeiten einzuplanen.

Hinweis
Wenn Protokolle gelöscht werden, werden die Daten unwiederbringlich aus der Orchestration-Datenbank gelöscht.

Wenn Sie die Anzahl der Protokolleinträge nicht beschränken, kann dies zu übermäßigem Speicherbedarf für die Orchestration-Datenbank führen. Damit Integrität und Leistungsfähigkeit der Datenbank aufrechterhalten werden, sollten Sie alte Protokolleinträge regelmäßig löschen. Sie können diese entweder automatisch per Zeitplan oder manuell löschen.

Automatisches Löschen von Runbookprotokollen

Sie können festlegen, dass die Runbookprotokolle in regelmäßigen Abständen gelöscht werden, indem Sie die Häufigkeit des Löschvorgangs und die Anzahl der beizubehaltenden Einträge konfigurieren. Standardmäßig werden Runbookprotokolle unter Verwendung der folgenden Einstellungen automatisch gelöscht.

Mit dem Standardauftrag zur Protokolllöschung werden in den einzelnen Protokollen alle Protokolleinträge mit Ausnahme der letzten 500 Einträge gelöscht. Wenn eine Orchestrator-Bereitstellung beispielsweise 20 Runbooks umfasst und pro Runbook die letzten 500 Protokolleinträge beibehalten werden, beträgt die maximale Gesamtanzahl der Protokolleinträge in der Datenbank für alle Runbooks 10.000.

Sie können diese Standardeinstellungen weiterverwenden oder sie mithilfe des folgenden Vorgangs in Runbook Designer ändern.

So löschen Sie Runbookprotokolle bei Bedarf oder legen die Löschhäufigkeit fest

1. Klicken Sie in Runbook Designer mit der rechten Maustaste auf Management Server, und wählen Sie Protokoll löschen aus.

   Wenn Sie alle Runbookprotokolle löschen möchten, klicken Sie auf Jetzt löschen.

   Wenn Sie ein bestimmtes Runbookprotokoll löschen möchten, klicken Sie auf die Registerkarte Protokollverlauf, um das gewünschte Runbook auszuwählen.

2. Stellen Sie sicher, dass die Option Löschen des Protokolls planen aktiviert ist.

3. Wählen Sie die Anzahl der Tage zwischen den Löschvorgängen und eine Uhrzeit für die Ausführung des Vorgangs aus.

4. Wenn Sie nicht alle Einträge löschen möchten, legen Sie die Optionen für das Löschen des Protokolls so fest, dass die Protokolleinträge angegeben werden, die Sie behalten möchten.

5. Klicken Sie auf Fertig stellen.

Manuelles Löschen der Runbookprotokolle

Überwachungsverlaufsprotokolle stellen einen Sonderfall dar, da diese Protokolle nicht mit der Funktion Protokolle löschen gelöscht werden können. Von der Funktion „Überwachungsverlauf“ werden alle Änderungen erfasst, die in Runbook Designer an einem Runbook vorgenommen wurden. Die Einträge können nicht gelöscht werden. Überwachungsverlaufsprotokolle können nur gemeinsam mit den zugehörigen Runbooks gelöscht werden. Das mit den Überwachungsverlaufsprotokollen für ein Runbook verbundene Datenvolumen ist jedoch allgemein gering. Selbst bei großen Bereitstellungen wird der erforderliche Speicherplatz nicht die Mindestsystemanforderungen überschreiten.

Runbookprotokolle können wie nachfolgend gezeigt auf zwei Arten gelöscht werden. Für beide Verfahren wird Runbook Designer verwendet.

So löschen Sie die Runbookprotokolle für alle Runbooks manuell

1. Klicken Sie mit der rechten Maustaste auf Management-Server, und wählen Sie Protokoll löschen aus.

2. Legen Sie die Optionen für das Löschen des Protokolls fest, um die Protokolleinträge anzugeben, die Sie behalten möchten.

3. Klicken Sie auf Jetzt löschen.

So löschen Sie die Runbookprotokolleinträge für ein einzelnes Runbook manuell

1. Wählen Sie im Bereich Verbindungen den Ordner Runbooks aus.

2. Klicken Sie im Arbeitsbereich auf die Registerkarte des Runbooks.

3. Klicken Sie im Bereich Protokollverlauf auf die Registerkarte Protokollverlauf.

4. Klicken Sie auf das Symbol Papierkorb im oberen Fensterbereich.

5. Wenn die Abfrage erscheint, ob Sie die Protokolle wirklich löschen möchten, klicken Sie auf Ja.

So löschen Sie einen bestimmten Satz von Runbookprotokolleinträgen für ein einzelnes Runbook

1. Wählen Sie im Bereich Verbindungen den Ordner Runbooks aus.

2. Klicken Sie im Arbeitsbereich auf die Registerkarte des Runbooks.

3. Klicken Sie im Bereich Protokollverlauf auf die Registerkarte Protokollverlauf.

4. Wählen Sie einen einzelnen Protokolleintrag aus, oder wählen Sie mehrere Einträge mithilfe der Tastenkombination STRG+UMSCHALT aus.

5. Klicken Sie auf das rote Symbol Löschen im oberen Fensterbereich.

6. Wenn die Abfrage erscheint, ob Sie die ausgewählten Einträge wirklich löschen möchten, klicken Sie auf Ja.

Entfernen verwaister Protokolleinträge

Verwaiste Protokolleinträge können in der Orchestration-Datenbank verbleiben, wenn der Runbook Server Service während der Ausführung von Runbookinstanzen plötzlich beendet wurde. In diesem Fall wird der Status der Runbookinstanz nicht korrekt mit der Endzeit aktualisiert. Diese Einträge werden entfernt, wenn die Protokolleinträge mit einem der oben beschriebenen Verfahren gelöscht werden. Wenn Sie verwaiste Einträge vor dem Löschvorgang entfernen möchten, können Sie die gespeicherte Prozedur ClearOrphanedRunbookInstances ausführen.

Im Folgenden wird beschrieben, wie Sie diese gespeicherte Prozedur mithilfe von Microsoft SQL Server Management Studio ausführen. Dieses Tool ist auf dem Orchestration-Datenbankserver installiert. Sie können diesen Vorgang von einem beliebigen Computer ausführen, auf dem dieses Tool installiert ist und der Zugriff auf die Orchestration-Datenbank hat.

So entfernen Sie verwaiste Protokolleinträge

1. Klicken Sie auf dem Server mit der Orchestration-Datenbank auf Start, zeigen Sie auf Alle Programme, und klicken Sie dann auf Microsoft SQL Server 2008 und SQL Server Management Studio.

2. Wählen Sie im Dialogfeld Verbindung mit Server herstellen in der Liste Servername den Eintrag (lokal) aus, und klicken Sie dann auf Verbinden.

3. Erweitern Sie im Objekt-Explorer den Eintrag Datenbanken, und klicken Sie dann auf Orchestrator.

   Hinweis
   Wenn Sie einen anderen Namen für die Orchestrator-Datenbank verwenden, wählen Sie diesen Namen aus.

4. Erweitern Sie Programmierbarkeit, und klicken Sie dann auf Gespeicherte Prozeduren.

5. Klicken Sie mit der rechten Maustaste auf Microsoft.SystemCenter.Orchestrator.Runtime.Internal.ClearOrphanedRunbookInstances, und wählen Sie Gespeicherte Prozedur ausführen aus.

6. Klicken Sie im Dialogfeld Prozedur ausführen auf OK.

7. Klicken Sie auf der Symbolleiste auf Ausführen.

8. Schließen Sie SQL Server Management Studio, wenn unten im Protokollierungsbereich eine Meldung angezeigt wird, dass die Abfrage abgeschlossen wurde.

Orchestrator-Protokolle