1. Verfügbare Tabellen
Im Livestatus stehen Ihnen die folgenden Tabellen zur Verfügung. Manche verfügen zusätzlich noch über die Spalten einer anderen Tabelle. Diese Spalten werden dann mit dem Tabellennamen als Präfix gekennzeichnet:
| Tabelle | Kommentar |
|---|---|
|
Enthält alle Informationen zu den konfigurierten Hosts. |
|
Enthält alle Informationen zu den konfigurierten Services und zusätzlich die Spalten aus |
|
Informationen zu den Host-Gruppen. |
|
Informationen zu den Service-Gruppen. |
|
Informationen zu den Kontaktgruppen. |
|
Wie |
|
Wie |
|
Wie |
|
Informationen zu den Kontakten. |
|
Alle konfigurierten Check-Commands, wie sie bei einem Service unter Service check command stehen. |
|
Alle Informationen zu konfigurierten Zeitperioden. |
|
Wie |
|
Enthält alle Informationen zu Kommentaren und zusätzlich die Spalten von |
|
Alle Informationen zu mitgeschriebenen Ereignissen. Diese sollten nach Klasse und Zeitpunkt/Zeitraum gefiltert werden. |
|
Informationen zu dem Status und der Performance des Cores. |
|
Alle verfügbaren Tabellen werden hier aufgelistet. Zusätzlich gibt es auch eine Beschreibung zu jeder Spalte einer Tabelle. |
|
Mit dieser Tabelle kann die Status-Vergangenheit eines Hosts/Services umfangreich durchsucht werden. |
|
Listet alle Events der Event Console. Zusätzlich verfügt diese Tabelle über alle Spalten von |
|
Wie |
|
Listet Statistiken zu der Performance der Event Console. |
|
Statistiken darüber, wie oft ein Regelabgleich mit einem ankommenden Event erfolgreich war. |
Wenn Sie wissen möchten, über welche Spalten (Columns) eine Tabelle verfügt, können Sie diese einfach mit dem folgenden Befehl abrufen:
OMD[mysite]:~$ lq "GET columns\nColumns: name\nFilter: table = columns"
description
name
table
typeÜber den Filter lassen sich auch andere Tabellen auswählen. Alle verfügbaren Spalten für die Suche nach Spalten und Tabellen sehen Sie in der Ausgabe des Beispiels.
2. Verfügbare Header
| Header | Argument | Beschreibung |
|---|---|---|
|
Spaltenname |
Schränkt die Ausgabe auf die angegebenen Spalten ein. |
|
Spaltenname, Operator und Objektname |
Schränkt die Ausgabe auf das definierte Objekt ein. Siehe auch Livestatus-Filter. |
|
Ganzzahl |
Verbindet die letzten n Filter mit einem logischen ODER. |
|
Ganzzahl |
Verbindet die letzten n Filter mit einem logischen UND. |
|
Ganzzahl |
Kehrt die letzten n Filter um. |
|
ASCII-Werte |
Definiert die Zeichen, welche die Trennung eines Elements von einem anderen anzeigt. |
|
Name |
Definiert eine komplett andere Ausgabe der Daten. Möglich sind |
|
Operator und Spaltenname |
Bildet Statistiken zu bestimmten Spalten. |
|
Ganzzahl |
Bietet die Funktionen des |
|
Ganzzahl |
Bietet die Funktionen des |
|
Ganzzahl |
Bietet die Funktionen des |
|
Ganzzahl |
Beschränkt die Ausgabe auf n Zeilen. |
|
Ganzzahl |
Schränkt die Verarbeitung der Abfrage auf n Sekunden ein. |
|
- |
Gibt in der ersten Zeile die Namen der verwendeten Spalten aus. Ist zusätzlich der Header |
|
Benutzername |
Schränkt die Ausgabe auf die Zeilen ein, die der angegebene Benutzer sehen darf. |
|
Objektname |
Das Objekt, bei dem ein bestimmtes Verhalten erwartet wird. Das ist der Name des Objekts bzw. bei der Tabelle |
|
Filterbedingung |
Die Bedingung, die für das definierte Objekt erfüllt sein muss. Es können beliebig viele Bedingungen definiert werden; diese werden mit einem logischen UND miteinander verknüpft. |
|
Ganzzahl |
Bietet die Funktionen des |
|
Ganzzahl |
Bietet die Funktionen des |
|
Ganzzahl |
Bietet die Funktionen des |
|
Schlüsselwort * |
Schlüsselwörter wirken wie eine normale Bedingung, wenn sie allein eingesetzt werden. In Kombination mit der |
|
Ganzzahl |
Setzt eine Zeitbeschränkung in Millisekunden. Danach, z.B. nach 5000 Millisekunden (5 Sekunden), wird die Abfrage ausgeführt, auch wenn die Bedingung nicht erfüllt ist. |
|
Unix-Zeit |
Versucht durch Angabe einer Referenzzeit voneinander abweichende Zeitstempel in verteilten Umgebungen auszugleichen. |
|
fixed16/off |
Gibt eine Statuszeile in der ersten Zeile der Antwort zurück. Die Ausgabe bleibt selbst dann in der ersten Zeile, wenn zusätzlich der Header |
|
on |
Verhindert, dass der Livestatus-Kanal nach einer Abfrage geschlossen wird. |
* Für den WaitTrigger gibt es folgende Schlüsselwörter:
check
state
log
downtime
comment
command
program
all
3. Operatoren für Filter
3.1. Allgemeine Operatoren
| Operator * | Bei Zahlen | Bei Zeichenketten |
|---|---|---|
|
Gleichheit |
Gleichheit |
|
Obermenge ** |
Enthält eine Zeichenfolge als regulären Ausdruck. |
|
Untermenge ** |
Schreibungsunabhängige Gleichheit |
|
Enthält mindestens einen der Werte ** |
Enthält eine schreibungsunabhängige Zeichenfolge als regulären Ausdruck. |
|
Kleiner als |
Lexikografisch kleiner als |
|
Größer als |
Lexikografisch größer als |
|
Kleiner oder gleich |
Lexikografisch kleiner oder gleich |
|
Größer oder gleich |
Lexikografisch größer oder gleich |
* Alle Operatoren können mit einem Ausrufezeichen (!) negiert werden.
** Diese Operatoren sind nützlich, wenn mit Listen gearbeitet wird. Livestatus interpretiert die angegebenen Werte dann als eine Menge.
3.2. Operatoren für Listen
Mit den folgenden Operatoren können Sie prüfen, ob ein Element in einer Liste enthalten ist:
| Operator | Art der Prüfung |
|---|---|
|
Prüft auf eine leere Liste * |
|
Gleichheit |
|
Ungleichheit |
|
Schreibungsunabhängige Gleichheit |
|
Schreibungsunabhängige Ungleichheit |
|
Die Zeichenkette eines regulären Ausdrucks * |
|
Die schreibungsunabhängige Zeichenkette eines regulären Ausdrucks * |
* Dieser Operator kann mit einem Ausrufezeichen (!) negiert werden.
4. Operatoren für Statistiken
| Operator | Beschreibung |
|---|---|
|
Bildet eine Summe aus den Werten. |
|
Sucht den kleinsten Wert heraus. |
|
Sucht den größten Wert heraus. |
|
Erstellt einen Durchschnittswert (Mittelwert). |
|
Gibt die Standardabweichung aus. |
|
Invertiert die Summe aus den Werten gemäß 1/ |
|
Invertiert den Mittelwert aus den Werten gemäß 1/ |
5. Status-Codes des ResponseHeader
| Status-Code | Beschreibung |
|---|---|
|
Der Aufruf war erfolgreich und die Antwort enthält die abgefragten Daten. |
|
Der Aufruf enthält einen fehlerhaften Header. |
|
Die Tabelle konnte nicht gefunden werden. |
|
Das Zeitlimit der Abfrage wurde überschritten. |
|
Die Abfrage wurde nicht vollständig übergeben. |
|
Die Abfrage ist komplett ungültig. |
6. Kommandos
Kommandos, welche Ihnen in allen Editionen von Checkmk zur Verfügung stehen:
| Kommando | Beschreibung |
|---|---|
Host-Kommandos | |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Die Aktualisierung eines Host-Checks zu einem bestimmten Zeitpunkt erzwingen |
|
|
|
Eine benutzerdefinierte Benachrichtigung für einen Host erstellen |
|
|
Service-Kommandos | |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Die Aktualisierung eines Services zu einem bestimmten Zeitpunkt erzwingen |
|
|
|
Eine benutzerdefinierte Benachrichtigung für einen Service erstellen |
|
|
Andere Kommandos | |
|
|
|
|
|
|
|
Die Erkennung von unstetigen Hosts/Services global verhindern |
|
|
|
|
|
Die Ausführung von Alert Handlers/Event Handlers global erlauben |
|
Die Ausführung von Alert Handlers/Event Handlers global verhindern |
|
|
Kommandos, welche Ihnen nur mit dem CMC in den kommerziellen Editionen zur Verfügung stehen:
| Kommando | Beschreibung |
|---|---|
Host-Kommandos | |
|
tba |
|
tba |
Service-Kommandos | |
|
tba |
|
tba |
Andere Kommandos | |
|
tba |
|
tba |
|
tba |
|
tba |
|
tba |
|
tba |