28 Top items

説明

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

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

Parameters

トップアイテムウィジェットでは、以下のパラメータがサポートされています。

パラメータ < 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 に設定) を設定します。

このパラメータは、テンプレート ダッシュボード でウィジェットを構成する場合、サポートされません。
ホスト < 3 hostids.0 ホスト ID

注: 複数のホストを構成するには、プロパティ名に増分番号を含むダッシュボード ウィジェット フィールド オブジェクトをホストごとに作成します。複数のホストの場合、パラメータ ホスト グループ はまったく構成されていないか、構成されたホストが属する少なくとも 1 つのホスト グループで構成されている必要があります。

このパラメータは、テンプレート ダッシュボード でウィジェットを構成する場合はサポートされません。
< ホスト (ウィジェット/ダッシュボード) 1 hostids._reference ホスト ID の代わりに:
DASHBOARD.hostids - ホスト セレクター をホストのデータソースとして設定します。
ABCDE._hostids - 互換性のあるウィジェット (Reference パラメータを "ABCDE に設定) をホストのデータソースとして設定します。

このパラメータは、テンプレート ダッシュボード でウィジェットを構成する場合はサポートされません。
ホスト タグ < < < <
< 評価タイプ 0 host_tags_evaltype 0 - (デフォルト) And/Or;
2 - Or.

このパラメーターは、テンプレート ダッシュボード でウィジェットを構成する場合、サポートされません。
^ タグ名 1 host_tags.0.tag 任意の文字列値

注: プロパティ名の数字は、タグ評価リスト内のタグの順序を参照します。

パラメーターの動作:
- ホストタグ を構成する場合は 必須

このパラメーターは、テンプレート ダッシュボード でウィジェットを構成する場合、サポートされません。
^ 演算子 0 host_tags.0.operator 0 - 含む;
1 - 等しい;
2 - 含まない;
3 - 等しくない;
4 - 存在する;
5 - 存在しない

注: プロパティ名の数字は、タグ評価リスト内のタグの順序を示します。

パラメーターの動作:
- ホストタグ を構成する場合は 必須

このパラメーターは、テンプレートダッシュボード でウィジェットを構成する場合はサポートされません。
^ タグ値 1 host_tags.0.value 任意の文字列値

注: プロパティ名の数字は、タグ評価リスト内のタグ順序を参照します。

パラメーターの動作:
- ホストタグ を構成する場合は 必須

このパラメーターは、テンプレート ダッシュボード でウィジェットを構成する場合はサポートされません。
レイアウト < 0 レイアウト 0 - (デフォルト) 水平
1 - 垂直
問題の表示 < 0 show_problems 0 - すべて
1 - (デフォルト) 抑制なし
2 - なし
項目 (以下を参照) < < < <

Advanced configuration

上位アイテムウィジェットでは、以下の詳細設定パラメータがサポートされています。

パラメータ type name value
ホストの順序
並べ替え 0 host_ordering_order_by 0 - (default) ホスト名;
3 - アイテムの値
アイテムパターン 1 host_ordering_item.0 アイテム の名前またはパターン(例:"*: 1 秒あたりに処理される * 値の数")

注: 複数のアイテムパターンを設定するには、プロパティ名に増分番号を含む各アイテムパターンのダッシュボードウィジェットフィールドオブジェクトを作成します。

テンプレートダッシュボード でウィジェットを設定する場合は、テンプレートで構成されているアイテムのパターンのみを設定する必要があります。

パラメータの動作:
- Order by が "Item value" に設定されている場合、必須
Order 0 host_ordering_order 2 - (デフォルト) 上位 N 件;
3 - 下位 N 件
制限 0 host_ordering_limit 有効な値の範囲は1~100です。

デフォルト: 10
アイテムの順序
順序付け 0 item_ordering_order_by 1 - ホスト
2 - アイテム名
3 - (デフォルト) アイテムの値
ホストパターン 1 item_ordering_host.0 ホスト の名前またはパターン

注: 複数のホストパターンを設定するには、プロパティ名に増分番号を付けた、ホストパターンごとにダッシュボードウィジェットフィールドオブジェクトを作成します。

パラメータの動作:
- 順序付け が "Host" に設定されている場合は 必須
順序 0 item_ordering_order 2 - (デフォルト) 上位 N 件;
3 - 下位 N 件
制限 0 item_ordering_limit 指定可能な値の範囲は 1 ~ 100 です。

デフォルト: 10 件

プロパティ名の最初の数字(例: columns.0.items.0、columns.0.item_tags_evaltype)は特定の列を表し、2番目の数字が存在する場合は設定されたエンティティ(例: アイテムパターン、タグ)を表します。

パラメータ type name value
アイテムパターン 1 columns.0.items.0 アイテム名またはパターン(例: "*: 1秒あたりに処理された*値の数")。

注意: 複数のアイテムパターンを設定するには、プロパティ名の2番目の数字を増やして、各アイテムパターンごとにダッシュボードウィジェットフィールドオブジェクトを作成します。

テンプレートダッシュボードでウィジェットを設定する場合は、テンプレート上で設定されたアイテムのパターンのみを設定してください。

パラメータの動作:
- 必須
アイテムタグ
評価タイプ 0 columns.0.item_tags_evaltype 0 - (デフォルト) And/Or;
2 - Or.
タグ名 1 columns.0.item_tags.0.tag 任意の文字列値。

注意: プロパティ名の2番目の数字は、タグ評価リスト内のタグ順序を参照します。

パラメータの動作:
- アイテムタグを設定する場合は必須
演算子 0 columns.0.item_tags.0.operator 0 - 含む;
1 - 等しい;
2 - 含まない;
3 - 等しくない;
4 - 存在する;
5 - 存在しない。

注意: プロパティ名の2番目の数字は、タグ評価リスト内のタグ順序を参照します。

パラメータの動作:
- アイテムタグを設定する場合は必須
タグ値 1 columns.0.item_tags.0.value 任意の文字列値。

注意: プロパティ名の2番目の数字は、タグ評価リスト内のタグ順序を参照します。

パラメータの動作:
- アイテムタグを設定する場合は必須
ベース色 1 columns.0.base_color 16進数のカラーコード(例: FF0000)。
値の表示形式 0 columns.0.display_value_as 1 - (デフォルト) 数値;
2 - テキスト。
表示 0 columns.0.display 1 - (デフォルト) そのまま;
2 - バー;
3 - インジケーター;
6 - スパークライン。
最小 1 columns.0.min 任意の数値。 接尾辞(例: "1d"、"2w"、"4K"、"8G")をサポートします。

パラメータの動作:
- 値の表示形式が"数値"に設定され、表示が"バー"または"インジケーター"に設定されている場合にサポートされます
最大 1 columns.0.max 任意の数値。 接尾辞(例: "1d"、"2w"、"4K"、"8G")をサポートします。

パラメータの動作:
- 値の表示形式が"数値"に設定され、表示が"バー"または"インジケーター"に設定されている場合にサポートされます
スパークライン
0 columns.0.sparkline.width 指定可能な値の範囲は0~10です。

デフォルト: 1。

パラメータの動作:
- 表示が"スパークライン"に設定されている場合にサポートされます
塗りつぶし 0 columns.0.sparkline.fill 指定可能な値の範囲は0~10です。

デフォルト: 3。

パラメータの動作:
- 表示が"スパークライン"に設定されている場合にサポートされます
1 columns.0.sparkline.color 16進数のカラーコード(例: FF0000)。

デフォルト: 42A5F5

パラメータの動作:
- 表示が"スパークライン"に設定されている場合にサポートされます
期間 1 columns.0.sparkline.time_period._reference DASHBOARD._timeperiod - 期間セレクターをデータソースとして設定します;
ABCDE._timeperiod - 互換性のあるウィジェット(その reference パラメータが ABCDE に等しいもの)をデータソースとして設定します。

デフォルト: DASHBOARD._timeperiod

または、開始および終了パラメータでのみ期間を設定することもできます。

パラメータの動作:
- 表示が"スパークライン"に設定されている場合にサポートされます
開始 1 columns.0.sparkline.time_period.from 絶対時間(YYYY-MM-DD hh:mm:ss)または相対時間構文(nownow/dnow/w-1w など)の有効な時間文字列。

パラメータの動作:
- 表示が"スパークライン"に設定されている場合にサポートされます
- columns.0.sparkline.time_period.to が設定されている場合は必須
終了 1 columns.0.sparkline.time_period.to 絶対時間(YYYY-MM-DD hh:mm:ss)または相対時間構文(nownow/dnow/w-1w など)の有効な時間文字列。

パラメータの動作:
- 表示が"スパークライン"に設定されている場合にサポートされます
- columns.0.sparkline.time_period.from が設定されている場合は必須
履歴データ 0 columns.0.sparkline.history 0 - (デフォルト) 自動;
1 - 履歴;
2 - トレンド。

パラメータの動作:
- 表示が"スパークライン"に設定されている場合にサポートされます
しきい値
1 columns.0.thresholds.0.color 16進数のカラーコード(例: FF0000)。

パラメータの動作:
- 値の表示形式が"数値"に設定されている場合にサポートされます
しきい値 1 columns.0.thresholds.0.threshold 任意の数値。 接尾辞(例: "1d"、"2w"、"4K"、"8G")をサポートします。

パラメータの動作:
- 値の表示形式が"数値"に設定されている場合にサポートされます
ハイライト
ハイライト 1 columns.0.highlights.0.color 16進数のカラーコード(例: FF0000)。

パラメータの動作:
- 値の表示形式が"テキスト"に設定されている場合にサポートされます
しきい値 1 columns.0.highlights.0.pattern 任意の正規表現。

パラメータの動作:
- 値の表示形式が"テキスト"に設定されている場合にサポートされます
小数点以下桁数 0 columns.0.decimal_places 指定可能な値の範囲は0~10です。

デフォルト: 2。
高度な設定
集計関数 0 columns.0.aggregate_function 値の表示形式が"数値"に設定されている場合:
0 - (デフォルト) 使用しない;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.

値の表示形式が"テキスト"に設定されている場合:
0 - (デフォルト) 使用しない;
4 - count;
6 - first;
7 - last.
期間 1 columns.0.time_period._reference DASHBOARD._timeperiod - 期間セレクターをデータソースとして設定します;
ABCDE._timeperiod - 互換性のあるウィジェット(その reference パラメータが ABCDE に等しいもの)をデータソースとして設定します。

デフォルト: DASHBOARD._timeperiod

または、開始および終了パラメータでのみ期間を設定することもできます。

パラメータの動作:
- 集計関数が"min"、"max"、"avg"、"count"、"sum"、"first"、"last"に設定されている場合にサポートされます
開始 1 columns.0.time_period.from 絶対時間(YYYY-MM-DD hh:mm:ss)または相対時間構文(nownow/dnow/w-1w など)の有効な時間文字列。

パラメータの動作:
- 期間が設定されておらず、集計関数が"min"、"max"、"avg"、"count"、"sum"、"first"、"last"に設定されている場合にサポートされます
- columns.0.time_period.to が設定されている場合は必須
終了 1 columns.0.time_period.to 絶対時間(YYYY-MM-DD hh:mm:ss)または相対時間構文(nownow/dnow/w-1w など)の有効な時間文字列。

パラメータの動作:
- 期間が設定されておらず、集計関数が"min"、"max"、"avg"、"count"、"sum"、"first"、"last"に設定されている場合にサポートされます
- columns.0.time_period.from が設定されている場合は必須
履歴データ 0 columns.0.history 0 - (デフォルト) 自動;
1 - 履歴;
2 - トレンド。

パラメータの動作:
- 値の表示形式が"数値"に設定されている場合にサポートされます

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

トップアイテム ウィジェットの設定

ホスト"10084"のデータと、名前が"component"のタグに値が"cpu"を含むアイテムのみを表示する トップアイテム ウィジェットを設定します。 さらに、ホストを上位に表示し、セルを表すために色付きのゲージバーを使用します。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "topitems",
                        "name": "Top items",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 3,
                                "name": "hostids.0",
                                "value": 10084
                            },
                            {
                                "type": 1,
                                "name": "columns.0.items.0",
                                "value": "*"
                            },
                            {
                                "type": 1,
                                "name": "columns.0.item_tags.0.tag",
                                "value": "component"
                            },
                            {
                                "type": 0,
                                "name": "columns.0.item_tags.0.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "columns.0.item_tags.0.value",
                                "value": "cpu"
                            },
                            {
                                "type": 0,
                                "name": "columns.0.display",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "layout",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Response:

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

参照