1.2. 创建搜索可配置的集合


通过为每个要自定义搜索收集资源的托管集群创建search-collector-config配置映射,定义从集群收集哪些 Kubernetes 资源。

需要的访问权限:集群管理员

将配置图放置在部署搜索插件的同一命名空间中。默认命名空间是open-cluster-management-agent-addon

完成以下步骤:

  1. 运行以下命令来创建search-collector-config配置映射:

    oc apply -f <your-search-collector-config>.yaml
    Copy to Clipboard Toggle word wrap
  2. 列出配置映射中的允许列表( data.AllowedResources )和拒绝列表( data.DeniedResources )部分中的资源。您的配置映射可能类似以下 YAML 文件:

    apiVersion: v1
    kind: ConfigMap
    metadata:
     name: search-collector-config
     namespace: <namespace where search-collector add-on is deployed>
    data:
     AllowedResources: |- 
    1
    
       - apiGroups:
           - "*"
         resources:
           - services
           - pods
       - apiGroups:
           - admission.k8s.io
           - authentication.k8s.io
         resources:
           - "*"
     DeniedResources: |- 
    2
    
       - apiGroups:
           - "*"
         resources:
           - secrets
       - apiGroups:
           - admission.k8s.io
         resources:
           - policies
           - iampolicies
           - certificatepolicies
    Copy to Clipboard Toggle word wrap
    1
    以上 ConfigMap 示例允许从所有 apiGroups 收集服务pod,同时允许从 admission.k8s.ioauthentication.k8s.io apiGroups 收集所有资源。
    2
    同时,ConfigMap 示例还阻止所有 apiGroupssecret 集合,同时防止来自 apiGroup admission.k8s.iopolicies, iampolicies, and certificatepolicies 的集合。

    注:如果您不提供 ConfigMap,则默认收集所有资源。如果您只提供 AllowedResources,则 AllowedResources 中未列出的所有资源都会被自动排除。同时 AllowedResourcesDeniedResources 中列出的资源也会被排除。

1.2.1. 自定义搜索控制台

自定义您的搜索结果和限制。完成以下任务来执行定制:

  1. 您可以从 OpenShift Container Platform 控制台自定义搜索结果限制。

    1. 更新 multicluster-engine 命名空间中的 console-mce-config。这些设置适用于所有用户,并可能会影响性能。查看以下性能参数描述:

      • SAVED_SEARCH_LIMIT - 每个用户保存的搜索的最大数量。默认情况下,每个用户可以保存的搜索数量被限制为 10 个。默认值为 10。要更新限制,请在 console-config ConfigMap 中添加以下键值:SAVED_SEARCH_LIMIT: x.
      • SEARCH_RESULT_LIMIT - 控制台中显示的最大搜索结果量。默认值为 1000。要删除此限制,请将设为 -1
      • SEARCH_AUTOCOMPLETE_LIMIT - 为搜索栏 typeahead 检索的最大建议数。默认值为 10,000。要删除此限制,请将设为 -1
    2. 从 OpenShift Container Platform 控制台运行以下 patch 命令,将搜索结果改为 100 个项目:
    oc patch configmap console-mce-config -n multicluster-engine --type merge -p '{"data":{"SEARCH_RESULT_LIMIT":"100"}}'
    Copy to Clipboard Toggle word wrap
  2. 要添加、编辑或删除建议的搜索,请创建一个名为console-search-config的配置映射并配置recommendedSearches部分。列出的建议搜索也会显示在控制台中。每个搜索对象都需要有一个id、name 和 searchText 。查看以下配置图示例:

    kind: ConfigMap
    apiVersion: v1
    metadata:
      name: console-search-config
      namespace: <acm-namespace> 
    1
    
    data:
      suggestedSearches: |-
        [
          {
            "id": "search.suggested.workloads.name",
            "name": "Workloads",
            "description": "Show workloads running on your fleet",
            "searchText": "kind:DaemonSet,Deployment,Job,StatefulSet,ReplicaSet"
          },
          {
            "id": "search.suggested.unhealthy.name",
            "name": "Unhealthy pods",
            "description": "Show pods with unhealthy status",
            "searchText": "kind:Pod status:Pending,Error,Failed,Terminating,ImagePullBackOff,CrashLoopBackOff,RunContainerError,ContainerCreating"
          },
          {
            "id": "search.suggested.createdLastHour.name",
            "name": "Created last hour",
            "description": "Show resources created within the last hour",
            "searchText": "created:hour"
          },
          {
            "id": "search.suggested.virtualmachines.name",
            "name": "Virtual Machines",
            "description": "Show virtual machine resources",
            "searchText": "kind:VirtualMachine"
          }
        ]
    Copy to Clipboard Toggle word wrap
    1
    添加启用搜索的命名空间。

1.2.2. 在控制台中查询

您可以在 搜索框中 输入任何文字,结果会包括带有这个值的任何属性(如名称或命名空间)。不支持包含空格的查询。

需要的访问权限:集群管理员

如需更具体的搜索结果,请在搜索中包含属性。您可以组合属性的相关值以获取更精确的搜索范围。例如,搜索 cluster:dev red 以接收与 dev 集群中字符串"red" 匹配的结果。

完成以下步骤,使用搜索进行查询:

  1. 在导航菜单中点击 Search
  2. 搜索框中输入要搜索的内容,搜索功能会查找包含该值的资源。

    • 当搜索资源时,会收到与原始搜索结果关联的其他资源。这可帮助您了解这些资源如何与系统中的其他资源进行交互。
    • 搜索返回并列出带有搜索资源的集群。对于 hub 集群中的资源,集群名称会显示为 local-cluster
    • 您的搜索结果按 kind 分组,每个资源 kind 在一个表格中分组。
    • 您的搜索选项依赖于集群对象。
    • 您可以使用特定标签重新定义结果。在查询标签时,搜索是区分大小写的。请参见以下示例,您可以选择过滤:名称命名空间状态 和其他资源字段。Auto-complete 提供了重新定义搜索的建议。请参见以下示例:
    • 搜索单个字段,如 kind:pod 以查找所有 pod 资源。
    • 搜索多个字段,如 kind:pod namespace:default 以在默认命名空间中查找 pod。

      备注:

      • 当使用多个属性值进行搜索时,会返回满足任何一个搜索值的结果。请参见以下示例:
      • 例如,当搜索 kind:pod name:a 时,任何名为 a 的 pod 都会被返回。
      • 当搜索 kind:pod name:a,b 时,任何名为 ab 的 pod 都会被返回。
      • 搜索 kind:pod status:!Running 以查找所有状态不是 Running 的 pod 资源。
      • 搜索 kind:pod restarts:>1 以查找重启至少两次的所有 pod。
  3. 如果要保存搜索,请点击 Save search 图标。
  4. 要下载搜索结果,请选择“导出为 CSV”按钮。
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat