2.5. 管理搜索

使用 search 从集群中查询资源数据。

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

继续阅读以下主题：

2.5.1. 创建搜索可配置的集合
复制链接

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

将配置映射放在部署了搜索附加组件的同一命名空间中。默认命名空间是 open-cluster-management-agent-addon。

完成以下步骤：

运行以下命令来创建 search-collector-config 配置映射：
```
oc apply -f <your-search-collector-config>.yaml
```
```
oc apply -f <your-search-collector-config>.yaml
```
Copy to Clipboard Toggle word wrap

列出配置映射中 allow (data.AllowedResources)和 deny list (data.DeniedResources)部分中的资源。您的配置映射可能类似以下 YAML 文件：

apiVersion: v1
kind: ConfigMap
metadata:
 name: search-collector-config
 namespace: <namespace where search-collector add-on is deployed>
data:
 AllowedResources: |- 
   - apiGroups:
       - "*"
     resources:
       - services
       - pods
   - apiGroups:
       - admission.k8s.io
       - authentication.k8s.io
     resources:
       - "*"
 DeniedResources: |- 
   - apiGroups:
       - "*"
     resources:
       - secrets
   - apiGroups:
       - admission.k8s.io
     resources:
       - policies
       - iampolicies
       - certificatepolicies

apiVersion: v1
kind: ConfigMap
metadata:
 name: search-collector-config
 namespace: <namespace where search-collector add-on is deployed>
data:
 AllowedResources: |-


   - apiGroups:
       - "*"
     resources:
       - services
       - pods
   - apiGroups:
       - admission.k8s.io
       - authentication.k8s.io
     resources:
       - "*"
 DeniedResources: |-


   - apiGroups:
       - "*"
     resources:
       - secrets
   - apiGroups:
       - admission.k8s.io
     resources:
       - policies
       - iampolicies
       - certificatepolicies

Copy to Clipboard

Toggle word wrap

1: 前面的配置映射示例显示要从所有 apiGroups 收集的服务和 pod，同时允许从 admission.k8s.io 和 authentication.k8s.io apiGroups 收集所有资源。
2: 配置映射示例还可防止所有 apiGroups 的 secret 集中集合，同时防止 apiGroup admission.k8s.io 中的策略集合、iam policies 和 certificatepolicies。

注：如果没有提供配置映射，则会默认收集所有资源。如果您只提供 AllowedResources，则 AllowedResources 中未列出的所有资源都会被自动排除。同时 AllowedResources 和 DeniedResources 中列出的资源也会被排除。

2.5.2. 自定义搜索控制台
复制链接

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

从 OpenShift Container Platform 控制台自定义搜索结果限制。
1. 更新 multicluster-engine 命名空间中的 console-mce-config。这些设置适用于所有用户，并可能会影响性能。查看以下性能参数描述：
  - SAVED_SEARCH_LIMIT - 为每个用户保存的最大搜索量。默认情况下，每个用户可以保存的搜索数量被限制为 10 个。默认值为 10。要更新限制，请在 console-config 配置映射中添加以下键值： 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"}}'
```
```
oc patch configmap console-mce-config -n multicluster-engine --type merge -p '{"data":{"SEARCH_RESULT_LIMIT":"100"}}'
```
Copy to Clipboard Toggle word wrap

要添加、编辑或删除推荐的搜索，请创建一个名为 console-search-config 的配置映射，并配置 suggestedSearches 部分。建议的搜索也会从控制台显示。每个搜索对象都需要有一个 id、name 和 searchText。查看以下配置映射示例：

kind: ConfigMap
apiVersion: v1
metadata:
  name: console-search-config
  namespace: <acm-namespace> 
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"
      }
    ]

kind: ConfigMap
apiVersion: v1
metadata:
  name: console-search-config
  namespace: <acm-namespace>


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: 添加启用搜索的命名空间。

2.5.3. 在控制台中查询
复制链接

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

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

完成以下步骤，使用搜索进行查询：

在导航菜单中点击 Search。
在搜索框中输入要搜索的内容，搜索功能会查找包含该值的资源。
- 当搜索资源时，会收到与原始搜索结果关联的其他资源。这可帮助您了解这些资源如何与系统中的其他资源进行交互。
- 搜索返回并列出带有搜索资源的集群。对于 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 时，任何名为 a 或 b 的 pod 都会被返回。
  - 搜索 kind:pod status:!Running 以查找所有状态不是 Running 的 pod 资源。
  - 搜索 kind:pod restarts:>1 以查找重启至少两次的所有 pod。
如果要保存搜索，请点击 Save search 图标。
要下载您的搜索结果，请选择 Export as CSV 按钮。

2.5.4. 更新受管集群上的 klusterlet-addon-search 部署
复制链接

要从受管集群收集 Kubernetes 对象，klusterlet-addon-search pod 在启用了搜索的所有受管集群中运行。此部署在 open-cluster-management-agent-addon 命名空间中运行。具有大量资源的受管集群可能需要更多内存才能使 klusterlet-addon-search 部署正常工作。

受管集群中的 klusterlet-addon-search pod 的资源要求可在 Red Hat Advanced Cluster Management hub 集群的 ManagedClusterAddon 自定义资源中指定。每个带有受管集群名称的受管集群都有一个命名空间。完成以下步骤：

从与受管集群名称匹配的命名空间中编辑 ManagedClusterAddon 自定义资源。运行以下命令以更新 xyz 受管集群中的资源要求：
```
oc edit managedclusteraddon search-collector -n xyz
```
```
oc edit managedclusteraddon search-collector -n xyz
```
Copy to Clipboard Toggle word wrap

将资源要求作为注解附加。查看以下示例：

apiVersion: addon.open-cluster-management.io/v1alpha1
kind: ManagedClusterAddOn
metadata:
  annotations: addon.open-cluster-management.io/search_memory_limit: 2048Mi
  addon.open-cluster-management.io/search_memory_request: 512Mi

apiVersion: addon.open-cluster-management.io/v1alpha1
kind: ManagedClusterAddOn
metadata:
  annotations: addon.open-cluster-management.io/search_memory_limit: 2048Mi
  addon.open-cluster-management.io/search_memory_request: 512Mi

Copy to Clipboard

Toggle word wrap

该注解会覆盖受管集群上的资源要求，并使用新资源要求自动重启 pod。

注：您可以使用控制台中的 API Explorer 发现受管集群中定义的所有资源。或者，您可以运行以下命令来发现所有资源： oc api-resources

2.5.5. 其他资源
复制链接

如需了解更多详细信息，请参阅多集群全局 hub。
请参阅 Observing 环境简介。

2.5. 管理搜索

2.5.1. 创建搜索可配置的集合
复制链接

2.5.2. 自定义搜索控制台
复制链接

2.5.3. 在控制台中查询
复制链接

2.5.4. 更新受管集群上的 klusterlet-addon-search 部署
复制链接

2.5.5. 其他资源
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

2.5. 管理搜索

2.5.1. 创建搜索可配置的集合复制链接链接已复制到粘贴板!

2.5.2. 自定义搜索控制台复制链接链接已复制到粘贴板!

2.5.3. 在控制台中查询复制链接链接已复制到粘贴板!

2.5.4. 更新受管集群上的 klusterlet-addon-search 部署复制链接链接已复制到粘贴板!

2.5.5. 其他资源复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

2.5.1. 创建搜索可配置的集合
复制链接

2.5.2. 自定义搜索控制台
复制链接

2.5.3. 在控制台中查询
复制链接

2.5.4. 更新受管集群上的 klusterlet-addon-search 部署
复制链接

2.5.5. 其他资源
复制链接