[comment]: # ({d220a982-0158bee8})
# 12 监控项 值

[comment]: # ({/d220a982-0158bee8})

[comment]: # ({f0bf3b77-90997d6a})
### 描述

这些参数及对应仪表板小部件字段objects的可选属性值允许进行配置
`dashboard.create`和`dashboard.update`方法中的[*Item value*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value)部件

::: noteimportant
仪表板小部件`fields`属性在创建或update过程中不会被验证。
这允许用户修改[built-in widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)和create[开发模块](/manual/modules#开发模块)，但也带来了错误创建或更新小部件的风险。
为确保成功创建或update *监控项值*小部件，请参考以下表格中列出的参数要求。

:::

[comment]: # ({/f0bf3b77-90997d6a})

[comment]: # ({7ebf36a4-c637d90d})
### 参数

以下参数支持*监控项值*部件。

| 参数 | [仪表板小部件字段](/manual/api/reference/dashboard/object#仪表板小部件字段) | 名称 | 值 |
|-----|-|-----|-------------------|
| *Refresh interval* | 0 | rf_rate | 0 - 不刷新;<br>10 - 10秒;<br>30 - 30秒;<br>60 - *(默认)* 1分钟;<br>120 - 2分钟;<br>600 - 10分钟;<br>900 - 15分钟. |
| ***Item***<br>(required) | 4 | itemid | [Item](/manual/api/reference/item/get) ID. |
| *Show* | 0 | show | 1 - 描述;<br>2 - 值;<br>3 - 时间;<br>4 - 变更指示器.<br><br>默认: 1, 2, 3, 4 (全部启用).<br><br>注意: 要配置多个值，create仪表板部件字段object每个值. |
| *Dynamic item* | 0 | dynamic | 0 - *(默认)* 禁用;<br>1 - 启用. |
| *Advanced configuration* | 0 | adv_conf | 0 - *(默认)* 禁用;<br>1 - 启用. |

[comment]: # ({/7ebf36a4-c637d90d})

[comment]: # ({6c4a776f-db4b24d9})
#### 高级配置

若*高级配置*设置为"启用"，则支持以下参数。

| 参数 | <   | [仪表板小部件字段](/manual/api/reference/dashboard/object#仪表板小部件字段) | 名称 | 值 |
|-|--------|--|--------|-------------------------------|
| *Background color* | <   | 1 | bg_color | 十六进制颜色代码（例如`FF0000`）。<br><br>默认值：`""`（空）。 |

[comment]: # ({/6c4a776f-db4b24d9})

[comment]: # ({afead1c7-078914fc})
##### 描述

若*高级配置*设为"启用"且*显示*设为"描述"时，支持以下参数。

| 参数 | [仪表板小部件字段](/manual/api/reference/dashboard/object#仪表板小部件字段) | 名称 | 值 |
|-----|-|-----|-------------------|
| *Description* | 1 | description | 任意string值，包括宏。<br>支持的宏：{主机.\*}, {监控项.\*}、{INVENTORY.\*}及用户宏。<br><br>默认：{ITEM.NAME}。 |
| *Horizontal position* | 0 | desc_h_pos | 0 - 左对齐；<br>1 - *(默认)* 居中；<br>2 - 右对齐。<br><br>两个及以上元素（描述、数值、时间）不可共享相同的*水平位置*与*垂直位置*。 |
| *Vertical position* | 0 | desc_v_pos | 0 - Top；<br>1 - 中部；<br>2 - *(默认)* 底部。<br><br>两个及以上元素（描述、数值、时间）不可共享相同的*水平位置*与*垂直位置*。 |
| *Size* | 0 | desc_size | 有效值范围1-100。<br><br>默认：15。 |
| *Bold* | 0 | desc_bold | 0 - *(默认)* 禁用；<br>1 - 启用。 |
| *Color* | 1 | desc_color | 十六进制颜色代码（如`FF0000`）。<br><br>默认：`""`（空值）。 |

[comment]: # ({/afead1c7-078914fc})

[comment]: # ({1c933529-ef72e1ef})
##### 值

若*高级配置*设为"启用"且*显示*设为"值"，则支持以下参数。

| 参数 | <   | [仪表板小部件字段](/manual/api/reference/dashboard/object#仪表板小部件字段) | 名称 | 值 |
|-|--------|--|--------|-------------------------------|
| *Decimal places* | <   | < | < | <     |
| < | *小数位数* | 0 | decimal_places | 有效值范围1-10。<br><br>默认：2。 |
| ^ | *尺寸* | 0 | decimal_size | 有效值范围1-100。<br><br>默认：35。 |
| *Position* | <   | < | < | <     |
| < | *水平位置* | 0 | value_h_pos | 0 - 左对齐；<br>1 - *(默认)* 居中；<br>2 - 右对齐。<br><br>两个及以上元素（描述、值、时间）不能共享相同的*水平位置*和*垂直位置*。 |
| ^ | *垂直位置* | 0 | value_v_pos | 0 - Top;<br>1 - *(默认)* 居中；<br>2 - 底部对齐。<br><br>两个及以上元素（描述、值、时间）不能共享相同的*水平位置*和*垂直位置*。 |
| ^ | *尺寸* | 0 | value_size | 有效值范围1-100。<br><br>默认：45。 |
| ^ | *粗体* | 0 | value_bold | 0 - 禁用；<br>1 - *(默认)* 启用。 |
| ^ | *颜色* | 1 | value_color | 十六进制颜色代码（如`FF0000`）。<br><br>默认：`""`（空值）。 |
| *Units* | <   | < | < | <     |
| < | *单位*（复选框） | 0 | units_show | 0 - 禁用；<br>1 - *(默认)* 启用。 |
| ^ | *单位*（值） | 1 | units | 任意string值。 |
| ^ | *位置* | 0 | units_pos | 0 - 值前；<br>1 - 值上方；<br>2 - *(默认)* 值后；<br>3 - 值下方。 |
| ^ | *尺寸* | 0 | units_size | 有效值范围1-100。<br><br>默认：35。 |
| ^ | *粗体* | 0 | units_bold | 0 - 禁用；<br>1 - *(默认)* 启用。 |
| ^ | *颜色* | 1 | units_color | 十六进制颜色代码（如`FF0000`）。<br><br>默认：`""`（空值）。 |

[comment]: # ({/1c933529-ef72e1ef})

[comment]: # ({2562b521-1504e2d4})
##### 时间

若*高级配置*设为"启用"且*显示*设为"时间"，则支持以下参数。

| 参数 | [仪表板小部件字段](/manual/api/reference/dashboard/object#仪表板小部件字段) | 名称 | 取值 |
|-----|-|-----|-------------------|
| *Horizontal position* | 0 | time_h_pos | 0 - 左对齐;<br>1 - *(默认)* 居中;<br>2 - 右对齐.<br><br>两个及以上元素(描述、数值、时间)不能共享相同的*水平位置*和*垂直位置*. |
| *Vertical position* | 0 | time_v_pos | 0 - *(默认)* Top;<br>1 - 中部;<br>2 - 底部.<br><br>两个及以上元素(描述、数值、时间)不能共享相同的*水平位置*和*垂直位置*. |
| *Size* | 0 | time_size | 有效值范围1-100.<br><br>默认: 15. |
| *Bold* | 0 | time_bold | 0 - *(默认)* 禁用;<br>1 - 启用. |
| *Color* | 1 | time_color | 十六进制颜色代码(如`FF0000`).<br><br>默认: `""` (空值). |

[comment]: # ({/2562b521-1504e2d4})

[comment]: # ({effbeabd-071114d8})
##### 变化指示器

若*高级配置*设为"启用"且*显示*设为"变更指示器"，则支持以下参数。

| 参数 | [仪表板小部件字段](/manual/api/reference/dashboard/object#仪表板小部件字段) | 名称 | 值 |
|-----|-|-----|-------------------|
| *Change indicator ↑ color* | 1 | up_color | 十六进制颜色代码（例如`FF0000`）。<br><br>默认值：`""`（空）。 |
| *Change indicator ↓ color* | 1 | down_color | 十六进制颜色代码（例如`FF0000`）。<br><br>默认值：`""`（空）。 |
| *Change indicator ↕ color* | 1 | updown_color | 十六进制颜色代码（例如`FF0000`）。<br><br>默认值：`""`（空）。 |

[comment]: # ({/effbeabd-071114d8})

[comment]: # ({fd9ac7eb-2dce34b2})
### 示例

以下示例仅描述仪表板小部件字段objects针对*监控项值*小部件的配置。
有关配置仪表板的更多信息，请参阅[`dashboard.create`](/manual/api/reference/dashboard/create)。

[comment]: # ({/fd9ac7eb-2dce34b2})

[comment]: # ({ac4bca74-98b4043e})
#### 配置 *监控项 值* 部件

配置一个显示监控项 "42266"(Zabbix agent可用性)的监控项值的*监控项值*部件
同时通过多项高级选项对部件进行视觉微调

请求:

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "item",
                        "name": "Item value",
                        "x": 0,
                        "y": 0,
                        "width": 4,
                        "height": 3,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 4,
                                "name": "itemid",
                                "value": 42266
                            },
                            {
                                "type": 0,
                                "name": "show",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "show",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "adv_conf",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "bg_color",
                                "value": "D1C4E9"
                            },
                            {
                                "type": 1,
                                "name": "description",
                                "value": "Agent status"
                            },
                            {
                                "type": 0,
                                "name": "desc_h_pos",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "desc_v_pos",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "desc_bold",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "desc_color",
                                "value": "F06291"
                            },
                            {
                                "type": 0,
                                "name": "value_h_pos",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "value_size",
                                "value": 25
                            },
                            {
                                "type": 1,
                                "name": "value_color",
                                "value": "FFFF00"
                            },
                            {
                                "type": 0,
                                "name": "units_show",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "time_h_pos",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "time_v_pos",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "time_size",
                                "value": 10
                            },
                            {
                                "type": 0,
                                "name": "time_bold",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "time_color",
                                "value": "9FA8DA"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```
响应:

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

[comment]: # ({/ac4bca74-98b4043e})

[comment]: # ({e9d30322-0dc1c2d5})
### 另请参阅

-   [仪表板小部件字段](/manual/api/reference/dashboard/object#仪表板小部件字段)
-   [`dashboard.create`](/manual/api/reference/dashboard/create)
-   [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-0dc1c2d5})