これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、dashboard.createメソッドおよびdashboard.updateメソッドでホスト稼働状況ウィジェットを設定できます。
ホスト可用性ウィジェットでは、以下のパラメーターがサポートされています。
| パラメーター | type | name | value | |
|---|---|---|---|---|
| 更新間隔 | 0 | rf_rate | 0 - 更新なし; 10 - 10秒; 30 - 30秒; 60 - 1分; 120 - 2分; 600 - 10分; 900 - (デフォルト) 15分 | |
| ホスト グループ | 2 | groupids.0 | ホスト グループ ID 注: 複数のホスト グループを構成するには、プロパティ名に増分番号を含む各ホスト グループのダッシュボード ウィジェット フィールド オブジェクトを作成します。 このパラメーターは、テンプレート ダッシュボード でウィジェットを構成する場合はサポートされません。 | |
| ホスト グループ (ウィジェット) | 1 | groupids._reference | ホスト グループ ID: ABCDE._hostgroupidsの代わりに、ホスト グループのデータ ソースとして 互換性のあるウィジェット (Reference パラメータを "ABCDEに設定) を設定します。テンプレート ダッシュボード でウィジェットを構成する場合、このパラメータはサポートされません。 | |
| インターフェース タイプ | 0 | interface_type.0 | 0 - なし; 1 - Zabbix エージェント (パッシブ チェック); 2 - SNMP; 3 - IPMI; 4 - JMX; 5 - Zabbix エージェント (アクティブ チェック) デフォルト: 1、2、3、4、5 (すべて有効) 注: 複数の値を設定するには、プロパティ名に増分番号を付けた各値のダッシュボード ウィジェット フィールド オブジェクトを作成します。 | |
| レイアウト | 0 | layout | 0 - (デフォルト) 水平; 1 - 垂直 | |
| メンテナンス中のホストを表示 | 0 | maintenance | 0 - (デフォルト) 無効; 1 - 有効 | |
| 合計のみを表示 | 0 | only_totals | 0 - (デフォルト) 無効; 1 - 有効 | |
次の例は、ホスト稼働状況ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。 ダッシュボードの設定の詳細については、dashboard.createを参照してください。
"Zabbixエージェント"および"SNMP"インターフェースが設定されているホストグループ"4"のホストの可用性情報を(縦型レイアウトで)表示するホスト稼働状況ウィジェットを設定します。
{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "My dashboard",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "hostavail",
                               "name": "Host availability",
                               "x": 0,
                               "y": 0,
                               "width": 18,
                               "height": 3,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 2,
                                       "name": "groupids.0",
                                       "value": 4
                                   },
                                   {
                                       "type": 0,
                                       "name": "interface_type",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "interface_type",
                                       "value": 2
                                   },
                                   {
                                       "type": 0,
                                       "name": "layout",
                                       "value": 1
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "id": 1
       }レスポンス: