Agent Fetchfile

Funktion

Überträgt bis zu 4 Dateien oder Verzeichnisse vom Zielsystem auf den SKOOR Engine Collector (nur Windows)

Alarmierung

Transfer time, Transfer rate

Agent Fetchfile Details

Agent Fetchfile Parameter

Parameter

Beschreibung

Source filepath

Abzurufende Datei oder abzurufendes Verzeichnis einschließlich des absoluten Pfads. Dieser Pfad oder dieses Dateiziel muss im Tab Filetransfer Options der Konfiguration des Remote-WinAgent zugelassen sein.

Es kann auch ein Verzeichnisname angegeben werden. In diesem Fall wird der Verzeichnisinhalt automatisch in ein ZIP-Archiv komprimiert, und der Parameter Dest. filepath sollte als Name der resultierenden ZIP-Datei angegeben werden.

Platzhalter (Wildcards) sind nicht zulässig.

Dest. filepath

Zieldateiname (relativer Pfad). Die Datei wird unterhalb des Parse-Verzeichnisses des Kollektors erstellt, der im Bereich Job Execution des Jobs konfiguriert ist (das Standard-Parse-Verzeichnis ist /var/opt/run/eranger/collector/tmp). Um die Datei in ein Unterverzeichnis des Parse-Verzeichnisses abzurufen, muss das Unterverzeichnis zuerst manuell erstellt und mit Schreibrechten für den Benutzer eranger versehen werden.

Wenn ZIP, Extract content als Dateiübertragungsoption ausgewählt ist, geben Sie ein Zielverzeichnis an, in das der ZIP-Inhalt auf dem Kollektor entpackt werden soll.

Option

Fetch file normally: Überträgt die Datei direkt.

ZIP: fetch compressed, extract: Die Datei wird zunächst auf dem Remote-Rechner in ein ZIP-Archiv komprimiert, auf den Kollektor übertragen und anschließend in ihren Dest. filepath entpackt. Dies ist sinnvoll für große Logdateien, die im komprimierten Zustand eine deutlich geringere Dateigröße haben.

ZIP: Extract content: Wenn ein Verzeichnis oder eine ZIP-Datei ausgewählt ist, wird der Inhalt auf den Kollektor entpackt. Geben Sie in diesem Fall einen Verzeichnisnamen als Dest. filepath an.

Client version

Wenn dieses Kontrollkästchen aktiviert ist, zeigt der Bereich Values die Version des Remote-WinAgent in der Info message an.

Suppress Transfer time
Suppress Transfer rate

Standardmäßig werden die für die Übertragung der Datei oder des Archivs benötigte Zeit sowie die daraus resultierende durchschnittliche Übertragungsrate in der Datenbank aufgezeichnet.
Wenn diese Informationen nicht relevant sind, aktivieren Sie diese beiden Kontrollkästchen, um Datenbank-Speicherplatz zu sparen.

Suppress Error if file not found

Anstelle einer Fehlermeldung (Fehlercode 9, „File not found“) wird eine Infomeldung mit demselben Inhalt im Values-Bereich des Jobs angezeigt

Über die Dropdown-Liste Tags können vordefinierte Variablen in die oben genannten Felder eingefügt werden, z. B. $NAME$ für den Namen des Jobs.

Agent Fetchfile Werte und Alarm Limits

Wert / Alarm Limit

Beschreibung

Transfer time

Die Zeit (in ms), die für die Übertragung der Datei oder des Archivs benötigt wird. Dieser Wert bzw. dieses Alarm Limit ist nur verfügbar, wenn das entsprechende Kontrollkästchen Suppress nicht aktiviert wurde.

Transfer rate

Die durchschnittliche Übertragungsrate (in MB/s) der Dateiübertragung. Dieser Wert bzw. dieses Alarm Limit ist nur verfügbar, wenn das entsprechende Kontrollkästchen Suppress nicht aktiviert wurde.

Error code

Allgemeiner Job-Fehlercode (siehe Abschnitt Job-Fehlercodes)

Agent Fetchfile Beispiele

Beispiel 1 - Eine Logdatei abrufen

Der Dest. filepath verwendet die vordefinierte Variable $DEVICE_ADDRESS$, die zu der im Feld Address des übergeordneten Geräts des Jobs eingegebenen Adresse aufgelöst wird.

Ausgabe 1

Die obige Ausgabe zeigt die Übertragungsdetails sowie die Version des Remote-WinAgent. Das Ausführen des Agent Fetchfile-Jobs ruft die Datei auf den Kollektor ab, stellt sie aber noch nicht im Webinterface zur Verfügung. Um die abgerufene Datei einsehen zu können, klicken Sie auf die Schaltfläche Update file. Dadurch wird die Datei vom Kollektor in das Verzeichnis fetchfile des Webservers abgerufen. Die Datei kann anschließend im Browser angezeigt werden, indem Sie auf den Link Fetched file klicken.

Beispiel 2 - 2 Dateien abrufen

Ausgabe 2

Nachdem die Dateiübertragung abgeschlossen ist und beide Schaltflächen Update file angeklickt wurden, sieht der Bereich Values wie folgt aus: