创建 IBM Cloud Logs 标尺窗口小部件

您可以创建一个可包含在自定义 IBM® Cloud Logs 仪表板中的仪表部件。

使用仪表部件显示指定范围内的单个数值，通常类似于速度计或刻度盘。 它通常用于表示关键指标和性能指标，一目了然。

仪表包含阈值，当达到或超过特定值时，可以更改可视化的外观。 按特定参数对数据集进行分组时，就会创建一个多仪表盘，其中每个仪表盘代表一个数据子集。 这样就能同时比较不同类别或组别，提供更广泛的绩效视角。

第 1 步：输入名称和说明

完成以下步骤：

  1. 在 定制仪表板 中，单击 添加窗口小部件 "添加窗口小部件" 图标，然后从侧边栏拖放 标尺 窗口小部件。

  2. 用 Widget 的名称代替 New gauge。

  3. 输入描述。

    单击操作图标 操作 图标。 然后，选择添加说明。

  4. 定义图例值的显示位置。 有效值为 Side, Bottom, Auto，和 Hide。

    单击操作图标 操作 图标。 然后，选择 Leggend 设置。

第 2 步：配置查询以定义数据集

完成以下步骤：

  1. 单击操作图标 操作 图标。 然后，选择编辑模式。

  2. Query 1，请完成以下步骤：

    选择数据类型。 有效值为 Logs, Metrics，和 DataPrime。

    选择信号源。 有效选项为：Priority Insights 和 Analyze and Alert。

    您可以重新命名查询。 选择操作图标，然后单击重命名查询。

  3. 输入查询。

    当数据类型为 DataPrime 时，在查询字段中输入 Dataprime 查询。

    当数据类型为 Logs 时，在查询字段中输入 Lucene 查询。 您可以应用筛选器和汇总。

    当数据类型为 Metrics 时，在查询字段中指定度量或所需的 PromQL。 您可以应用筛选器和汇总。

  4. [可选]为 widget 添加一个或多个特定筛选器，以缩小仪表中显示数据的范围。

    选择一个标签及其相应的值。

    过滤器应用于部件级别，与仪表盘过滤器一起工作。 如果出现冲突，仪表盘筛选器优先于部件筛选器。

  5. 添加一个功能。

    对于数据类型为 Logs 的查询，可以使用以下函数之一显示汇总值：

    数据类型为日志时，建立查询时的聚合选项
    聚集 描述
    计数 选定时间范围内的日志总数。
    对相异值计数 选定时间范围内唯一日志的数量。
    和 选定时间范围内所有日志的总和。
    最小值 所选时间范围内日志的最小值。
    最大值 所选时间范围内日志的最大值。
    平均 选定时间范围内所有日志的平均值。
    百分位数 XX 表示 XX% 的原木低于该值。 例如，Percentile 95 是指 95% 的日志都低于这个值。

    对于数据类型为 Metrics 的查询，可以使用以下函数之一显示计算值：

    数据类型为 度量
    计算 描述
    即时 当前时间点的值。
    最后 所选时间范围内的最新值。
    最小值 所选时间范围内的最小值。
    最大值 所选时间范围内的最大值。
    平均值 选定时间范围内所有数据点的平均值。
    和 选定时间范围内所有数据点的总和。
    无 不进行计算。 使用原始数据。

  6. 在 “按分组” 中添加 1 个或多个字段，以生成多个仪表。

第 3 步：配置小工具

完成以下步骤：

  1. 单击操作图标 操作 图标。 然后，选择编辑模式。

  2. 选择图例管理选项。 有效值为：Group 和 Threshold。

    分组根据不同的数据实体（如服务器或应用程序）组织图例，将每个实体显示为单独的条目。

    阈值根据预定义的限制（如正常、警告、危急）对数值进行分类，有助于直观地显示某个指标是在可接受的范围内还是已进入警告状态。

  3. 在“可视化管理”部分，选择您想要的数据可视化方式。

    内弧显示查询的实际值。

    外弧线显示您定义的阈值。

    启用内弧、外弧或两者，以显示指定范围内的单一数值，通常类似于速度计或刻度盘。

    如果禁用内弧线和外弧线，查询的数值结果将显示为 STAT widget，而不会出现其他可视化效果。 在这种情况下，您可以决定将阈值颜色应用于数值还是背景。 在这部分配置中，您可以设置所需的阈值颜色选项。 您可以选择“**值 **”来设置值的阈值颜色，也可以设置“背景”，用阈值颜色设置背景。

  4. 配置阈值部分。

    阈值是您设置的一个值，当达到或超过该值时，就会根据查询结果改变可视化的外观。 您可以选择百分比或绝对数字作为数值。

    选择阈值类型。 有效选项包括：absolute，用于将特定数字定义为值； percentage，用于定义相对于最小值或最大值的值。

    您可以更改阈值的颜色。

    您可以设置阈值的值，并添加描述阈值的标签。

    您可以添加其他阈值。

第 4 步：保存小部件

完成以下步骤：

  1. [可选]如果想使用与仪表盘所选时间范围不同的时间，请设置 widget 的仪表盘时间。

  2. 单击“**保存 **”保存您的 widget。

  3. [可选]分享小工具的直接链接。 单击操作图标 操作 图标。 然后，选择共享小部件 URL，并复制 URL。

    任何可以访问仪表板的人都可以打开共享链接，查看 widget 的上下文。

    共享 widget URL 始终反映仪表板最后保存的版本。 如果您对小工具或布局进行了更改，请在共享前保存仪表板。

  4. [可选]添加自定义操作。 有关更多信息，请参阅 使用操作与第三方服务集成。