[comment]: # ({0a5b80a4-04251815}) # 1 仪表板小部件 [comment]: # ({/0a5b80a4-04251815}) [comment]: # ({d3c01555-6b9b82d5}) #### 概述 本节提供适用于 [dashboard](/manual/web_interface/frontend_sections/dashboards) 小组件的通用参数详情。 #### 通用参数 以下参数适用于每个小组件： | | | |--|--------| |*名称*|输入小组件名称。| |*刷新间隔*|配置默认刷新间隔。

小组件的默认刷新间隔范围从 *不刷新* 到 *15 分钟*，具体取决于小组件类型。例如：
- *URL* 小组件为 *不刷新*；
- *Action log* 小组件为 *1 分钟*；
- *Clock* 小组件为 *15 分钟*。

可以为所有用户设置默认刷新间隔。将 dashboard 切换到[编辑模式](/manual/web_interface/frontend_sections/dashboards#viewing-a-dashboard)，单击[编辑小组件](/manual/web_interface/frontend_sections/dashboards#editing-widgets)按钮，并从下拉列表中选择所需的刷新间隔。

每个用户也可以设置自己的小组件刷新间隔。在 dashboard [查看模式](/manual/web_interface/frontend_sections/dashboards#viewing-a-dashboard)下，单击小组件上的三点 ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/edit_button_widget_view.png) 按钮，并从下拉列表中选择所需的刷新间隔。请注意，用户的独立刷新间隔优先于小组件设置，即使修改了小组件设置，该用户的刷新间隔也会保留。| |*显示标题*|勾选此复选框可永久显示小组件标题。
未勾选时，为节省空间，标题会被隐藏，并且仅在鼠标悬停于小组件上时可见（在查看和编辑模式下均如此）。拖动小组件到新位置时，标题也会半透明显示。| #### 特定参数 要查看每个小组件的特定参数，请转到对应的小组件页面： - [Action log](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) - [Clock](/manual/web_interface/frontend_sections/dashboards/widgets/clock) - [Discovery status](/manual/web_interface/frontend_sections/dashboards/widgets/discovery_status) - [Favorite graphs](/manual/web_interface/frontend_sections/dashboards/widgets/favorite_graphs) - [Favorite maps](/manual/web_interface/frontend_sections/dashboards/widgets/favorite_maps) - [Gauge](/manual/web_interface/frontend_sections/dashboards/widgets/gauge) - [Geomap](/manual/web_interface/frontend_sections/dashboards/widgets/geomap) - [Graph](/manual/web_interface/frontend_sections/dashboards/widgets/graph) - [Graph (classic)](/manual/web_interface/frontend_sections/dashboards/widgets/graph_classic) - [Graph prototype](/manual/web_interface/frontend_sections/dashboards/widgets/graph_prototype) - [Honeycomb](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb) - [Host availability](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) - [Host card](/manual/web_interface/frontend_sections/dashboards/widgets/host_card) - [Host navigator](/manual/web_interface/frontend_sections/dashboards/widgets/host_navigator) - [Item card](/manual/web_interface/frontend_sections/dashboards/widgets/item_card) - [Item history](/manual/web_interface/frontend_sections/dashboards/widgets/item_history) - [Item navigator](/manual/web_interface/frontend_sections/dashboards/widgets/item_navigator) - [Item value](/manual/web_interface/frontend_sections/dashboards/widgets/item_value) - [Map](/manual/web_interface/frontend_sections/dashboards/widgets/map) - [Map navigation tree](/manual/web_interface/frontend_sections/dashboards/widgets/map_tree) - [Pie chart](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart) - [Problem hosts](/manual/web_interface/frontend_sections/dashboards/widgets/problem_hosts) - [Problems](/manual/web_interface/frontend_sections/dashboards/widgets/problems) - [Problems by severity](/manual/web_interface/frontend_sections/dashboards/widgets/problems_severity) - [SLA report](/manual/web_interface/frontend_sections/dashboards/widgets/sla_report) - [System information](/manual/web_interface/frontend_sections/dashboards/widgets/system) - [Top hosts](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts) - [Top items](/manual/web_interface/frontend_sections/dashboards/widgets/top_items) - [Top triggers](/manual/web_interface/frontend_sections/dashboards/widgets/top_triggers) - [Trigger overview](/manual/web_interface/frontend_sections/dashboards/widgets/trigger_overview) - [URL](/manual/web_interface/frontend_sections/dashboards/widgets/url) - [Web monitoring](/manual/web_interface/frontend_sections/dashboards/widgets/web_monitoring) [comment]: # ({/d3c01555-6b9b82d5}) [comment]: # ({94fea10c-73464aae}) #### 动态参数 多个小组件具有参数，使它们能够在其他小组件或仪表板之间共享配置数据。 [comment]: # ({/94fea10c-73464aae}) [comment]: # ({67ed434a-f5a45091}) ##### 主机组、主机、监控项、监控项列表 *Host groups*、*Hosts*、*Item* 和 *Item list* 参数允许选择相应实体，或选择包含主机组、主机或监控项的数据源，供小组件显示数据。 对于 *Host groups*、*Item* 和 *Item list* 参数，数据源可以是来自同一仪表板的兼容小组件。 对于 *Hosts* 参数，数据源可以是来自同一仪表板的兼容小组件，或者仪表板本身。 ::: noteclassic *Map* 小组件也可以向兼容小组件广播主机组和主机数据。 有关更多信息，请参见 [小组件行为](#widget-behavior)。 ::: [comment]: # ({/67ed434a-f5a45091}) [comment]: # ({12fe6969-321a9686}) ##### 覆盖主机 *Override host* 参数允许选择一个包含主机的数据源，widget 可以显示该主机的数据。 该数据源可以是同一仪表板中的兼容 widget，或者仪表板本身。 ![](../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/override_host.png){width="600"} - 要指定一个 [兼容 widget](#widget-compatibility)，请输入其名称并选择它。 或者，单击 *Select* 按钮（或下拉按钮，然后选择 "Widget"）以打开可用 widget 的弹出列表。 - 要指定仪表板，请单击下拉按钮，然后选择 "Dashboard"。 在保存仪表板后，*Host* 字段（用于选择主机）将显示在仪表板顶部。 ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dynamic_selection.png){width="600"} [comment]: # ({/12fe6969-321a9686}) [comment]: # ({76893c3d-e27baf62}) ##### 时间段 *时间段*参数允许选择包含组件可以显示数据的时间段的数据源。 数据源可以是来自同一仪表板的兼容组件、仪表板本身或组件本身上配置的时间段。 ![](../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/time_period.png) - 要指定[兼容组件](#widget-compatibility)，请将*时间段*设置为“组件”，输入其名称并选择它。 或者，单击*选择*按钮打开可用组件的弹出窗口。 - 要指定仪表板，请将*时间段*设置为“仪表板”。 [保存](/manual/web_interface/frontend_sections/dashboards#editing-a-dashboard) 仪表板后，[*时间段*选择器](/manual/web_interface/time_period_selector) 将出现在仪表板顶部。 - 要在组件本身上配置时间段，请将*时间段*设置为“自定义”，然后输入或选择时间段的开始和结束时间。 ::: noteclassic 无论组件的*时间段*配置如何，兼容的组件都可以将其用作时间段的数据源。 ::: [comment]: # ({/76893c3d-e27baf62}) [comment]: # ({bfa921ec-3ecd53f4}) ##### 小组件行为 不同小组件在向其他小组件**广播**数据的方式上有所不同。 所有能够广播数据的小组件在创建后都会自动开始广播。 例如，*Graph* 小组件会立即向正在监听的小组件广播时间段数据。 ![](../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widget_behavior_constant.png){width="600"} 支持实体选择的小组件（例如 *Item navigator*）会自动为第一个可用实体广播数据。 例如，*Item navigator* 小组件会为其监控项列表中的第一个监控项广播数据。 当选择其他监控项时，它会为该监控项广播数据。 鼠标悬停时，监控项会以浅蓝色高亮显示；选中时，会以黄色高亮显示。 ![](../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widget_behavior_selected_item.png){width="600"} *Map* 小组件也会自动为第一个可用元素（例如主机）广播数据，该元素是距离小组件视口左上角最近的元素（对于 *Geomap* 小组件，则是距离小组件视口中心最近的元素）。 当选择其他元素时，它会为该元素广播数据。 鼠标悬停时，元素会以浅蓝色高亮显示；选中时，会以深蓝色高亮显示。 ![](../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widget_behavior_selected_map.png){width="600"} 小组件在**监听**来自其他小组件的数据时也有特定行为： - 如果数据源小组件没有广播数据，监听小组件会进入 *Awaiting data* 状态。 - 如果数据源小组件已被删除、替换为不兼容的小组件，或移动到另一个仪表板页面，监听小组件会进入 *Referred widget is unavailable* 状态。 - 如果数据源（小组件或仪表板）中指定的主机缺少监听小组件中配置的实体（监控项、图形、地图等），或者用户没有访问该主机的权限，监听小组件会显示以下消息：*"No permissions to referred object or it does not exist!"* ![](../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widget_behavior_nodata.png) 有关每个小组件的广播和监听功能，请参见 [Widget compatibility](#widget-compatibility)。 [comment]: # ({/bfa921ec-3ecd53f4}) [comment]: # ({907db5df-6c9c6f9e}) ##### Widget 兼容性 某些 widget 可以向其他 widget 广播配置数据，某些可以监听数据，还有一些两者都可以。例如： - *Action log* widget 只能从 *Graph*、*Graph (classic)* 和 *Graph prototype* widget 获取时间段数据。 - *Geomap* widget 可以向监听主机数据的 widget 广播主机数据（*Honeycomb*、*Top items* 等），也可以监听来自广播主机组和主机数据的 widget（*Honeycomb*、*Problem hosts* 等）所发送的主机组和主机数据。 - *Clock* widget 不能广播或监听任何数据。 下表概述了每个 widget 的广播和监听能力。 |Widget|Broadcasts|Listens| |--|----|----| |*Action log*|-|时间段| |*Clock*|-|-| |*Discovery status*|-|-| |*Favorite graphs*|-|-| |*Favorite maps*|-|-| |*Gauge*|-|主机, 监控项| |*Geomap*|主机|主机组, 主机| |*Graph*|时间段|主机, 监控项, 时间段| |*Graph (classic)*|时间段|主机, 监控项, Graphs, 时间段| |*Graph prototype*|时间段|主机, 时间段| |*Honeycomb*|主机, 监控项|主机组, 主机| |*Host availability*|-|主机组| |*Host card*|-|主机| |*Host navigator*|主机|主机组| |*Item card*|-|主机, 监控项, 时间段| |*Item history*|监控项|主机, 时间段| |*Item navigator*|监控项|主机组, 主机| |*Item value*|-|主机, 监控项, 时间段| |*Map*|主机组, 主机|Maps| |*Map navigation tree*|Maps|-| |*Pie chart*|-|监控项, 时间段| |*Problem hosts*|主机组|主机组, 主机| |*Problems*|Events|主机组, 主机| |*Problems by severity*|主机组|主机组, 主机| |*SLA report*|-|-| |*System information*|-|-| |*Top hosts*|主机|主机组, 主机| |*Top items*|-|主机组, 主机| |*Top triggers*|-|时间段| |*Trigger overview*|-|主机组, 主机| |*URL*|-|主机| |*Web monitoring*|主机组|主机组, 主机| [comment]: # ({/907db5df-6c9c6f9e})