SKOOR Dokumentation

Fetchfile

Funktion	Eine Datei über FTP, SFTP, SCP oder HTTP in den SKOOR Engine Collector holen
Alarmierung	Übertragungszeit, Übertragungsrate

Das Gerät, von dem dieser Auftrag ausgegeben wird, muss der entsprechende Web-, FTP- oder SSH-Server sein.

Details zum Abruf der Datei

Parameter zum Abrufen von Dateien

Parameter	Beschreibung
Protokoll	Wählen Sie das Übertragungsprotokoll (HTTP, FTP, SFTP, scp)
Port	Ändern Sie den Standardport des Remote-Dienstes
Benutzername/Passwort	Verwenden Sie diese Option, wenn der Server eine Authentifizierung verlangt. Es muss keine Public-Key-Authentifizierung zwischen dem Kollektor und dem Remote-Host eingerichtet werden.
Optionen	Geben Sie hier benutzerdefinierte Befehlszeilenparameter ein. HTTP und FTP akzeptieren Optionen des Dienstprogramms wget. SCP akzeptiert scp-Optionen (z. B. -o StrictHostKeyChecking=no).
Quellpfad	Sollte den relativen Pfad vom FTP/HTTP/ssh-Stammverzeichnis des Benutzers und den Dateinamen enthalten. Wenn nur der Pfadname verwendet wird, wird die Inhaltsliste des Verzeichnisses in den Ziel-Dateinamen kopiert. Mit scp ist es möglich, ein ganzes Verzeichnis zu übertragen. Geben Sie den Quellpfad mit einem Platzhalter „“ an, z. B.: /tmp/sap/, und der Zieldateiname sollte ein vorhandenes Verzeichnis sein, auf das der Benutzer eranger Schreibzugriff hat.
Ziel-Dateiname	Zielpfad der heruntergeladenen Datei. Die hier angegebene Datei wird im Standard-Fetch-Verzeichnis abgelegt, das in der Datei /etc/opt/eranger/eranger-kollektor.cfg angegeben ist (das Standard-Fetch-Verzeichnis ist /var/opt/run/eranger/kollektor/tmp).
Übertragungszeit unterdrücken Übertragungsrate unterdrücken	Wenn eines dieser Kontrollkästchen aktiviert ist, werden die Übertragungszeit und/oder die Übertragungsrate jeder Überprüfung nicht in der Datenbank gespeichert und ihre Werte sind im Wertebereich nicht mehr sichtbar. Ihre Werte stehen auch nicht mehr für die Verwendung in Alarm Limit-Spezifikationen zur Verfügung.

Werte und Alarm Limits aus Abrufdatei

Wert / Alarm Limit	Beschreibung
Übertragungszeit	Zeit für die Übertragung der Datei (außer wenn durch Aktivieren von „Übertragungszeit unterdrücken” deaktiviert)
Übertragungsrate	Übertragungsrate für die Dateiübertragung (außer wenn durch Aktivieren von „Übertragungsrate unterdrücken“ deaktiviert). Nur für größere Dateien genau.
Fehlercode	Allgemeiner Job-Fehlercode (siehe Abschnitt „Job-Fehlercodes“)

Beispiele für Fetchfile

Beispiel 1 – Abrufen einer Datei über HTTPS von einem Server mit der IP-Adresse 10.1.0.77 und dem Gerätenamen „internal“

Protokoll	HTTP
Port	443
Quellpfad	/files/scripts/readme.txt
Ziel-Dateiname	$DEVICE_NAME$_readme.txt

Ausgabe 1

Die Variable $DEVICE_NAME$ wird automatisch durch den tatsächlichen Gerätenamen ersetzt:

Klicken Sie auf die Schaltfläche „Datei aktualisieren“, um die heruntergeladene Datei anzuzeigen. Die Datei kann nun für die weitere Verarbeitung oder Analyse verwendet werden.

Beispiel 2 – Abrufen eines Verzeichnisses über scp

Dadurch werden alle Dateien aus dem Verzeichnis /root/logs/ in das Verzeichnis <IP>_logs im Standard-Parsing-Verzeichnis des für diesen Auftrag konfigurierten Kollektors kopiert. Das Passwort muss nicht eingegeben werden, wenn die Benutzerauthentifizierung bereits mit Public-Key-Dateien auf Betriebssystemebene erfolgt. In diesem Fall muss der Benutzer „eranger“ auf dem für diesen Auftrag konfigurierten Kollektor in der Lage sein, eine Verbindung zu root@10.1.0.77 herzustellen, ohne ein Passwort einzugeben.

Protokoll	scp
Port	22
Benutzername	root
Passwort	<Passwort>
Quellpfad	/root/logs/*
Ziel-Dateiname	$DEVICE_ADDRESS$_logs (in diesem Fall ist dies das Zielverzeichnis auf dem Kollektor, das vorhanden und für den Benutzer „eranger” beschreibbar sein muss)

Ausgabe 2

Die Variable $DEVICE_ADDRESS$ wird automatisch durch die tatsächliche IP-Adresse des Geräts ersetzt: