Unix-Suchtext

• Aufgabentyp: ssh_searchtext

Beschreibung

Die Aufgabe Unix Search Text ermöglicht es, einen Textstring oder ein Textmuster innerhalb einer Datei zu suchen, sowohl auf einem Remote-Server (über SSH) als auch auf der lokalen Maschine (Modus Standard).

Sie kann verwendet werden, um Protokolldateien zu analysieren, Fehlermeldungen zu finden oder die Anwesenheit spezifischer Informationen in Konfigurations- oder Textdateien zu überprüfen.

Konfiguration

Die Konfiguration der Aufgabe definiert die Details der Verbindung (falls erforderlich), die zu analysierende Datei und den zu suchenden Text. Die Konfigurationsfelder der Aufgabe können manuell oder über Workflow-Parameter und -Variablen. ausgefüllt werden.

Verbindung zum Server

• Verbindungsmodus: definiert die Quelle der für die Verbindung verwendeten Anmeldeinformationen. Es können drei Betriebsmodi angenommen werden:
• Standard: Die Suche wird auf der lokalen Maschine durchgeführt, ohne SSH-Verbindung.
• Manuell: Ermöglicht die manuelle Eingabe der SSH-Verbindungsparameter.
• Umgebung: Verwendet eine vordefinierte Verbindungsumgebung. In diesem Modus wird ein Menü angezeigt, das die verfügbaren Verbindungen basierend auf der dem Workflow zugeordneten Rolle auflistet.
• IP-Adresse: IP-Adresse des Remote-Servers.
• Hostname: Hostname des Remote-Servers.
• Benutzer: Benutzername, der zur Herstellung der SSH-Verbindung verwendet wird.
• Passwort: Passwort, das mit dem Verbindungskonto verknüpft ist.
• Port: Port, der für die SSH-Verbindung verwendet wird (der Standardwert ist 22).

Befehl als anderer Benutzer ausführen

Durch Aktivieren dieses Kontrollkästchens kann die Suche mit einem Benutzer durchgeführt werden, der nicht für die SSH-Verbindung verwendet wird.

• Benutzer: Name des Benutzers, unter dem der Befehl ausgeführt wird.
• Passwort: Passwort des Benutzers, der für die Ausführung des Befehls verwendet wird.

Suchdetails

• Dateipfad: Der vollständige Pfad zur Datei auf dem Remote-Server, in der nach dem Text gesucht wird.
• Muster: Der zu suchende Text oder Ausdruck. Neben dem Textfeld ermöglicht ein Menü die Angabe des Suchmodus:
• String: Die Suche behandelt das Muster als einfachen, wörtlichen Textstring.
• RegExp: Die Suche interpretiert das Muster als regulären Ausdruck, was komplexere und flexiblere Suchen ermöglicht.
• Zeilenlimit: Durch Aktivieren dieses Kontrollkästchens kann die maximale Anzahl von Zeilen angegeben, die die Aufgabe zurückgeben soll, die mit dem Muster übereinstimmen. Wenn es nicht aktiviert ist, werden alle gefundenen Zeilen zurückgegeben.

Ausgabe-Parameter

Nach Abschluss der Suche stellt die Aufgabe die folgenden Ausgabe-Parameter bereit und liefert nicht nur die gefundenen Zeilen, sondern auch quantitative Daten zur Suche:

• result: Enthält einen Textnachricht, die das Ergebnis der Operation beschreibt.
• resultJson: Stellt das Ergebnis der Ausführung der Aufgabe im JSON-Format dar und enthält allgemeine Informationen, Konfigurationen und Details zur Ausführung.
• occurrences: Ein numerischer Zähler, der die Gesamtzahl der Fundstellen des Musters angibt. Dies ist besonders nützlich, da, falls eine einzelne Zeile das Muster mehrmals enthält, occurrences dies alle zählt, während result die Zeile nur einmal zurückgibt.
• exitStatus: Gibt den Exit-Code des auf dem Server ausgeführten grep-Befehls zurück.
• 0: Zeigt an, dass mindestens eine Übereinstimmung gefunden wurde.
• 1: Zeigt an, dass keine Übereinstimmung gefunden wurde (dies ist für grep kein Ausführungsfehler).
• Werte größer als 1: Zeigen einen Syntaxfehler oder ein Problem beim Dateizugriff an.

Beispiel-Parameter resultJson

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Anmerkung

• Die Aufgabe führt einen Suchbefehl auf der konfigurierten Datei aus, lokal oder über eine SSH-Verbindung.
• Wenn eine Remote-Verbindung mit Authentifizierung über SSH-Schlüssel verwendet wird, muss der öffentliche Schlüssel auf dem Server registriert sein.
• Wenn die Option „Befehl als anderer Benutzer ausführen“ aktiviert ist, wird der Befehl mit einem Benutzer ausgeführt, der nicht der des Hauptverbindungsbenutzers ist.
• Im Modus Standard wird die Suche auf der lokalen Maschine ausgeführt und es ist keine SSH-Verbindung erforderlich.