1. index
  2. 監視
  3. 設定
  4. コマンド
  5. その他

X-MON API ドキュメント

X-MONのAPI機能のドキュメントです。

確認したいメソッドを左側のメニューから選んで確認してください。

各メソッドの権限表示について

各メソッドはAPIにリクエストを送るユーザの権限によって利用可能、制限あり、不可という区分があります。本ドキュメントでは、次のように権限を分類しています。

権限名

該当メソッドが制限なく使えるもの

権限名

該当メソッドが制限付き使えるもの

制限の内容はドキュメントに記載されています。

権限名

該当メソッドが使用不可能なもの

SDKに関して

X-MON APIのSDKに関しては以下をご参照ください。

APIリクエストの基本フォーマット

X-MONのAPIは、JSON-RPCにてやり取りを行います。

リクエストパラメータ

カラム名称 概要
jsonrpc 必須 string

jsonrpcのバージョンを指定します。

2.0 を指定してください。

method 必須 string

実行するメソッドを指定します。

params array

メソッドに渡すパラメータを指定します。

id 必須 string

任意のIDを指定します。

レスポンスにも同じIDが返ってきます。

user_id 必須 string

APIを実行するX-MONのユーザIDを指定します。

auth_token 必須 string

user_idで指定したユーザのX-MON APIアクセスキーを指定します。

user_id/auth_tokenは、X-MONの「X-MON API 設定」で作成したものを使用してください。

レスポンスカラム

カラム名称 概要
result

リクエストが正常に成功した場合は、resultカラムが返ってきます。

記載内容はメソッドによって違います。

error

エラーが発生した場合は、errorカラムが返ってきます。

id

リクエストに付与したIDがそのまま返ってきます。

実行例

監視概要のホスト情報のみを取得するリクエスト

リクエスト
{  "jsonrpc":"2.0",  "method":"tac.get",  "id":"1",  "params":{   "columns":{    "hosts":true,    "services":false,    "monitoring":false,   }  },  "user_id":"admin",  "auth_token":"0b7670bda71ac0a38e384ab7d4956d19e13655e5" }
レスポンス
{  "jsonrpc":"2.0",  "result":{   "hosts":{    "hosts_down":"0",    "hosts_down_scheduled":"0",    "hosts_down_acknowledged":"0",    "hosts_down_disabled":"0",    "hosts_down_unacknowledged":"0",    "hosts_unreachable":"1",    "hosts_unreachable_scheduled":"0",    "hosts_unreachable_acknowledged":"0",    "hosts_unreachable_disabled":"1",    "hosts_unreachable_unacknowledged":"0",    "hosts_up":"1",    "hosts_up_disabled":"0",    "hosts_up_unacknowledged":"0",    "hosts_pending":"2",    "hosts_pending_disabled":"0",    "hosts_all":"4",    "hosts_problems":"1"   }  },  "id":"1" }