创建定制窗口小部件

您可创建定制窗口小部件,在其中选择图表,设置数据定义以添加一个或多个数据源,选择监视参数以及设置窗口小部件级别过滤器。 您可以创建这种定制的窗口小部件并根据需求将其用于不同的仪表板。 您还可以将创建的窗口小部件保存为定制窗口小部件模板。 您还可以创建专用窗口小部件,例如,Web 窗口小部件、多图表窗口小部件和列出选中源和资源类型的所有实例的窗口小部件。

准备工作

  • 确保已添加要监视的数据源。

    有关连接器和数据源的更多信息,请参阅 配置连接器和源

  • 如果要监视除 Cloud APMMonitoringITMCloud Event ManagementTivoli® Netcool®/OMNIbus和 JDBC支持的数据源以外的数据源,那么必须确保创建这些数据源的手动数据定义。

    有关创建手动数据定义的更多信息,请参阅 创建手动数据定义

  • 确保已创建要为窗口小部件设置的定制过滤器。 缺省过滤器只能应用于 Cloud APMMonitoringITMCloud Event Management 数据源。

    有关创建定制过滤器的更多信息,请参阅 过滤器

  • 如果要创建窗口小部件以连续呈现应用程序的实时数据,那么必须使用 Real Time 连接器。 此外,必须仅使用折线图,并且在图表属性中,必须指定要在图表上显示的数据点数。 在折线图中只能添加一个手动数据定义并且只能定义一个序列。 因此,设置图表属性时必须在序列类型选项卡中选中定义手动序列选项。 如果选择定义动态序列选项,那么不会显示实时数据。 此外,不支持多个 Y 轴。 必须仅映射 X 轴上的时间戳记数据。 无法更改图表类型,也无法向窗口小部件添加窗口小部件级别过滤器或者分配仪表板级别过滤器。

    另外,请确保 Real Time Data Collector 已安装并且已启动并正在运行。

    有关更多信息,请参阅 重新启动实时数据收集器

  • 如果要为窗口小部件设置背景图像,请确保计算机上已具有图像。
  • 要创建专用窗口小部件 (例如多图表窗口小部件, Web 窗口小部件和窗口小部件) 以列出所选源和资源类型的所有实例,请参阅 专用窗口小部件

关于此任务

登录到 Dashboard Designer后,可以使用登录页面上的以下任何选项来创建定制窗口小部件或模板:

  • 单击 创建组件,然后在 " 创建组件 " 页面中单击 窗口小部件
  • 单击 展开 展开 图标以打开 Dashboard Designer的导航窗格,然后单击 定制 > 创建新窗口小部件
在窗口小部件创建过程中的任意时间点,针对折线图、面积图、饼图、圆环图和簇状或堆积条形图和柱形图,可将已选图表替换为属于相同类别中的其他图表类型。 例如,可将现有饼图替换为圆环图。 预定义的数据定义和图表属性不随图表类型的更改发生改变。
注意:
  • 预览包含多个图的窗口小部件时,无法更改图表类型。
  • 如果将其 X 轴数据绘制为时间序列数据,那么无法更改堆积柱形图的图表类型。
  • 如果计划在 X 轴上绘制时间序列数据,请确保在这两个图中都使用 "折线图" , "面积图" 或 "堆积柱形图"。
  • 如果要在工具提示上显示百分比值,请确保图 1 (缺省图) 的图表类型为堆积柱形图或堆积条形图。
根据图表类型,可使用多个连接器或使用多个手动数据定义将多个数据源添加到单个窗口小部件。
注: 如果要添加多个数据定义,请确保 X 轴上映射的数据或列具有相同的数据。
例如,通过设置辅助数据定义,可以将多个支持 JDBC 接口的 Cloud APMCloud Event ManagementITMMonitoringTivoli Netcool/OMNIbus和第三方数据源添加到单个窗口小部件。 同样,通过使用手动数据定义,可以向单个窗口小部件中添加多个 JDBC 支持的第三方查询、Cassandra 数据库查询、MongoDB 查询或 REST API 定制查询。
注: 单个窗口小部件不能包含辅助数据定义和手动数据定义。

只能将多个数据定义添加至面积图、折线图、条形图、柱状图、气泡图、复合式标尺图、雷达图和散点图。 对于所有其他图表,只能添加一个数据定义。

如果要将窗口小部件另存为模板,那么必须仅使用一个或多个 APMICAMITM 连接器来设置数据定义。 如果在窗口小部件中使用 JDBCOMNIbusCEM 连接器或保存的定制定义,那么无法将窗口小部件保存为定制窗口小部件模板。

程序

执行下列步骤可创建定制窗口小部件:

  1. Dashboard Designer的导航窗格中,单击 定制 > 创建新窗口小部件

    这样会打开 " 新建窗口小部件 " 页面。

  2. 单击显示在 新建窗口小部件窗口小部件描述窗口小部件标题 字段旁边的 编辑 编辑 图标,然后输入窗口小部件的名称,标题和描述。
    注: 仅支持字母数字字符,空格和下划线。
  3. 缺省情况下,已选中 网格线 复选框。
    如果不需要网格线视图,请取消选中该复选框。
  4. 在导航窗格中,单击 图表,展开图表类别,然后将图表拖动到窗口小部件区域。
    例如,展开比较,然后将“堆积条形图”图表从导航窗格拖到窗口小部件区域。

    有关各种图表类型的更多信息,请参阅 图表

    代替将图表拖到窗口小部件小程序,您可以拖动以下任何一个窗口小部件:
    • 将模板窗口小部件拖到窗口小部件区域并设置数据定义。 有关设置辅助数据定义的更多信息,请参阅 设置辅助数据定义
    • 拖动现有定制窗口小部件并进行修改。 有关修改定制窗口小部件的更多信息,请参阅 修改窗口小部件
    注: 如果要使用 Real Time 连接器,请选择折线图。
  5. 可选: 单击 设置过滤器设置过滤器 图标以选择缺省过滤器和定制窗口小部件级别过滤器。
    注意:
    • 要使窗口小部件级别过滤器正常工作,必须在设置辅助数据定义或手动数据定义时将度量值映射到过滤器。
      有关将度量值映射到过滤器或为查询或 REST API 方法添加案例的更多信息,请参阅下列主题:
    • 您最多可以选择五个过滤器。 此数目包含缺省和定制过滤器,包括条件过滤器或从属过滤器。
    • 选择子过滤器时,自动选择它的父过滤器。
    • 您还可以重新排列窗口小部件级别过滤器。 但是,父过滤器和子过滤器无法交换位置。 父过滤器始终在其子过滤器的前面。
    • 要更改子过滤器中的值,首先必须更改父过滤器中的值。 例如,PM 过滤器、SummarizationAggregation 是父过滤器 Interval 的子过滤器并且基于此父过滤器。 如果直接更改 Summarization 中的过滤器值而未首先更改父过滤器值,那么 Summarization 过滤器显示 None 值。
    • 您可以将 缺省 过滤器添加到仅包含 Cloud APMITMIBM Cloud Pak® for Multicloud Management - MonitoringCloud Event Management 数据源的窗口小部件。
    • 不能将过滤器添加到以流式方法传输实时数据的窗口小部件。

    有关缺省过滤器和定制过滤器以及创建定制过滤器的更多信息,请参阅 过滤器

    如果设置了窗口小部件级别过滤器,那么该窗口小部件将在 设置过滤器 设置过滤器 图标上显示复选标记。 否则,设置过滤器 图标不显示任何复选标记。
  6. 单击 设置数据定义 设置数据定义 图标以选择数据源及其监视元素。
    有关设置数据定义的更多信息,请参阅以下主题:
  7. 单击 设置属性 设置属性 图标以设置窗口小部件和图表属性。
    有关设置窗口小部件和图表属性的更多信息,请参阅下列主题:
  8. 可选: 要向窗口小部件添加背景图像,请完成以下步骤:
    1. 单击显示在窗口小部件右上角的 背景图像 背景图像 图标。
    2. 在“背景图像”弹出窗口中,单击添加背景图像,然后单击从文件中选择
    3. 浏览到计算机上的图像文件位置,选中此文件,然后单击打开
      注: 可以添加大小小于或等于 2 MB 的 PNG , JPEG , JPG 或 GIF 图像文件。

      所选图像将作为背景图像添加到窗口小部件中。 要替换此图像,请重复上述步骤并选择其他图像。 要删除图像,请单击无背景图像

  9. 要将窗口小部件另存为定制窗口小部件,请单击 保存,然后在 " 保存窗口小部件 " 窗口中完成以下步骤:
    1. 在 " 保存 AS " 窗格中,单击 窗口小部件
      注: 仅当您在窗口小部件中使用 APMICAMITM 连接器时,才会显示 " SAVE AS " 窗格。

      要将定制窗口小部件另存为定制模板,请参阅 将定制窗口小部件另存为模板

    2. 窗口小部件名称 字段中,输入窗口小部件的名称。
    3. 要将窗口小部件保存到现有类别,请单击 现有类别,从下拉列表中选择类别名称,然后单击 保存
    4. 要将窗口小部件保存到新类别,请单击 新建类别,输入类别名称,然后单击 保存
  10. 要使用其他名称保存窗口小部件,请单击 另存为 选项,然后在 " 另存为窗口小部件 " 窗口中输入所需的详细信息。
  11. 可选: 对于折线图,面积图,饼图,圆环图以及簇状或堆积条形图和柱形图,可以将所选图表替换为属于同一类别的另一个图表。 单击 更改图表类型 更改图表类型 图标,然后从可用选项中选择所需的图表类型。
    可在执行窗口小部件创建的任意步骤时更改图表类型。
    现有图表将替换为所选的图表类型,但不会对数据定义或图表属性进行任何更改。
    注: 不能将具有 X 轴数据的堆积柱形图的图表类型更改为时间序列数据。
  12. 保存窗口小部件后,要预览该窗口小部件,请单击 预览 预览 图标。

结果

新创建的定制窗口小部件和窗口小部件模板将列示在导航窗格中的最近创建的窗口小部件下。 每个窗口小部件会在其旁边显示图标。 图标指示该窗口小部件中使用的图表类型。 如果使用 Real Time 连接器,那么该窗口小部件将显示 实时图表 实时图表图标 图标。
所有窗口小部件页面显示每个定制窗口小部件的以下审计跟踪详细信息:
  • 定制窗口小部件名称
  • 定制窗口小部件类别
  • 将窗口小部件发送到的 Engine 实例的名称。
  • 首次创建定制窗口小部件的日期和时间,以及首次创建定制窗口小部件的用户的用户名。
  • 上次修改定制窗口小部件的日期和时间,以及上次修改窗口小部件的用户的用户名。 仅显示最新记录。

下一步

您可以完成下列任何任务:
  • 发布定制窗口小部件。

    有关更多信息,请参阅 发布定制窗口小部件

  • 在仪表板中使用定制窗口小部件或窗口小部件模板。

    有关更多信息,请参阅 创建仪表板