# 设置AOM仪表盘过滤器（新版）
在新版AOM仪表盘中，每张统计图表实际对应一个查询和分析语句。通过添加过滤器，可以批量修改这些查询语句中的查询条件，从而根据指定条件对仪表盘中的所有统计图表进行过滤筛选。
AOM支持配置如下类型的过滤器：
- 数据源变量：支持用户为仪表盘切换数据源，仪表盘中的图表能跟随数据源而变化，便于按照数据源对统计图表进行过滤筛选。（数据源变量类型过滤器仅对日志数据源图表生效。）
- 自定义变量：支持用户设置静态输入或动态查询的变量值，替换到查询语句中，实现快捷批量修改查询条件，便于按照自定义变量对统计图表进行过滤筛选。
- 日志过滤器：通过输入搜索语句或指定的下拉选项值对仪表盘内的日志流图表数据进行过滤筛选。（日志过滤器类型的过滤器仅对日志数据源图表生效。）
 #### 配置数据源变量类型的过滤器
1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。
2. 在左侧导航栏中选择"仪表盘 \> 仪表盘"，单击页面右上角"体验新版"。
3. 单击仪表盘名称，进入仪表盘详情页面。
4. 单击仪表盘详情页面右上角![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002237503925.png)，进入"仪表盘设置"页面。
5. 单击"新建"，进入"新建变量和过滤器"页面，配置数据源变量类型的过滤器相关参数。 
   表1数据源变量类型过滤器参数说明 
   | 参数名称                                       || 说明                                                                            |
   |:---|---|:---|
   | 基本信息   | 名称    | 过滤器的名称。名称唯一，不能重复。最多可输入255个字符，只能包含数字、字母、下划线，且不能以下划线开头和结尾。                       |
   | 基本信息   | 别名    | 过滤器的别名（可选）。最多可输入255个字符，只能包含数字、字母、中文、下划线、中划线，且不能以下划线、中划线开头和结尾。设置过滤器别名后，优先显示别名。 |
   | 基本信息   | 描述     | 过滤器的描述（可选）。最多可输入1000个字符。                                                    |
   | 基本信息   | 类型    | 选择过滤器的类型。设置为"数据源变量"。支持用户切换仪表盘内图表的数据源。                                         |
   | 变量值设置 | 类型     | 当前仅支持"日志流"类型，即只对使用SQL分析日志数据，并进行可视化的日志数据源图表生效。                                   |
   | 变量值设置 | 日志组名称 | 选择默认数据源的日志组名称。                                                                |
   | 变量值设置 | 日志流名称   | 选择默认数据源的日志流名称。                                                                |
      
   
   
6. 以上信息配置完成后，单击下方"预览"，可预览配置的过滤器选项值信息。
7. 单击"确定"即可创建数据源变量类型的过滤器。 
   新建的过滤器在仪表盘详情页面和添加图表页面展示，单击过滤器，可以在过滤器搜索框中输入或下拉列表中选择查询条件，即可根据指定条件对仪表盘中的统计图表进行过滤筛选。
   
   
 
#### 配置自定义变量类型的过滤器
1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。
2. 在左侧导航栏中选择"仪表盘 \> 仪表盘"，单击页面右上角"体验新版"。
3. 单击仪表盘名称，进入仪表盘详情页面。
4. 单击仪表盘详情页面右上角![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002317163261.png)，进入"仪表盘设置"页面。
5. 单击"新建"，进入"新建变量和过滤器"页面，配置自定义变量类型的过滤器相关参数。 
   1. 参考下表配置自定义变量类型的过滤器基本信息。
      表2基本信息配置说明 
      | 参数名称 | 说明                                                                          |
      |:---|:---|
      | 名称   | 过滤器的名称。名称唯一，不能重复。最多可输入255个字符，只能包含数字、字母、下划线，且不能以下划线开头和结尾。                       |
      | 别名    | 过滤器的别名（可选）。最多可输入255个字符，只能包含数字、字母、中文、下划线、中划线，且不能以下划线、中划线开头和结尾。设置过滤器别名后，优先显示别名。 |
      | 描述     | 过滤器的描述（可选）。最多可输入1000个字符。                                                    |
      | 类型   | 选择过滤器的类型。设置为"自定义变量"。支持用户设置静态输入或动态查询的变量值，替换到查询语句中，实现快捷批量修改查询语句。                |
         
      
   
   2. 配置自定义变量类型过滤器的静态变量值。（可选，根据需要选择是否配置静态变量值。）
      1. 单击"静态变量值"区域的"添加静态变量值"。
      
      2. 参考下表配置静态变量参数。
         表3静态变量配置说明 
         | 参数名称 | 说明                                                                                                                                                                                                                                                                                                |
         |:---|:---|
         | 字段值   | 设置静态变量的字段值。最多可输入255个字符，只能包含数字、字母、下划线，且不能以下划线开头和结尾。                                                                                                                                                                                                                                                |
         | 字段值别名 | 设置静态变量的字段值别名（可选）。最多可输入64个字符，只能包含英文、数字、中文、中划线、下划线及小数点，且不能以小数点和下划线开头，或以小数点结尾。设置字段值别名后，优先显示别名。                                                                                                                                                                                                     |
         | 默认选中  | 是否自动选中该静态变量的字段值作为默认选项值（如果静态变量设置了字段值别名，则默认值选项值中优先显示别名。）： - 开启：过滤器的"默认值"选项中自动选择该静态变量的字段值作为默认值。  - 关闭：过滤器的"默认值"选项中不会自动选中该静态变量的字段值作为默认选项值。   |
            
         如果需要删除配置的静态变量参数，可在参数列表单击操作列的"删除"。
         
       
   
   3. 配置自定义变量类型过滤器的动态变量值。（可选，根据需要选择是否配置动态变量值。）
      1. 打开"动态变量值"开关。
      
      2. 配置动态变量来源：
         - Prometheus 实例：从Prometheus实例中查询动态变量值。
         
         - 日志流：从日志流中查询动态变量值。
          
      
      3. 配置动态变量参数。
         - 当动态变量来源配置为"Prometheus 实例"时，参考下表进行参数配置：
           表4动态变量配置说明（动态变量来源配置为"Prometheus 实例"） 
           | 参数名称       | 说明                                                                                                                                                                                                                       |
           |:---|:---|
           | Prometheus 实例 | 选择动态变量来源的Prometheus实例。默认为进入仪表盘详情页后左上角选择的Prometheus实例。此处置灰不可选。 如想变更Prometheus实例，可在仪表盘详情页面重新选择Prometheus实例。                                                                                 |
           | 查询方式        | 设置查询方式。当前仅支持按"指标匹配字段"进行查询。                                                                                                                                                                                                |
           | 指标名称       | 指标的名称，可选择所选Prometheus实例下的指标。                                                                                                                                                                                              |
           | 变量展示字段      | 选择指标某字段的值作为仪表盘过滤器下拉框中展示的选项值。 例如此处变量展示字段配置为"集群名称"，则仪表盘过滤器下拉框中展示的选项值为集群名称的值。                                                                                                               |
           | 变量值字段      | 选择某字段的值作为变量实际的值，进行过滤查询。 例如变量展示字段配置为"集群名称"，变量值字段配置为"集群ID"，那么当用户在仪表盘过滤器下拉框中选择集群名称的值时，会以该变量实际集群ID的值作为过滤条件，进行查询。                                                                             |
           | 过滤条件         | 配置维度名称与维度值。支持"="和"!="运算符。 可单击![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002237570825.png)，通过AND可为同一指标设置多个过滤条件。 当维度值引用其他过滤器的名称时，不支持预览。 |
           | 排序方式         | 配置仪表盘过滤器下拉框中展示选项值的排序方式。当前仅支持"不排序"。                                                                                                                                                                                       |
              
           
         
         - 当动态变量来源配置为"日志流"时，参考下表进行参数配置：
           表5动态变量配置说明（动态变量来源配置为"日志流"） 
           | 参数名称     | 说明                                                                                                    |
           |:---|:---|
           | 日志组      | 选择动态变量来源的日志组。                                                                                          |
           | 日志流      | 选择动态变量来源的日志流。如果所选日志流未配置结构化规则，请先[配置结构化](https://support.huaweicloud.com/usermanual-lts/lts_0821.html)。 |
           | 查询方式      | 支持"字段模糊匹配"和"SQL查询"两种查询方式。                                                                             |
           | 字段选择     | 查询方式设置为"字段模糊匹配"时，需要在"字段选择"中选择当前日志流中配置的结构化字段。                                                           |
           | SQL语句查询区 | 查询方式设置为"SQL查询"时，根据需要在SQL语句查询区域输入相关的查询语句，并单击"查询"，可预览动态列表项。仅支持管道符版本的SQL查询，默认语法为\* \| select \*。          |
              
           
          
       
   
   4. 配置自定义变量类型过滤器的其他信息：
      - 默认值：配置过滤器默认选项值。可选的选项值来自[2]和[3]中配置的静态或动态变量值。
      
      - 支持多选：过滤器选项值是否允许多选。默认开启，开启后，过滤器中可以选择多个选项值。
      
      - 包含全选：过滤器选项值是否包括"全选"。默认开启，开启后，过滤器中增加"全选"选项。
       
   
   5. 以上信息配置完成后，单击下方"预览"，可预览配置的过滤器选项值信息。
   
   
   
   
6. 单击"确定"即可创建自定义变量类型的过滤器。 
   新建的过滤器在仪表盘详情页面和添加图表页面展示，单击过滤器，可以在过滤器搜索框中输入或下拉列表中选择查询条件，即可根据指定条件对仪表盘中的统计图表进行过滤筛选。
   
   
 
#### 配置日志过滤器类型的过滤器
1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。
2. 在左侧导航栏中选择"仪表盘 \> 仪表盘"，单击页面右上角"体验新版"。
3. 单击仪表盘名称，进入仪表盘详情页面。
4. 单击仪表盘详情页面右上角![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002237503925.png)，进入"仪表盘设置"页面。
5. 单击"新建"，进入"新建变量和过滤器"页面，配置日志过滤器类型的过滤器相关参数。 
   1. 参考下表配置日志过滤器类型的过滤器基本信息。
      表6基本信息配置说明 
      | 参数名称 | 说明                                                                             |
      |:---|:---|
      | 名称 | 过滤器的名称。名称唯一，不能重复。最多可输入255个字符，只能包含数字、字母、下划线，且不能以下划线开头和结尾。                        |
      | 别名     | 过滤器的别名（可选）。最多可输入255个字符，只能包含数字、字母、中文、下划线、中划线，且不能以下划线、中划线开头和结尾。设置过滤器别名后，优先显示别名。 |
      | 描述  | 过滤器的描述（可选）。最多可输入1000个字符。                                                         |
      | 类型  | 选择过滤器的类型。设置为"日志过滤器"。通过输入搜索语句或通过选择指定字段的字段值，对仪表盘内的日志流图表数据进行过滤。                    |
         
      
   
   2. 配置过滤器相关信息。
      - 当过滤类型配置为"搜索语句过滤"时，参考下表进行参数配置：
        表7日志过滤器配置说明（过滤类型来源配置为"搜索语句过滤"） 
        | 参数名称    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                    |
        |:---|:---|
        | 过滤选项数据来源 | 支持以下两种数据来源： - 指定日志流：过滤选项数据来自指定的日志流。  - 数据源变量：过滤选项数据来自配置的数据源变量类型的过滤器。                                                                                                                                                                                                    |
        | 日志组名称    | 当"过滤选项数据来源"配置为"指定日志流"时，需要在"日志组名称"中选择数据来源的日志组名称。                                                                                                                                                                                                                                                                                                                                                                                         |
        | 日志流名称    | 当"过滤选项数据来源"配置为"指定日志流"时，需要在"日志流名称"中选择数据来源的日志流名称。如果所选日志流未配置结构化规则，请先[配置结构化](https://support.huaweicloud.com/usermanual-lts/lts_0821.html)。                                                                                                                                                                                                                                                                                                |
        | 数据源变量    | 当"过滤选项数据来源"配置为"数据源变量"时，需要在"数据源变量"中选择已配置的[数据源变量类型的过滤器]。                                                                                                                                                                                                                                                                                                                                              |
        | 输入模式      | 支持以下两种输入模式： - 交互模式：支持用户在过滤器中选择不同的字段进行关联，并将关联关系进行组合查询。 字段关联关系支持：包含(精确)、包含(模糊)、包含(短语)、不包含(精确)、不包含(模糊)、不包含(短语)、字段存在、字段不存在。 组合方式支持："且（AND）"和"或（OR）"两种方式，默认为"且"。   - 语句模式：支持用户在过滤器中直接输入查询语句。   |
        | 默认过滤       | 按照交互模式或语句模式配置默认过滤信息。当过滤选项数据来源配置为"指定日志流"时需要配置此项。                                                                                                                                                                                                                                                                                                                                                                                       |
           
        
      
      - 当过滤类型配置为"下拉选项过滤"时，参考下表进行参数配置：
        表8日志过滤器配置说明（过滤类型来源配置为"下拉选项过滤"） 
        | 参数名称   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
        |:---|:---|
        | 过滤选项数据来源 | 支持以下两种数据来源： - 指定日志流：过滤选项数据来自指定的日志流。  - 数据源变量：过滤选项数据来自配置的数据源变量类型的过滤器。                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
        | 日志组名称    | 当过滤选项数据来源配置为"指定日志流"时，需要在"日志组名称"中选择数据来源的日志组名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
        | 日志流名称  | 当过滤选项数据来源配置为"指定日志流"时，需要在"日志流名称"中选择数据来源的日志流名称。如果所选日志流未配置结构化规则，请先[配置结构化](https://support.huaweicloud.com/usermanual-lts/lts_0821.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
        | 过滤字段    | 选择要过滤的日志流字段。如果指定的过滤字段未配置字段索引，请先完成[索引配置](https://support.huaweicloud.com/usermanual-lts/lts_05_0008.html)，否则无法基于该字段做过滤。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
        | 静态选项    | 单击"静态选项"区域的"添加静态变量值"，配置静态变量信息： - 字段值：设置静态变量的字段值。最多可输入255个字符。  - 字段值别名：设置静态变量的字段值别名（可选）。最多可输入64个字符，只能包含英文、数字、中文、中划线、下划线及小数点，且不能以小数点和下划线开头，或以小数点结尾。设置字段值别名后，优先显示别名。  - 默认选中：是否自动选中该静态变量的字段值作为默认选项值（如果静态变量设置了字段值别名，则默认值选项值中优先显示别名。）： - 开启：过滤器的"默认值"选项中自动选择该静态变量的字段值作为默认值。  - 关闭：过滤器的"默认值"选项中不会自动选中该静态变量的字段值作为默认选项值。     |
        | 动态选项    | 打开"动态选项"开关，配置动态变量信息： - 查询方式：支持"字段模糊匹配"和"SQL查询"两种查询方式。  - 查询方式设置为"SQL查询"时，根据需要在SQL语句查询区域输入相关的查询语句，并单击"查询"，可预览动态列表项。仅支持管道符版本的SQL查询，默认语法为\* \| select \*。                                                                                                                                                                                                                                                                                                                                                                                              |
        | 默认值     | 配置过滤器默认选项值。可选的选项值来自配置的静态或动态变量值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
        | 支持多选   | 过滤器选项值是否允许多选。默认开启，开启后过滤器中可以选择多个选项值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
           
        
       
   
   
   
   
6. 以上信息配置完成后，单击"确定"即可创建日志过滤器类型的过滤器。 
   新建的过滤器在仪表盘详情页面和添加图表页面展示，单击过滤器，可以在过滤器搜索框中输入或下拉列表中选择查询条件，即可根据指定条件对仪表盘中的统计图表进行过滤筛选。
   
   
 
#### 更多操作
过滤器创建完成后，您还可以在"仪表盘设置"页面执行[表9]中的操作。
 表9更多操作 
| 操作名称                | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|
| 搜索过滤器              | 支持按过滤器的名称、别名、类型、描述进行搜索，可在过滤器列表上方的搜索框中输入或选择关键字，单击![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002202423878.png)后显示匹配对象。                                                                                                                                                                                                                                                                                                                                                                        |
| 编辑过滤器                 | 单击过滤器列表操作列的"修改"，修改过滤器信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 删除过滤器                | 单击过滤器列表操作列的"删除"，在弹框中单击"确定"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 通过过滤器名称填充仪表盘图表标题 | 新增过滤器后，在仪表盘[配置图表标题](https://support.huaweicloud.com/usermanual-aom2/mon_01_0209.html#mon_01_0209__table1325112581810)处用"${过滤器名称}"进行动态拼接填充（如果过滤器配置了别名，优先使用过滤器别名），即可基于该过滤器下拉列表值，动态展示图表标题。 例如：仪表盘配置的原图表标题为"Dashboard"，新增的过滤器名称为"ClusterName"，即可以在仪表盘图表标题处配置"${ClusterName} Dashboard"。然后在过滤器ClusterName中基于不同下拉选择值，将过滤器选项值填充到仪表盘图表标题中进行动态拼接，并展示过滤条件对应的图表信息。 ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002237503993.png "点击放大") |
   
