Datenquellen

Datenquellen können konfiguriert werden, um Datenbanktabellen oder -ansichten in den SKOOR-Dashboards verfügbar zu machen. MySQL- und PostgreSQL-Datenbanken werden unterstützt. Zusätzlich können Skripte als Datenquellen definiert werden, um Daten aus fast jeder anderen Quelle anzufordern.

Dieser Abschnitt ist nur für Benutzer mit Administratorrechten verfügbar

Datenbank-Datenquellen

Klicken Sie auf das +-Zeichen und fügen Sie Verbindungsparameter hinzu:

Klicken Sie auf die Schaltfläche Hinzufügen unter den Verbindungsparametern, um die Datenbank zu verbinden. Wenn die Datenbank erreichbar ist, erscheint ein grünes Statussymbol zusammen mit einigen Registerkarten für weitere Aktionen auf dieser Datenbank:

Auf der Registerkarte Berechtigungen können Ausdrücke pro Tabelle definiert werden, um Inhalte zu filtern und sie bestimmten SKOOR-Benutzern oder -Gruppen zuzuordnen. Bei der Anmeldung bei einem Dashboard können Benutzer nur Inhalte sehen, für die sie berechtigt sind.

Als Ausdruck kann man entweder einfache Stringwerte oder alle Operatoren aus dem Datenquellen-Abfrageeditor verwenden.

Beispielausdrücke:

Ausdruck

Beschreibung

1234

Stimmt mit allen Zeilen überein, deren Spaltenwert gleich 1234 ist.

NICHT NULL())

Stimmt mit allen Zeilen überein, deren Spaltenwert nicht NULL ist.

GE(0)

Stimmt mit allen Zeilen überein, deren Spaltenwert größer gleich Null ist.

foo%

Stimmt mit allen Zeilen überein, deren Spaltenwert mit „foo“ beginnt

Verwenden Sie die Registerkarte Datenvorschau , um eine Vorschau von Tabellen und Ansichten der aktuellen Datenquelle anzuzeigen. Klicken Sie auf der rechten Seite auf Filter umschalten , um nach bestimmten Datensätzen in der ausgewählten Tabelle oder Ansicht zu suchen.

Skriptdatenquellen

Wenn der Datenquellentyp in SCRIPT geändert wird, ändern sich die Konfigurationsparameter. Jetzt kann ein Skript zusammen mit allen erforderlichen Parametern konfiguriert werden, um eine Ausgabe zu generieren, die für SKOOR-Dashboards geeignet ist.

Die Skriptausgabe muss in JSON formatiert sein

Parameter

Beschreibung

Name

Name der Datenquelle. Dieser Name ist in den Widget-Einstellungen verfügbar, wenn der Suchtyp auf dataSource eingestellt ist. Die Tabelle wird immer auf STDOUT gesetzt:

Ausführbare Datei abrufen

Vollqualifizierter Pfad zu dem Programm oder Skript, das die Daten generiert. Dieses Programm muss auf dem System verfügbar sein, auf dem der SKOOR-Webdienst installiert ist

Argumente abrufen

Befehlszeilenargumente des Programms, ein Argument pro Zeile. Alle im Ziel-Widget festgelegten Parameter sowie direkt in diesem Feld festgelegte Argumente können an das Skript übergeben werden.

Beispiel: Die URL- Parameteranzeige ist als Suchabfrage in einem Tabellen-Widget konfiguriert:

Derselbe Parameter kann nun an das Datenquellenskript übergeben werden sowie weitere Argumente, beispielsweise der Wert „123“:

Ergebniszeiger abrufen

Wenn nur eine Teilmenge des JSON-String-Ergebnisses des Programms in den Dashboards benötigt wird, muss ein JSON-Pointer gesetzt werden.

Die folgende Beispiel-JSON-Zeichenfolge wird von einem Programm generiert (zur Lesbarkeit formatiert):

{
  "host": "myhost",
  "filesystems": [
    {
      "size": "51G",
      "used": "22G",
      "available": "27G",
      "usedp": "46%",
      "mountpoint": "/"
    },
    {
      "size": "17G",
      "used": "45M",
      "available": "16G",
      "usedp": "1%",
      "mountpoint": "/home"
    }
  ]
}

Nur das Dateisystem-Array wird auf einem Dashboard angezeigt. Daher muss der JSON-Zeiger /filesystems als Abrufergebniszeiger festgelegt werden:

Wenn alle Objekte eines JSON-Strings angezeigt werden sollen, setzen Sie den Fetch-Ergebniszeiger auf „ / “.

Eindeutige ausführbare Datei

Wenn eine Skriptdatenquelle für ein Filtermatrix-Widget verwendet wird, wird ein JSON-Array mit eindeutigen Werten benötigt. Das hier konfigurierte Skript oder Programm muss ein solches Array zurückgeben

Eindeutige Argumente

Siehe Abrufargumente

Eindeutiger Ergebniszeiger

Siehe Ergebniszeiger abrufen

Säulen

Die JSON-Felder der Skriptausgabe müssen als Spalten konfiguriert werden, um als solche in den Dashboard-Widgets verfügbar zu sein