홈
제품
Red Hat Advanced Cluster Management for Kubernetes
2.11
가시성
2.5. 검색 관리

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

구성 맵 내에서 허용(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: |- 
   - 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: 구성 맵 예제에서는 정책 컬렉션,iampolicies, apiGroup admission.k8s.io 에서 certificatepolicies 를 방지하는 동안 모든 apiGroups 에서 시크릿 의 중앙 컬렉션을 방지합니다.

참고: 구성 맵을 제공하지 않으면 기본적으로 모든 리소스가 수집됩니다. AllowedResources 만 제공하는 경우 AllowedResources 에 나열되지 않은 모든 리소스가 자동으로 제외됩니다. AllowedResources 및 DeniedResources 에 동시에 나열된 리소스도 제외됩니다.

2.5.2. 검색 콘솔 사용자 정의
링크 복사

검색 결과 및 제한을 사용자 지정합니다. 사용자 지정을 수행하려면 다음 작업을 완료합니다.

OpenShift Container Platform 콘솔에서 검색 결과 제한을 사용자 지정합니다.
1. multicluster-engine 네임스페이스에서 console-mce-config 를 업데이트합니다. 이러한 설정은 모든 사용자에게 적용되며 성능에 영향을 미칠 수 있습니다. 다음 성능 매개변수 설명을 확인합니다.
  - 192.0.2.D_SEARCH_LIMIT - 각 사용자에 대해 저장된 최대 검색 양입니다. 기본적으로 각 사용자에 대해 저장된 검색 수가 10개로 제한됩니다. 기본값은 10 입니다. 제한을 업데이트하려면 console-config 구성 맵에 다음 키 값을 추가합니다. 192.0.2. D_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, search Cryostat 가 있어야 합니다. 다음 구성 맵 예제를 표시합니다.

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: search가 활성화된 네임스페이스를 추가합니다.

2.5.3. 콘솔에서 쿼리
링크 복사

검색 상자에 텍스트 값을 입력하면 이름 또는 네임스페이스와 같은 속성의 값이 있는 모든 항목이 포함됩니다. 빈 공간이 포함된 쿼리는 지원되지 않습니다.

보다 구체적인 검색 결과를 보려면 검색에 속성 선택기를 포함합니다. 더 정확한 검색 범위를 위해 속성에 관련 값을 결합할 수 있습니다. 예를 들어 dev 클러스터에서 "red" 문자열과 일치하는 결과를 수신하려면 cluster:dev red 를 검색합니다.

검색을 사용하여 쿼리를 만들려면 다음 단계를 완료합니다.

탐색 메뉴에서 검색을 클릭합니다.
검색 상자에 단어를 입력한 다음 검색에서 해당 값이 포함된 리소스를 찾습니다.
- 리소스를 검색할 때 원래 검색 결과와 관련된 다른 리소스가 수신되므로 리소스가 시스템의 다른 리소스와 상호 작용하는 방식을 시각화하는 데 도움이 됩니다.
- 검색에서는 각 클러스터를 반환하고 검색한 리소스로 나열합니다. 허브 클러스터의 리소스의 경우 클러스터 이름이 local-cluster 로 표시됩니다.
- 검색 결과는 종류별로 그룹화되며 각 리소스 유형은 테이블에 그룹화됩니다.
- 검색 옵션은 클러스터 오브젝트에 따라 다릅니다.
- 특정 라벨을 사용하여 결과를 구체화할 수 있습니다. 레이블을 쿼리할 때 검색은 대소문자를 구분합니다. 필터링은 선택할 수 있는 다음 예제( 이름,네임스페이스,상태 및 기타 리소스 필드)를 참조하십시오. 자동 완성은 검색을 구체화하기 위한 제안을 제공합니다. 다음 예제를 참조하십시오.
- 모든 Pod 리소스를 찾으려면 kind: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를 찾습니다.
검색을 저장하려면 검색 저장 아이콘을 클릭합니다.
검색 결과를 다운로드하려면 내보내기 버튼을 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. 추가 리소스
링크 복사

자세한 내용은 다중 클러스터 글로벌 허브 를 참조하십시오.
환경 소개 를 참조하십시오.

맨 위로 이동

2.5. 검색 관리

2.5.1. 구성 가능한 검색 컬렉션 생성
링크 복사

2.5.2. 검색 콘솔 사용자 정의
링크 복사

2.5.3. 콘솔에서 쿼리
링크 복사

2.5.4. 관리 클러스터에서 klusterlet-addon-search 배포 업데이트
링크 복사

2.5.5. 추가 리소스
링크 복사

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

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. 추가 리소스링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

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. 추가 리소스
링크 복사