22 Trigger overview

説明

これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、dashboard.createメソッドおよびdashboard.updateメソッドでトリガーの概要ウィジェットを設定できます。

ウィジェットのfieldsプロパティは、ダッシュボードの作成または更新時に検証されません。これにより、ユーザーは組み込みウィジェットを変更したり、カスタムウィジェットを作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。 トリガーの概要ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。

パラメーター

トリガー概要ウィジェットでは、以下のパラメーターがサポートされています。

パラメーター		type	name	value
更新間隔		0	rf_rate	0 - 更新なし; 10 - 10秒; 30 - 30秒; 60 - (デフォルト) 1 分; 120 - 2分; 600 - 10分; 900 - 15分
表示		0	表示	1 - (デフォルト) 最近発生した問題; 2 - すべて; 3 - 問題
ホストグループ		2	groupids	ホストグループ ID 注: 複数のホストグループを設定するには、ホストグループごとにダッシュボードウィジェットフィールドオブジェクトを作成してください。
ホスト		3	hostids	ホスト ID 注: 複数のホストを設定するには、ホストごとにダッシュボードウィジェットフィールドオブジェクトを作成してください。複数のホストの場合、パラメータホストグループはまったく設定しないか、設定されたホストが属するホストグループを少なくとも 1 つ設定する必要があります。
タグ (プロパティ名に含まれる数字 (例: tags.tag.0) は、タグ評価リスト内のタグの順序を示します)
	評価タイプ	0	evaltype	0 - (デフォルト) および/または; 2 - または
	タグ名	1	tags.tag.0	任意の文字列値タグを設定する場合は、パラメータタグ名が必要です。
	演算子	0	tags.operator.0	0 - 含む; 1 - 等しい; 2 - 含まない; 3 - 等しくない; 4 - 存在する; 5 - 存在しない。タグを設定する場合は、パラメータ演算子が必要です。
	タグ値	1	tags.value.0	任意の文字列値タグを設定する場合は、パラメータタグ値が必要です。
抑制された問題を表示		0	show_suppressed	0 - (デフォルト) 無効; 1 - 有効
ホストの場所		0	スタイル	0 - (デフォルト) 左; 1 - 上

例

次の例は、トリガーの概要ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。ダッシュボードの設定の詳細については、dashboard.createを参照してください。

トリガーの概要ウィジェットの設定

"scope"という名前で値に"availability"を含むタグでトリガーされ、すべてのホストグループのトリガー状態を表示するトリガー概要ウィジェットを設定します。

リクエスト:

{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "My dashboard",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "trigover",
                               "name": "Trigger overview",
                               "x": 0,
                               "y": 0,
                               "width": 12,
                               "height": 5,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 1,
                                       "name": "tags.tag.0",
                                       "value": "scope"
                                   },
                                   {
                                       "type": 0,
                                       "name": "tags.operator.0",
                                       "value": 0
                                   },
                                   {
                                       "type": 1,
                                       "name": "tags.value.0",
                                       "value": "availability"
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

レスポンス:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

Documentation

22 Trigger overview

説明

パラメーター

例

トリガーの概要ウィジェットの設定

参照