Checkmk
to checkmk.com

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:

TabelleKommentar

hosts

Enthält alle Informationen zu den konfigurierten Hosts.

services

Enthält alle Informationen zu den konfigurierten Services und zusätzlich die Spalten aus hosts.

hostgroups

Informationen zu den Host-Gruppen.

servicegroups

Informationen zu den Service-Gruppen.

contactgroups

Informationen zu den Kontaktgruppen.

servicesbygroup

Wie services, aber zusätzlich mit den Spalten aus servicegroups.

servicesbyhostgroup

Wie services, aber zusätzlich mit den Spalten aus hostgroups.

hostsbygroup

Wie hosts, aber zusätzlich mit den Spalten aus hostgroups.

contacts

Informationen zu den Kontakten.

commands

Alle konfigurierten Check-Commands, wie sie bei einem Service unter Service check command stehen.

timeperiods

Alle Informationen zu konfigurierten Zeitperioden.

downtimes

Wie timeperiods, nur für Wartungszeiten.

comments

Enthält alle Informationen zu Kommentaren und zusätzlich die Spalten von hosts und services.

log

Alle Informationen zu mitgeschriebenen Ereignissen. Diese sollten nach Klasse und Zeitpunkt/Zeitraum gefiltert werden.

status

Informationen zu dem Status und der Performance des Cores.

columns

Alle verfügbaren Tabellen werden hier aufgelistet. Zusätzlich gibt es auch eine Beschreibung zu jeder Spalte einer Tabelle.

statehist

Mit dieser Tabelle kann die Status-Vergangenheit eines Hosts/Services umfangreich durchsucht werden.

eventconsoleevents

Listet alle Events der Event Console. Zusätzlich verfügt diese Tabelle über alle Spalten von hosts.

eventconsolehistory

Wie eventconsoleevents nur zusätzlich noch mit Spalten zur Historie eines Events.

eventconsolestatus

Listet Statistiken zu der Performance der Event Console.

eventconsolerules

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

HeaderArgumentBeschreibung

Columns

Spaltenname

Schränkt die Ausgabe auf die angegebenen Spalten ein.

Filter

Spaltenname, Operator und Objektname

Schränkt die Ausgabe auf das definierte Objekt ein. Siehe auch Livestatus-Filter.

Or

Ganzzahl

Verbindet die letzten n Filter mit einem logischen ODER.

And

Ganzzahl

Verbindet die letzten n Filter mit einem logischen UND.

Negate

Ganzzahl

Kehrt die letzten n Filter um.

Separators

ASCII-Werte

Definiert die Zeichen, welche die Trennung eines Elements von einem anderen anzeigt.

OutputFormat

Name

Definiert eine komplett andere Ausgabe der Daten. Möglich sind json, python, python3, CSV und csv (Standardausgabe).

Stats

Operator und Spaltenname

Bildet Statistiken zu bestimmten Spalten.

StatsOr

Ganzzahl

Bietet die Funktionen des OR-Headers in den Statistiken.

StatsAnd

Ganzzahl

Bietet die Funktionen des AND-Headers in den Statistiken.

StatsNegate

Ganzzahl

Bietet die Funktionen des NEGATE-Headers in den Statistiken.

Limit

Ganzzahl

Beschränkt die Ausgabe auf n Zeilen.

Timelimit

Ganzzahl

Schränkt die Verarbeitung der Abfrage auf n Sekunden ein.

ColumnHeaders

-

Gibt in der ersten Zeile die Namen der verwendeten Spalten aus. Ist zusätzlich der Header ResponseHeader gesetzt, werden die Namen der Spalten in der zweiten Zeile ausgegeben.

AuthUser

Benutzername

Schränkt die Ausgabe auf die Zeilen ein, die der angegebene Benutzer sehen darf.

WaitObject

Objektname

Das Objekt, bei dem ein bestimmtes Verhalten erwartet wird. Das ist der Name des Objekts bzw. bei der Tabelle services der Name des Hosts gefolgt von einem Leerzeichen und der Servicebeschreibung. Wenn der Hostname selbst Leerzeichen enthält, können die zwei Elemente auch mit einem Semikolon getrennt werden. Dieser Header wird nur von den Tabellen hosts, services hostgroups servicegroups contacts und contactgroups unterstützt.

WaitCondition

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.

WaitConditionOr

Ganzzahl

Bietet die Funktionen des OR-Headers in den Wait-Bedingungen.

WaitConditionAnd

Ganzzahl

Bietet die Funktionen des AND-Headers in den Wait-Bedingungen.

WaitConditionNegate

Ganzzahl

Bietet die Funktionen des NEGATE-Headers in den Wait-Bedingungen.

WaitTrigger

Schlüsselwort*

Schlüsselwörter wirken wie eine normale Bedingung, wenn sie allein eingesetzt werden. In Kombination mit der WaitCondition erleichtert es das Auffinden von relevanten Logeinträgen und reduziert den Overhead im Livestatus.

WaitTimeout

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.

Localtime

Unix-Zeit

Versucht durch Angabe einer Referenzzeit voneinander abweichende Zeitstempel in verteilten Umgebungen auszugleichen.

ResponseHeader

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 ColumnHeaders gesetzt wurde.

KeepAlive

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 ZahlenBei 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:

OperatorArt 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

OperatorBeschreibung

sum

Bildet eine Summe aus den Werten.

min

Sucht den kleinsten Wert heraus.

max

Sucht den größten Wert heraus.

avg

Erstellt einen Durchschnittswert (Mittelwert).

std

Gibt die Standardabweichung aus.

suminv

Invertiert die Summe aus den Werten gemäß 1/sum.

avginv

Invertiert den Mittelwert aus den Werten gemäß 1/avg.

5. Statuscodes des ResponseHeader

StatuscodeBeschreibung

200

Der Aufruf war erfolgreich und die Antwort enthält die abgefragten Daten.

400

Der Aufruf enthält einen fehlerhaften Header.

404

Die Tabelle konnte nicht gefunden werden.

413

Das Zeitlimit der Abfrage wurde überschritten.

451

Die Abfrage wurde nicht vollständig übergeben.

452

Die Abfrage ist komplett ungültig.

6. Kommandos

Kommandos, welche Ihnen in allen Editionen von Checkmk zur Verfügung stehen:

KommandoBeschreibung

Host-Kommandos

ACKNOWLEDGE_HOST_PROBLEM

Probleme eines Hosts bestätigen

REMOVE_HOST_ACKNOWLEDGEMENT

Bestätigung der Probleme eines Hosts löschen

ADD_HOST_COMMENT

Einem Host einen Kommentar hinzufügen

DEL_HOST_COMMENT

Einen Kommentar bei einem Host löschen

SCHEDULE_HOST_DOWNTIME

Ein Wartungsfenster für einen Host festlegen

MODIFY_HOST_DOWNTIME

Ein Wartungsfenster für einen Host bearbeiten

DEL_HOST_DOWNTIME

Eine Downtime bei einem Host löschen

START_EXECUTING_HOST_CHECKS

Die Ausführung von Hostchecks global erlauben

STOP_EXECUTING_HOST_CHECKS

Die Ausführung von Hostschecks global verhindern

ENABLE_HOST_CHECK

Aktive Checks für einen Host erlauben

DISABLE_HOST_CHECK

Aktive Checks für einen Host verhindern

ENABLE_PASSIVE_HOST_CHECKS

Passive Hostchecks für einen Host erlauben

DISABLE_PASSIVE_HOST_CHECKS

Passive Hostchecks für einen Host verhindern

ENABLE_HOST_NOTIFICATIONS

Benachrichtigungen für einen Host erlauben

DISABLE_HOST_NOTIFICATIONS

Benachrichtigungen für einen Host verhindern

ENABLE_HOST_SVC_NOTIFICATIONS

Benachrichtigungen für alle Services eines Hosts erlauben

DISABLE_HOST_SVC_NOTIFICATIONS

Benachrichtigungen für alle Services eines Hosts verhindern

SCHEDULE_FORCED_HOST_CHECK

Die Aktualisierung eines Hostchecks zu einem bestimmten Zeitpunkt erzwingen

PROCESS_HOST_CHECK_RESULT

Das Ergebnis eines Hostchecks manuell setzen

SEND_CUSTOM_HOST_NOTIFICATION

Eine eigene Benachrichtigung für einen Host erstellen

CHANGE_HOST_MODATTR

Ändert die modifizierten Attribute eines Hosts

Service-Kommandos

ACKNOWLEDGE_SVC_PROBLEM

Probleme eines Service bestätigen

REMOVE_SVC_ACKNOWLEDGEMENT

Bestätigung der Probleme eines Service löschen

ADD_SVC_COMMENT

Einem Service einen Kommentar hinzufügen

DEL_SVC_COMMENT

Einen Kommentar bei einem Service löschen

SCHEDULE_SVC_DOWNTIME

Ein Wartungsfenster bei einem Service festlegen

MODIFY_SVC_DOWNTIME

Ein Wartungsfenster bei einem Service bearbeiten

DEL_SVC_DOWNTIME

Ein Wartungsfenster bei einem Service löschen

START_EXECUTING_SVC_CHECKS

Die Ausführen von aktiven Services global erlauben

STOP_EXECUTING_SVC_CHECKS

Die Ausführung von aktiven Services global verhindern

ENABLE_SVC_CHECK

Die Ausführung für einen bestimmten aktiven Service erlauben

DISABLE_SVC_CHECK

Die Ausführung für einen bestimmten aktiven Service verhindern

ENABLE_PASSIVE_SVC_CHECKS

Die Ausführung für einen bestimmten passiven Service erlauben

DISABLE_PASSIVE_SVC_CHECKS

Die Ausführung für einen bestimmten passiven Serviec verhindern

ENABLE_SVC_NOTIFICATIONS

Benachrichtigungen für einen bestimmten Service erlauben

DISABLE_SVC_NOTIFICATIONS

Benachrichtigungen für einen bestimmten Service verhindern

SCHEDULE_FORCED_SVC_CHECK

Die Aktualisierung eines Service zu einem bestimmten Zeitpunkt erzwingen

PROCESS_SERVICE_CHECK_RESULT

Das Ergebnis einer Serviceausgabe eines passiven Services manuell setzen

SEND_CUSTOM_SVC_NOTIFICATION

Eine eigene Benachrichtigung für einen Service erstellen

CHANGE_SVC_MODATTR

Ändert die modifizierten Attribute eines Service

Andere Kommandos

ENABLE_NOTIFICATIONS

Benachrichtigungen global erlauben

DISABLE_NOTIFICATIONS

Benachrichtigungen global verhindern

ENABLE_FLAP_DETECTION

Die Erkennung von unstetigen Hosts/Services global erlauben

DISABLE_FLAP_DETECTION

Die Erkennung von unstetigen Hosts/Services global verhindern

ENABLE_PERFORMANCE_DATA

Die Verarbeitung von Performancedaten global erlauben

DISABLE_PERFORMANCE_DATA

Die Verarbeitung von Performancedaten global verhindern

ENABLE_EVENT_HANDLERS

Die Ausführung von Alert Handlern/Event Handlern global erlauben

DISABLE_EVENT_HANDLERS

Die Ausführung von Alert Handlern/Event Handlern global verhindern

SAVE_STATE_INFORMATION

Alle Statusinformationen sofort abspeichern

Kommandos, welche Ihnen nur mit dem CMC in den CEE Checkmk Enterprise Editions zur Verfügung stehen:

KommandoBeschreibung

Host-Kommandos

PROCESS_HOST_PERFDATA

tba

UPDATE_SHADOW_HOST_STATE

tba

Service-Kommandos

PROCESS_SVC_PERFDATA

tba

UPDATE_SHADOW_SERVICE_STATE

tba

Andere Kommandos

LOG

tba

MK_LOGWATCH_ACKNOWLEDGE

tba

RELOAD_CONFIG

tba

REOPEN_DAEMONLOG

tba

ROTATE_LOGFILE

tba

SEGFAULT

tba

Auf dieser Seite