创建 IBM Cloud Logs 水平条形窗口小部件

您可以创建一个水平条形图，该图可包含在自定义 IBM® Cloud Logs 仪表板中。

使用水平条形图部件按值对数据进行排序，默认为降序。 使用 垂直条形图 时，数据通常按列名的字母顺序排序。

水平条形图 widget 包含阈值，当达到或执行特定值时，可以更改可视化效果。 根据特定参数提取数据集时，会创建一个多横条，其中每个横条代表一个数据子集。 这样就能同时比较不同类别或组别，提供更广泛的视野。

第 1 步：输入名称和说明

完成以下步骤：

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

  2. 用 Widget 的名称替换“新水平条形图”。

  3. 输入描述。

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

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

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

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

完成以下步骤：

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

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

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

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

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

  3. 输入查询。

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

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

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

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

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

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

  5. 添加一个功能。

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

    数据类型为日志时，建立查询时的聚合选项
    聚集 描述
    计数 选定时间范围内的日志总数。
    对相异值计数 选定时间范围内唯一日志的数量。
    和 选定时间范围内所有日志的总和。
    最小值 所选时间范围内日志的最小值。
    最大值 所选时间范围内日志的最大值。
    平均 选定时间范围内所有日志的平均值。

    在条形图中，更改聚集类型将更改您看到的数据类型。

    对于数据类型为 Metrics 的查询，请选择一个函数。

第 3 步：配置小工具

完成以下步骤：

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

  2. 选择 Y 轴视图的 条形图设置选项，配置显示的是数值还是类别。 有效选项为：Value 和 Category。

  3. 选择图例管理选项。 日志的有效值为 Group, Stack，和 Aggregation 。 度量标准的有效值为：Group 和 Stack

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

    堆叠显示多个数据项在同一水平条上的分组和分层情况。 同一堆栈的数据集被组合成一个横向条形图，分成若干段。 这会在图表上显示第二层数据。

    聚合通过将多个数据值合并为一个汇总值来显示价值，然后再将其显示在图表或图例中。

图例颜色方案：选择图例颜色是按组、堆栈还是汇总。 默认情况下，水平条形图采用聚合方式，这意味着所有条形图都将显示一种颜色。

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

    最大条形图根据您的查询显示单个图表视图中单个条形的最大数量。

    每个条形图的最大片段数显示单个条形图内的最大片段数。

    启用 最大条形图、每条最大切片数 或两者，以显示指定范围内的单个值。

  2. 配置刻度部分。

    刻度是指如何沿 x 轴和 y 轴显示数值。 您可以选择线性或对数作为数值。

    选择刻度类型。 有效选项有：linear，定义数值按比例增加的方式； logarithmic，用对数而不是相等的线性间隔来定义数值。

    您可以更改阈值的颜色。

    默认情况下，设置为线性。 但是，如果不同数值之间的差异较大，则可以用对数刻度来代替。 例如，如果大部分数值都在 1k 以下，而其中一个数值是 10k，那么使用对数刻度会比线性刻度更容易显示条形图。

第 4 步：保存小部件

完成以下步骤：

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

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

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

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

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

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