Erweiterte Optionen - Tracing

In den erweiterten Agenten-Optionen können Sie die Einstellungen für das Tracing vornehmen, die Auslastung unter den Agenten aufteilen, die Anzahl der in der Automation Engine-Datenbank speicherbaren Report-Blöcke begrenzen sowie das Intervall für die regelmäßige Automation Engine-Prüfung festlegen.

Diese Seite beinhaltet Folgendes:

Welche Optionen im Abschnitt Trace Flags zur Verfügung stehen, hängt vom Agententyp ab. So verfügen Windows-Agenten beispielsweise über einen zusätzlichen Abschnitt (Zusätzliche Trace-Optionen), den andere Agenten nicht haben.

Trace-Optionen setzen

Alle Agenten können Trace-Dateien schreiben. Trace-Dateien erstellen, ebenso wie Log-Dateien, eine Aufzeichnung der Aktivitäten einer Komponente. Während Logdateien wichtige Ereignisse und Meldungen aufzeichnen, protokollieren Trace-Dateien jedoch den gesamten Programm- und Datenablauf. Diese detaillierten Informationen können für die Diagnose schwieriger Fehler oder kritischer Performanceengpässe nützlich sein.

Obwohl das Tracing viele Vorteile bietet, generiert es doch innerhalb von kurzer Zeit große Datenmengen, die sich negativ auf die Systemleistung auswirken können. Daher ist das Tracing in der Regel deaktiviert. Wenn jedoch eine komplexe Fehlersituation auftritt, die eventuell im Zusammenhang mit einem Ihrer Agenten steht, kann der CA Automic Support Sie darum bitten, das Tracing für den Agenten vorübergehend zu aktivieren.

Wichtig! Aktivieren Sie das Tracing nur, wenn das Support-Team Sie ausdrücklich darum bittet, da es die Systemleistung erheblich beeinträchtigen kann. Der Ihnen zugeteilte Support-Mitarbeiter weiß, welche Werte eingestellt werden müssen, um die erforderlichen Daten mit einem Minimum an Systemauswirkungen zu sammeln.

Abschnitt "Trace Flags" - Was wird beim Tracing erfasst?

Im Abschnitt Trace Flags können Sie das Tracelevel für eine Reihe von Agenten-Aktivitäten einstellen (TCP/IP, FileTransfers, Ereignisse usw.); welche Optionen verfügbar sind, hängt vom Agententyp ab. Im Allgemeinen sind die Tracewerte 0-9 und geben an, wie detailliert die Erfassung ist. Bei einigen Prozessen können die Werte jedoch abweichen. Tracing ist deaktiviert, wenn der Trace-Wert 0 (null) ist.

Rapid Automation (RA)-Agenten haben eine zusätzliche Trace-Option "RA".  Beim Tracing von RA-Agenten wird in der Regel der höchste Wert (99) angegeben. Erkundigen Sie sich jedoch auch hier beim Support-Team nach den empfohlenen Werten.  Bitte beachten Sie: Obwohl einige RA-Agenten, wie zum Beispiel RA Web Service REST Agent und RA Web Service SOAP Agent, es ermöglichen, in deren UCXJCITX.INI-Datei zusätzliche Bibliothek-Traces von Drittanbietern zu setzen, können Sie Drittanbieter-Tracing nicht über Fernzugriff aktivieren. Weitere Informationen finden Sie unter Agent RA Core.

Zusätzliche Trace-Optionen - So werden Tracedaten erfasst

Es ist schwierig, die Ursachen von Fehlern zu finden, die nur gelegentlich auftreten oder schwierig nachzuverfolgen sind. Wenn Sie in der Hoffnung, den Fehler zu finden, alles aufzeichnen, können die Tracedateien sehr schnell schwierig zu lesen oder zu groß für den verfügbaren Speicherplatz werden. Mit einer Kombination aus den folgenden Trace-Optionen können Sie zielgerichteter suchen und gleichzeitig die Festplattenkapazität besser verwalten.

  • Memory Trace

    Wenn ein Agent das Tracing im Speicher zulässt, können Sie diese Option aktivieren. Sie wird zusammen mit dem Trace Search Key verwendet. Die Trace-Meldungen werden in einem Puffer gespeichert, bis der gesuchte String gefunden wird. Das Tracing wird daraufhin gestoppt und die Meldungen in einer Trace-Datei auf der Festplatte gespeichert. Ohne diese Option werden Trace-Dateien in Form von einer oder mehreren Dateien direkt auf die Festplatte geschrieben, abhängig von den Einstellungen in Max. Einstellung der Trace-Größe.

  • Größe des Pufferspeichers

    Die maximale Trace-Größe beeinflusst die Größe der Trace-Dateien, die auf die Festplatte des Agenten-Host geschrieben werden. Die Funktionsweise hängt davon ab, ob die Option Trace Memory aktiviert ist:

    • Trace Memory ist aktiviert

      In diesem Fall reserviert die Trace-Komponente den angegebenen Festplattenplatz für den Zeitpunkt, zu dem die Trace-Dateien geschrieben werden. Wenn die Trace-Datei die Größe des hier reservierten Speichers übersteigt, schneidet die Trace-Komponente die ältesten Meldungen in der Trace-Datei fortlaufend ab, um Platz für die neuesten Meldungen zu schaffen.

    • Trace Memory ist deaktiviert oder nicht verfügbar

      Wenn eine Trace-Datei die definierte Begrenzung erreicht hat, beendet die Tracing-Komponente zu diesem Zeitpunkt das Schreiben der Meldung oder des Kommandos. Wenn die Größe der aktuellen Trace-Datei diese Beschränkung überschreitet, wird die Datei geschlossen und eine neue Trace-Datei geöffnet.

    In jedem Fall ist die tatsächliche Größe der Trace-Datei tendenziell größer, als die definierte maximale Größe, da die Trace-Komponente das Schreiben der Meldung oder des Codes abbricht, wenn die Größenbegrenzung erreicht ist. Einige Script-Anweisungen können außergewöhnlich lang sein. Dementsprechend wird auch die Dateigröße den festgelegten Grenzwert erheblich überschreiten.

    Wichtig zu verstehen ist, dass Max. Trace-Größe den Zweck hat, den im Arbeitsspeicher verwendeten Platz zu begrenzen. Die Dateidarstellung, die dann auf der Festplatte gespeichert wird, kann erheblich größer sein. So wird zum Beispiel die Datei beim Memory-Tracing erheblich größer sein, weil die Trace-Daten im Binärformat zunächst in den Speicherpuffer, dann jedoch in hexadezimaler Form auf die Festplatte geschrieben werden, was die Dateigröße erheblich steigert.

    Wenn Sie die Max. Trace-Größe auf 0 (null) ohne Memory-Tracing setzen, bedeutet dies, dass die Größe der Trace-Dateien unbegrenzt ist. Mit Memory-Tracing kann die Trace-Größe jedoch nicht unter dem Standardwert von 32 MB liegen. Wenn Sie hier niedrigere Werte eingeben, wird das System diese automatisch als 32 MB behandeln.

    Hinweis: Wenn ein Agent abstürzt, endet auch das Tracing - unabhängig von den Trace-Einstellungen. Der letzte Datensatz wird dann nicht mehr geschrieben. Wenn der Agent wieder anläuft, werden alle Trace-Optionen auf die Standardwerte zurückgesetzt, die in der INI-Datei des Agenten definiert sind. 

  • Trace Search Key

    Sie können einen String eingeben, zum Beispiel eine spezifische Fehlermeldung, die das Ende des Tracings kennzeichnet. Wenn die Trace-Komponente diesen String erkennt, schreibt sie die aktuelle Meldung zu Ende, stellt das Tracing ein und setzt alle Trace-Optionen auf "0" (null) zurück. Dadurch wird es Ihnen ermöglicht, den Problembereich einzugrenzen und den Speicherplatz zu verwalten, indem exzessives Tracing vermieden wird.

    Hinweis: Platzhalter werden nicht automatisch hinzugefügt. Sie müssen sie an den gewünschten Positionen manuell hinzufügen. Beispiel: Um die Trace zu schreiben, wenn der spezifische Agent WIN01 erwähnt wird, ist der korrekte String für die Suche *WIN01*.

Starten des Agenten-Tracings

Um das Tracing zu starten, ist es erforderlich, Trace-Optionen festzulegen, die genau angeben, welche Daten erfasst werden sollen. Trace-Optionen können nur für aktive (laufende) Agenten eingestellt werden.

  1. Wechseln Sie in die Administration-Perspektive, wenn Sie nicht bereits dort sind.
  2. Erweitern Sie das Menü Agenten und Gruppen, und klicken Sie auf Agenten.
  3. Klicken Sie mit der rechten Maustaste auf den Agenten, und wählen Sie Erweiterte Optionen aus.

Stoppen des Agenten-Tracings

Beim Einstellen von Trace-Optionen für einen Agenten geben Sie immer einen Trace Search Key an - einen String, der das Ende des Tracings signalisiert und es automatisch stoppt.

Das Tracing kann auf folgende Weise gestoppt werden:

  • Sie definieren einen Text-String in den Suchoptionen (Trace Search Key), wie zum Beispiel eine bestimmte Fehlermeldung, die das Ende des Tracings signalisiert. 
  • Der Agent ist auf einen kritischen Fehler getroffen und musste stoppen. Wenn der Agent wieder anläuft, werden alle Trace-Optionen auf die Standardwerte zurückgesetzt, die in der INI-Datei des Agenten definiert sind.
  • Sie deaktivieren das Tracing durch manuelle Änderung der Trace-Optionen, die einen Stopp zur Folge haben:
    1. Öffnen Sie die Liste Agenten.
    2. Klicken Sie mit der rechten Maustaste auf den Agenten, um Erweiterte Optionen auszuwählen.
    3. Setzen Sie alle Optionen im oberen Teil des Dialogfensters auf 0 (null) und klicken Sie dann auf die Schaltfläche Übernehmen.

Siehe auch: