[comment]: # ({65c03452-e03ef403})
# 15 监控项卡片
[comment]: # ({/65c03452-e03ef403})
[comment]: # ({50641221-cb7939c5})
### 描述
这些参数以及相应仪表板小部件字段对象的可能属性值，可用于在 `dashboard.create` 和 `dashboard.update` 方法中配置 [*监控项卡片*](/manual/web_interface/frontend_sections/dashboards/widgets/item_card) 小部件。
::: noteimportant
在创建或更新仪表板期间，不会对小部件 `fields` 属性进行验证。
这使用户能够修改[内置小部件](/manual/web_interface/frontend_sections/dashboards/widgets)并创建[自定义小部件](/devel/modules/tutorials/widget)，但也会带来错误创建或更新小部件的风险。
为确保成功创建或更新 *监控项卡片* 小部件，请参阅下表中列出的参数行为。
:::
[comment]: # ({/50641221-cb7939c5})
[comment]: # ({8318f93b-b004895d})
### 参数
以下参数适用于 *监控项卡片* 部件。
|参数|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*刷新间隔*|<|0|rf_rate|0 - 不刷新；
10 - 10 秒；
30 - 30 秒；
60 - *(默认)* 1 分钟；
120 - 2 分钟；
600 - 10 分钟；
900 - 15 分钟。|
|*监控项*|<|4|itemid.0|[Item](/manual/api/reference/item/get) ID。
[参数行为](/manual/api/reference_commentary#parameter-behavior)：
- 如果未设置 *监控项（部件）*，则为 *必填*|
|<|*监控项（部件）*|1|itemid.\_reference|用于代替 [Item](/manual/api/reference/item/get) ID：
`ABCDE._itemid` - 将一个[兼容的部件](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility)（其 *Reference* 参数设置为 "`ABCDE`"）设置为监控项的数据源。
[参数行为](/manual/api/reference_commentary#parameter-behavior)：
- 如果未设置 *监控项*，则为 *必填*|
|*显示*|<|0|sections.0|0 - 描述；
1 - 错误文本；
2 - 指标；
3 - 最新数据；
4 - 信息类型；
5 - 触发器；
6 - 主机接口；
7 - 类型；
8 - 主机资产记录；
9 - 标签。
注意：属性名称中的数字表示该部分在部分列表中的顺序。要配置多个部分，请为每个部分创建一个仪表板部件字段对象，并在属性名称中使用递增的数字。|
|*覆盖主机*|<|1|override_hostid.\_reference|`ABCDE._hostid` - 将一个[兼容的部件](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility)（其 *Reference* 参数设置为 "`ABCDE`"）设置为主机的数据源；
`DASHBOARD._hostid` - 将仪表板的[主机选择器](/manual/web_interface/frontend_sections/dashboards/widgets#override-host)设置为主机的数据源。
默认值：`""`（空）
如果在[模板仪表板](/manual/api/reference/templatedashboard/object)上配置该部件，则不支持此参数。|
[comment]: # ({/8318f93b-b004895d})
[comment]: # ({6fb91e67-7444d2e3})
#### 迷你图
如果 *显示* 设置为“最新数据”，则支持以下参数。
|参数|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*宽度*|<|0|sparkline.width|可能的值范围为 0-10。
默认值：1。|
|*填充*|<|0|sparkline.fill|可能的值范围为 0-10。
默认值：3。|
|*颜色*|<|1|sparkline.color|十六进制颜色代码（例如 `FF0000`）。
默认值：`42A5F5`。|
|*时间段*|<|1|sparkline.time_period.\_reference|`DASHBOARD._timeperiod` - 将仪表板的[时间段选择器](/manual/web_interface/time_period_selector)设置为数据源；
`ABCDE._timeperiod` - 将一个[兼容的部件](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility)（其 `reference` 参数等于 `ABCDE`）设置为数据源。
默认值：`""`（空）
或者，您也可以仅在 *从* 和 *到* 参数中设置时间段。|
|<|*从*|1|sparkline.time_period.from|有效的时间字符串，支持绝对时间（`YYYY-MM-DD hh:mm:ss`）或[相对](/manual/web_interface/time_period_selector)时间语法（`now`、`now/d`、`now/w-1w` 等）。
默认值：now-1h。
[参数行为](/manual/api/reference_commentary#parameter-behavior)：
- 如果未设置 *时间段*，则 *支持*
- 如果设置了 `sparkline.time_period.to`，则 *必需*|
|^|*到*|1|sparkline.time_period.from|有效的时间字符串，支持绝对时间（`YYYY-MM-DD hh:mm:ss`）或[相对](/manual/web_interface/time_period_selector)时间语法（`now`、`now/d`、`now/w-1w` 等）。
默认值：now。
[参数行为](/manual/api/reference_commentary#parameter-behavior)：
- 如果未设置 *时间段*，则 *支持*
- 如果设置了 `time_period.to`，则 *必需*|
|*历史数据*|<|0|sparkline.history|0 - *（默认）* 自动；
1 - 历史；
2 - 趋势。|
[comment]: # ({/6fb91e67-7444d2e3})
[comment]: # ({7148225f-f146ed91})
### 示例
以下示例仅旨在说明 *监控项卡片* 部件的仪表板部件字段对象配置。
有关配置仪表板的更多信息，请参见 [`dashboard.create`](/manual/api/reference/dashboard/create)。
[comment]: # ({/7148225f-f146ed91})
[comment]: # ({a1691adf-3e0437fc})
#### 配置*监控项卡片*小部件
配置一个显示以下部分的*监控项卡片*小部件：“描述”、“最新数据”、“触发器”和“标签”。
[请求](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "itemcard",
"name": "Item card",
"x": 0,
"y": 0,
"width": 14,
"height": 7,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid.0",
"value": 42257
},
{
"type": 0,
"name": "sections.0",
"value": 0
},
{
"type": 0,
"name": "sections.1",
"value": 3
},
{
"type": 0,
"name": "sections.2",
"value": 5
},
{
"type": 0,
"name": "sections.3",
"value": 9
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
```
响应：
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/a1691adf-3e0437fc})
[comment]: # ({e9d30322-25bd508b})
### 另请参见
- [仪表板小部件字段](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-25bd508b})