Checkmk
to checkmk.com
Important

This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved.

1. 使用可能なテーブル

ライブステータスでは、以下のテーブルを使用できます。 そのうちのいくつかは、別のテーブルの列に対して追加機能として動作します。 これらの列は、テーブル名のプレフィックスで識別されます。

テーブル コメント

hosts

設定されたホストに関するすべての情報が含まれます。

services

設定されたサービスに関するすべての情報、およびhosts の列が含まれます。

hostgroups

ホストグループに関する情報。

servicegroups

サービスグループに関する情報です。

contactgroups

連絡先グループに関する情報です。

servicesbygroup

services と同様ですが、servicegroups の列も含まれます。

servicesbyhostgroup

services と同様ですが、hostgroups の列も追加されています。

hostsbygroup

hosts と同様ですが、hostgroups の列を追加します。

contacts

連絡先に関する情報です。

commands

Service check command でサービスに対して設定されているすべてのチェックコマンド。

timeperiods

設定された期間に関するすべての情報です。

downtimes

timeperiods と同様ですが、スケジュールダウンタイム用です。

comments

コメントに関するすべての情報を含み、さらにhosts およびservices の列も含まれます。

log

ログに記録されたイベントに関するすべての情報。これらは、クラスおよびタイムスタンプ/期間でフィルタリングする必要があります。

status

コアのステータスおよびパフォーマンスに関する情報です。

columns

利用可能なすべてのテーブルがここにリストされます。さらに、テーブルのすべての列の説明も表示されます。

statehist

このテーブルでは、ホスト/サービスの過去の状態を包括的に検索できます。

eventconsoleevents

イベントコンソールのすべてのイベントをリスト表示します。このテーブルには、hosts のすべての列も追加されています。

eventconsolehistory

eventconsoleevents と同様ですが、イベントのヒストリーに関する列が追加されています。

eventconsolestatus

イベントコンソールのパフォーマンスに関する統計情報をリスト表示します。

eventconsolerules

着信イベントのルール一致の成功頻度の統計情報を表示します。

テーブルが使用する列を確認したい場合は、次のコマンドで簡単に表示できます。

OMD[mysite]:~$ lq "GET columns\nColumns: name\nFilter: table = columns"
description
name
table
type

フィルターを使用することで、他のテーブルも選択可能です。 列とテーブルで検索可能なすべての列は、例示された出力に表示されます。

2. 使用可能なヘッダー

ヘッダー 引数 関数

Columns

列名

指定した列への出力を制限します。

Filter

列名、オペレーター、およびオブジェクト名

定義されたオブジェクトへの出力を制限します。filter も参照してください。

OrderBy

列名または辞書キー

列の内容または値で出力をソートします。デフォルトのソート順は昇順ですが、asc またはdesc から 1 つを追加で指定することもできます。

OR

整数

最後のn フィルターを論理和(OR)で連結します。

AND

整数

最後のn フィルターを論理ANDで結合します。

NEGATE

整数

最後のn フィルターを反転します。

Separators

ASCII値

エレメントを区切る文字を定義します。

OutputFormat

名前

データの代替出力形式を定義します。可能な形式は、jsonpythonpython3CSV 、およびcsv (標準形式)です。

Stats

オペレーターおよび列名

指定した列の統計情報を生成します。

StatsOr

整数

統計にOR ヘッダーの関数を提供します。

StatsAnd

整数

統計情報にAND ヘッダーの関数を提供します。

StatsNegate

整数

NEGATE ヘッダーの関数を統計機能で提供します。

Limit

整数

出力をn 行に制限します。

Timelimit

整数

クエリの処理に許される時間をn 秒に制限します。

ColumnHeaders

-

出力の最初の行には、使用された列の名前が含まれます。ヘッダーResponseHeader が追加で設定されている場合、列名は2行目に出力されます。

AuthUser

ユーザー名

指定したユーザーが閲覧を認可されている行のみを出力します。

WaitObject

オブジェクト名

指定した動作が予想されるオブジェクト。これはオブジェクトの名前、またはservices テーブルの場合は、ホスト名、空白文字、サービス内容の順で指定します。ホスト名自体に空白文字が含まれている場合は、2つのエレメントをセミコロンで区切ることができます。このヘッダーは、hostsservices hostgroups servicegroups contacts 、およびcontactgroups テーブルでのみサポートされています。

WaitCondition

フィルタ条件

定義されたオブジェクトが満たさなければならない条件。条件はいくつでも定義でき、これらは論理 AND で連結されます。

WaitConditionOr

整数

待機条件で整数関数OR を提供します。

WaitConditionAnd

整数

待機条件でヘッダー関数AND を提供します。

WaitConditionNegate

整数

Wait-conditions でヘッダー関数NEGATE を提供します。

WaitTrigger

キーワード

キーワードは、単独で設定された場合、通常の条件と同様に機能します。WaitCondition と組み合わせることで、関連するログエントリの検索が簡単になり、ライブステータスのオーバーヘッドが削減されます。

WaitTimeout

整数

ミリ秒単位で時間制限を設定します。たとえば、5000 ミリ秒 (5 秒) を設定すると、条件が満たされていなくてもクエリは実行されます。

Localtime

Unix 時間

指定した基準時刻を使用することで、分散環境におけるローカルタイムスタンプの違いを補正しようと試みます。

ResponseHeader

fixed16/off

応答の 1 行目にステータス行を返します。ヘッダーColumnHeaders が追加で設定されている場合、出力自体は 1 行目に残ります。

KeepAlive

on

クエリ後にライブステータスチャンネルが閉じられるのを防ぎます。

*WaitTrigger には、以下のキーワードを使用できます。

  • チェック

  • 状態

  • log

  • ダウンタイム

  • コメント

  • コマンド

  • プログラム

  • すべて

3. フィルタのオペレーター

3.1. 一般的なオペレーター

演算子 * 数値用 文字列に対して

=

等価

等価

~

上位集合 **

正規表現として文字列を含みます。

=~

部分集合 **

大文字小文字を区別しない等価

~~

少なくとも1つの値を含みます **

大文字小文字を区別しない文字列を正規表現として含みます。

<

より小さい

辞書順で小さい

>

より大きい

辞書順で大きい

<=

より小さいか等しい

辞書順で小さいか等しい

>=

より大きいまたは等しい

辞書順で大きいまたは等しい

* すべてのオペレーターは、感嘆符 (!) で否定することができます。

** これらのオペレーターは、リストを扱う場合に便利です。ライブステータスは、指定された値を数量として解釈します。

3.2. リストの演算子

次の演算子を使用して、エレメントがリストに含まれているかどうかをチェックすることができます。

演算子 チェックの種類

=

空のリストをチェックします *

>=

等価

<

不一致

<=

大文字小文字を区別しない等価

>

大文字小文字を区別しない不一致

~

正規表現の文字列 *

~~

正規表現の文字列の大文字小文字を区別しない形式 *

* これらのオペレーターは、感嘆符 (!) で否定することができます。

4. 統計用オペレーター

オペレーター 説明

sum

値から合計を生成します。

min

最小の値を検索します。

max

最大の値を検索します。

avg

平均値(平均)を計算します。

std

標準偏差を出力します。

suminv

値の合計を1/sum に従って逆転します。

avginv

値の平均値を1/avg に従って逆順にします。

5. ResponseHeader のステータスコード

ステータスコード 説明

200

クエリは成功し、応答には要求されたデータが含まれています。

400

クエリに不正なヘッダーが含まれています。

404

テーブルが見つかりませんでした。

413

クエリの時間制限が超過しました。

451

クエリが完全に転送されませんでした。

452

クエリは完全に無効です。

6. コマンド

以下のコマンドは、すべての Checkmk エディションで使用できます。

コマンド 説明

ホストコマンド

ACKNOWLEDGE_HOST_PROBLEM

ホストの問題を承認します。

REMOVE_HOST_ACKNOWLEDGEMENT

ホストの問題の承認を削除します。

ADD_HOST_COMMENT

ホストにコメントを追加します。

DEL_HOST_COMMENT

ホストからのコメントを削除します。

SCHEDULE_HOST_DOWNTIME

ホストのダウンタイムをスケジュールします

DEL_HOST_DOWNTIME

ホストのダウンタイムを削除します

START_EXECUTING_HOST_CHECKS

ホストチェックのグローバル実行を開始します。

STOP_EXECUTING_HOST_CHECKS

ホストチェックのグローバル実行を停止します。

ENABLE_HOST_CHECK

ホストのアクティブチェックを有効にする

DISABLE_HOST_CHECK

ホストのアクティブチェックを無効にする

ENABLE_PASSIVE_HOST_CHECKS

ホストのパッシブホストチェックを有効にします

DISABLE_PASSIVE_HOST_CHECKS

ホストのパッシブホストチェックを無効にします。

ENABLE_HOST_NOTIFICATIONS

ホストの通知を有効にする

DISABLE_HOST_NOTIFICATIONS

ホストの通知を無効にする

ENABLE_HOST_SVC_NOTIFICATIONS

ホストのすべてのサービスの通知を有効にする

DISABLE_HOST_SVC_NOTIFICATIONS

ホストのすべてのサービスの通知を無効にする

SCHEDULE_FORCED_HOST_CHECK

ホストチェックの強制更新をスケジュールします。

PROCESS_HOST_CHECK_RESULT

ホストチェックの結果を手動で設定する

SEND_CUSTOM_HOST_NOTIFICATION

カスタムホスト通知を作成します

CHANGE_HOST_MODATTR

ホストの修正属性を編集する

サービスコマンド

ACKNOWLEDGE_SVC_PROBLEM

サービスの問題を承認する

REMOVE_SVC_ACKNOWLEDGEMENT

サービス問題の承認を削除する

ADD_SVC_COMMENT

サービスにコメントを追加する

DEL_SVC_COMMENT

サービスからのコメントを削除する

SCHEDULE_SVC_DOWNTIME

サービスのダウンタイムをスケジュールします

DEL_SVC_DOWNTIME

サービスのダウンタイムを削除します。

START_EXECUTING_SVC_CHECKS

アクティブなサービスのグローバル実行を開始します。

STOP_EXECUTING_SVC_CHECKS

アクティブなサービスのグローバル実行を停止します

ENABLE_SVC_CHECK

アクティブなサービスの実行を有効にする

DISABLE_SVC_CHECK

アクティブなサービスの実行を無効にする

ENABLE_PASSIVE_SVC_CHECKS

パッシブサービスの実行を有効にする

DISABLE_PASSIVE_SVC_CHECKS

パッシブサービスの実行を無効にする

ENABLE_SVC_NOTIFICATIONS

サービスの通知を有効にする

DISABLE_SVC_NOTIFICATIONS

サービスの通知を無効にする

SCHEDULE_FORCED_SVC_CHECK

サービスの強制更新をスケジュールします

PROCESS_SERVICE_CHECK_RESULT

パッシブサービスの結果を手動で設定します。

SEND_CUSTOM_SVC_NOTIFICATION

カスタムサービス通知を作成する

CHANGE_SVC_MODATTR

サービスの変更した属性を編集します

その他のコマンド

ENABLE_NOTIFICATIONS

通知をグローバルに有効にする

DISABLE_NOTIFICATIONS

通知をグローバルに無効にする

ENABLE_FLAP_DETECTION

フラッピングホスト/サービスの検出をグローバルに有効にする

DISABLE_FLAP_DETECTION

フラッピングホスト/サービスの検出をグローバルに無効にします。

ENABLE_PERFORMANCE_DATA

パフォーマンスデータの処理をグローバルに有効にする

DISABLE_PERFORMANCE_DATA

パフォーマンスデータの処理をグローバルに無効にする

ENABLE_EVENT_HANDLERS

アラートハンドラー/イベントハンドラーの実行をグローバルに有効にする

DISABLE_EVENT_HANDLERS

アラートハンドラー/イベントハンドラーの実行をグローバルに無効にします。

SAVE_STATE_INFORMATION

すべてのステータス情報をすぐに保存します

商業版で CMC でのみ使用可能なコマンド:

コマンド 説明

ホストコマンド

PROCESS_HOST_PERFDATA

未定

UPDATE_SHADOW_HOST_STATE

未定

サービスコマンド

PROCESS_SVC_PERFDATA

未定

UPDATE_SHADOW_SERVICE_STATE

未定

その他のコマンド

LOG

未定

MK_LOGWATCH_ACKNOWLEDGE

未定

RELOAD_CONFIG

未定

REOPEN_DAEMONLOG

未定

ROTATE_LOGFILE

未定

SEGFAULT

未定

このページでは