4.5. 使用 Insights Operator

流程

1. 进入 Workloads ConfigMaps 并选择 Project: openshift-insights。
2. 点 Create ConfigMap。

3. 选择 Configure via: YAML view 并输入您的配置首选项，例如

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: insights-config
     namespace: openshift-insights
   data:
     config.yaml: |
       dataReporting:
         obfuscation:
           - networking
           - workload_names
       sca:
         disabled: false
         interval: 2h
       alerting:
          disabled: false
   binaryData: {}
   immutable: false

   Copy to Clipboard Toggle word wrap
4. 可选： 选择 Form view 并输入所需信息。
5. 在 ConfigMap Name 字段中输入 insights-config。
6. 在 Key 字段中，输入 config.yaml。
7. 对于 Value 字段，可以浏览文件以拖放到字段，或者手动输入您的配置参数。
8. 点 Create，您可以看到 ConfigMap 对象和配置信息。

流程

1. 进入 Workloads ConfigMaps 并选择 Project: openshift-insights。
2. 点 insights-config ConfigMap 对象打开它。
3. 点 Actions 并选择 Edit ConfigMap。
4. 点 YAML 视图 单选按钮。

5. 在 文件中，将 alerting 属性设置为 disabled: true。

   apiVersion: v1
   kind: ConfigMap
   # ...
   data:
     config.yaml: |
       alerting:
         disabled: true
   # ...

   Copy to Clipboard Toggle word wrap
6. 点击 Save。insights-config config-map 详情页面将打开。
7. 验证 config.yaml alerting 属性的值是否已设置为 disabled: true。

流程

1. 进入 Workloads ConfigMaps 并选择 Project: openshift-insights。
2. 点 insights-config ConfigMap 对象打开它。
3. 点 Actions 并选择 Edit ConfigMap。
4. 点 YAML 视图 单选按钮。

5. 在文件中，将 alerting 属性设置为 disabled: false。

   apiVersion: v1
   kind: ConfigMap
   # ...
   data:
     config.yaml: |
       alerting:
         disabled: false
   # ...

   Copy to Clipboard Toggle word wrap
6. 点击 Save。insights-config config-map 详情页面将打开。
7. 验证 config.yaml alerting 属性的值是否已设置为 disabled: false。

流程

1. 在归档中，打开 /insights-operator/gathers.json。

   文件包含 Insights Operator 收集操作列表：

       {
         "name": "clusterconfig/authentication",
         "duration_in_ms": 730, 

   1

   
         "records_count": 1,
         "errors": null,
         "panic": null
       }

   Copy to Clipboard Toggle word wrap

   1

   duration_in_ms 是每个收集操作的时间（毫秒）。

2. 检查每个收集操作是否有异常情况。

流程

1. 在控制台中，选择 Administration > CustomResourceDefinitions。
2. 在 CustomResourceDefinitions 页上，在 Search by name 字段中查找 DataGather 资源定义，然后点它。
3. 在 CustomResourceDefinition 详情页面，点 Instances 选项卡。
4. 点 Create DataGather。

5. 要创建新的 DataGather 操作，所有收集操作都将运行，请完成以下 YAML 规格，然后保存您的更改。

   apiVersion: insights.openshift.io/v1alpha2
   kind: DataGather
   metadata:
     name: <your_data_gather>
   spec:
   # Gatherers configuration
     gatherers:
       mode: All # Options: All, Custom
   # ...

   Copy to Clipboard Toggle word wrap
   重要
   • 您为收集操作指定的名称 < your_data_gather& gt; 必须是唯一的，且不得包含 periodic-gathering- 前缀，因为此字符串是为其他管理操作保留的，并可能会影响预期的收集操作。
   • 如果 DataGather CRD 的 spec 未定义，则默认的 Insights Operator 数据收集作业将运行。这意味着，所有收集操作都将运行，收集的数据将不会被模糊处理，且不会保留存档文件。

6. 可选： 要自定义数据收集操作，您可以在 DataGather YAML 文件中配置任何以下选项：

   • 要禁用特定的收集者，将 mode 的值改为 Custom，然后指定要禁用的独立收集器。例如，要禁用工作负载收集程序，请添加以下示例：

     apiVersion: insights.openshift.io/v1alpha2
     kind: DataGather
     metadata:
       name: <your_data_gather>
     spec:
         # Gatherers configuration
       gatherers:
         mode: Custom  # Options: All, Custom
         custom:
           configs:
             # Essential cluster configuration gatherers
             - name: clusterconfig/authentication
               state: Enabled
             - name: clusterconfig/clusteroperators
               state: Enabled
             - name: workloads
               state: Disabled

     Copy to Clipboard Toggle word wrap

   • 要启用持久性存储来保留最后 10 个数据收集作业的数据存档文件和历史记录，请定义 存储 规格。将 type 设置为 PersistentVolume，并定义卷的 mountPath 和名称，如下例所示：

     apiVersion: insights.openshift.io/v1alpha2
     kind: DataGather
     metadata:
       name: <your_data_gather>
     spec:
       storage:
         type: PersistentVolume
         mountPath: /data
         persistentVolume:
           claim:
             name: on-demand-gather-pvc

     Copy to Clipboard Toggle word wrap
     重要

     确保指定的卷名称与 openshift-insights 命名空间中的现有 PersistentVolumeClaim 值匹配。如需更多信息，请参阅 持久性卷声明。

   • 要启用数据模糊处理，请定义 dataPolicy 键和所需值。例如，要模糊处理 IP 地址和工作负载名称，请添加以下配置：

     apiVersion: insights.openshift.io/v1alpha2
     kind: DataGather
     metadata:
       name: <your_data_gather>
     spec:
       dataPolicy:
         - ObfuscateNetworking
         - WorkloadNames

     Copy to Clipboard Toggle word wrap

验证

1. 在控制台中，选择 Workloads > Pods。
2. 在 Pods 页上，进入 Project 下拉菜单，然后选择 Show default projects。
3. 从 Project 下拉菜单中选择 openshift-insights 项目。
4. 检查您的新收集操作是否已带有您在 openshift-insights 项目中的 pod 列表下选择的名称作为前缀。完成后，Insights Operator 会自动将数据上传到红帽进行处理。

流程

1. 使用以下 DataGather 规格创建 YAML 文件：

   apiVersion: insights.openshift.io/v1alpha2
   kind: DataGather
   metadata:
     name: <your_data_gather>
   spec:
   # Gatherers configuration
     gatherers:
       mode: All # Options: All, Custom
   # ...

   Copy to Clipboard Toggle word wrap
   重要
   • 您为收集操作指定的名称 < your_data_gather& gt; 必须是唯一的，且不得包含 periodic-gathering- 前缀，因为此字符串是为其他管理操作保留的，并可能会影响预期的收集操作。
   • 如果 DataGather CRD 的 spec 未定义，则默认的 Insights Operator 数据收集作业将运行。这意味着，所有收集操作都将运行，收集的数据将不会被模糊处理，且不会保留存档文件。

2. 可选： 要自定义数据收集操作，您可以在 DataGather YAML 文件中配置任何以下选项：

   • 要禁用特定的收集者，将 mode 的值改为 Custom，然后指定要禁用的独立收集器。例如，要禁用工作负载收集程序，请添加以下示例：

     apiVersion: insights.openshift.io/v1alpha2
     kind: DataGather
     metadata:
       name: <your_data_gather>
     spec:
         # Gatherers configuration
       gatherers:
         mode: Custom  # Options: All, Custom
         custom:
           configs:
             # Essential cluster configuration gatherers
             - name: clusterconfig/authentication
               state: Enabled
             - name: clusterconfig/clusteroperators
               state: Enabled
             - name: workloads
               state: Disabled

     Copy to Clipboard Toggle word wrap

   • 要启用持久性存储来保留最后 10 个数据收集作业的数据存档文件和历史记录，请定义 存储 规格。将 type 设置为 PersistentVolume，并定义卷的 mountPath 和名称，如下例所示：

     apiVersion: insights.openshift.io/v1alpha2
     kind: DataGather
     metadata:
       name: <your_data_gather>
     spec:
       storage:
         type: PersistentVolume
         mountPath: /data
         persistentVolume:
           claim:
             name: on-demand-gather-pvc

     Copy to Clipboard Toggle word wrap
     重要

     确保指定的卷名称与 openshift-insights 命名空间中的现有 PersistentVolumeClaim 值匹配。如需更多信息，请参阅 持久性卷声明。

   • 要启用数据模糊处理，请定义 dataPolicy 键和所需值。例如，要模糊处理 IP 地址和工作负载名称，请添加以下配置：

     apiVersion: insights.openshift.io/v1alpha2
     kind: DataGather
     metadata:
       name: <your_data_gather>
     spec:
       dataPolicy:
         - ObfuscateNetworking
         - WorkloadNames

     Copy to Clipboard Toggle word wrap

3. 在 OpenShift Container Platform CLI 中，输入以下命令来运行收集操作：

   $ oc apply -f <your_data_gather_definition>.yaml

   Copy to Clipboard Toggle word wrap

流程

1. 导航到 Administration > CustomResourceDefinitions。
2. 在 CustomResourceDefinitions 页面上，使用 Search by name 字段来查找 InsightsDataGather 自定义资源定义(CRD)，然后点击 来打开。
3. 在 CustomResourceDefinition 详情页面，点 Instances 选项卡。
4. 点 cluster，然后点 YAML 选项卡。

5. 编辑 InsightsDataGather CRD，并完成以下步骤之一：

   • 要禁用所有收集操作和数据收集，请定义 收集器 规格，并将 模式设置为 None，如下例所示：

     apiVersion: insights.openshift.io/v1alpha2
     kind: InsightsDataGather
     metadata:
       name: cluster
     spec:
     # Gatherers configuration
       gatherers:
         mode: None # Options: All, None, Custom

     Copy to Clipboard Toggle word wrap

   • 要禁用单个收集操作，在 gatherers 下将模式设置为 Custom，然后指定要禁用的独立收集器。例如，要禁用工作负载收集程序，请定义以下规格：

     apiVersion: insights.openshift.io/v1alpha2
     kind: InsightsDataGather
     metadata:
       name: cluster
     spec:
         # Gatherers configuration
       gatherers:
         mode: Custom  # Options: All, None, Custom
         custom:
           configs:
             # Essential cluster configuration gatherers
             - name: clusterconfig/authentication
               state: Enabled
             - name: clusterconfig/clusteroperators
               state: Enabled
             - name: workloads
               state: Disabled

     Copy to Clipboard Toggle word wrap
6. 点击 Save。

流程

1. 导航到 Administration > CustomResourceDefinitions。
2. 在 CustomResourceDefinitions 页面上，使用 Search by name 字段来查找 InsightsDataGather 自定义资源定义(CRD)，然后点击 来打开。
3. 在 CustomResourceDefinition 详情页面，点 Instances 选项卡。
4. 点 cluster，然后点 YAML 选项卡。

5. 编辑 InsightsDataGather CRD，并完成以下步骤之一：

   • 要启用所有禁用收集操作，在 gatherers 规格中将模式设置为 All，如下例所示：

     apiVersion: insights.openshift.io/v1alpha2
     kind: InsightsDataGather
     metadata:
       name: cluster
     spec:
     # Gatherers configuration
       gatherers:
         mode: All # Options: All, None, Custom

     Copy to Clipboard Toggle word wrap

   • 要启用之前禁用的单个收集操作，请在 gatherers:custom:configs key 部分找到 gatherer 操作的名称，并将 状态更改为 Enabled。或者，在配置 规格下，删除您要启用的操作的 名称和状态 配置行。

     apiVersion: insights.openshift.io/v1alpha2
     kind: InsightsDataGather
     metadata:
       name: cluster
     spec:
         # Gatherers configuration
       gatherers:
         mode: Custom  # Options: All, None, Custom
         custom:
           configs:
             # Essential cluster configuration gatherers
             - name: clusterconfig/authentication
               state: Enabled
             - name: clusterconfig/clusteroperators
               state: Enabled
             - name: workloads
               state: Enabled

     Copy to Clipboard Toggle word wrap

6. 点击 Save。

   保存更改后，Insights Operator 收集配置将更新，受影响的收集操作启动。