DocsDatenquellen
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 |