处理器：通用图形收集器

图形上的一个或多个查询指定为字符串，或此类查询的列表。（字符串将在将来的版本中弃用。多个查询应提供表达式字段引用的所有命名节点（包括additional_properties）。图形查询在“操作”图形上执行。可以使用具有相应索引的“query_result”变量访问查询结果。例如，如果查询名称为“ps”的属性集节点，则结果将显示为“query_result[0][”ps“]”。

在收集器处理器 （*_collector， ） if_counter中，它用于选择一组节点进行进一步处理（例如，所有叶设备，或叶设备和主干设备之间的所有接口）

在其他处理器中，它用于常规参数化，并且仅支持作为查询列表。

graph_query: "node("system", role="leaf", name="system").
              out("hosted_interfaces").
              node("interface", name="iface").out("link").
              node("link", role="spine_leaf")"

graph_query: ["node("system", role="leaf", name="system")",
              "node("system", role="spine", name="system")"]

图形查询中使用的节点和关系名称的（字符串）列表，用于对查询结果进行分组。此列表中的每个元素表示字段中的一个命名节点或关系匹配器 graph_query 。它不是与分组处理器中的现有 group_by 字段一致的表达式。非表达简单，更直观。

当分组处于活动状态（ 不为 null）query_group_by 时，查询结果按指定的名称列表 d 计算，其中每个组创建一个输出项。在这种情况下，表达式只能访问 中 query_group_by 指定的匹配器名称，并且使用新 group_items 变量访问每个组的查询结果。该 group_items 变量是查询结果的列表，其中每个结果都有命名的节点/关系，但不存在于 query_group_by中。

以下列表描述了此字段的各种值的行为：

• query_group_by字段的值 - 语义
• 省略或作为 json null 提供（在 Python 中为 ala None ） - 不进行分组。这等同于extensible_data_collector的当前行为。在这种情况下，不允许使用“group_items”，否则会导致探测错误状态。
• 空列表 （[]） - 生成一个包含所有查询结果的组。
• 一个或多个匹配器名称 - 查询结果按指定的节点或关系分组。如果此列表涵盖查询中的所有可用匹配器，则组数等于查询结果数。

离散状态值到人类可读字符串的映射。具有所有可能的离散状态集状态映射到人类可读表示的字典;仅适用于离散状态集数据（即当data_type为“dss”时）。

{
    "0": "unknown",
    "1": "down",
    "2": "up",
    "3": "missing"
}

每个额外的键/值对都用于扩展输出阶段的属性，其中值被视为在图形查询上下文中执行的表达式，其结果用作具有相应键的属性值。将为每个项目评估此属性的值，以便将项目与相应收集器服务提供的衡量指标相关联。关联由键完成，因为每个收集器报告一组指标，其中每个指标由键标识，格式特定于每个收集器。