1.2. 検索設定可能コレクションの作成


検索が収集するリソースをカスタマイズする各マネージドクラスターに対して search-collector-config config map を作成し、クラスターから収集される Kubernetes リソースを定義します。

必要なアクセス権: クラスター管理者

検索アドオンがデプロイされているのと同じ namespace に config map を配置します。デフォルトの namespace は open-cluster-management-agent-addon です。

以下の手順を実行します。

  1. 次のコマンドを実行して、search-collector-config config map を作成します。

    oc apply -f <your-search-collector-config>.yaml
    Copy to Clipboard Toggle word wrap
  2. config map 内の許可 (data.AllowedResources) セクションと拒否リスト (data.DeniedResources) セクションにリソースをリストします。config map は、次の 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
    上記の config map の例では、すべての apiGroups から servicespods を表示でき、admission.k8s.io および authentication.k8s.io apiGroups からすべてのリソースも収集できます。
    2
    この config map の例では、すべての apiGroups から secrets を一元的に収集するのを防止し、apiGroup admission.k8s.io からの policiesiampoliciescertificatepolicies の収集も防止します。

    注記: config map を指定しない場合、デフォルトですべてのリソースが収集されます。AllowedResources のみを指定した場合、AllowedResources にリストされていないすべてのリソースは自動的に除外されます。AllowedResourcesDeniedResources に同時にリストされているリソースも除外されます。

1.2.1. サーチコンソールのカスタマイズ

検索結果と制限をカスタマイズします。カスタマイズを実行するには、次のタスクを完了します。

  1. OpenShift Container Platform コンソールから検索結果の制限をカスタマイズします。

    1. multicluster-engine namespace の console-mce-config を更新します。これらの設定はすべてのユーザーに適用され、パフォーマンスに影響を与える可能性があります。次のパフォーマンスパラメーターの説明を表示します。

      • SAVED_SEARCH_LIMIT - 各ユーザーの保存済み検索の最大数。デフォルトでは、ユーザーごとに 10 個の保存済み検索の制限があります。デフォルト値は 10 です。制限を更新するには、console-config config map にキー値 SAVED_SEARCH_LIMIT: x を追加します。
      • SEARCH_RESULT_LIMIT: コンソールに表示される検索結果の最大量。デフォルト値は 1000 です。この制限を削除するには、-1 に設定します。
      • SEARCH_AUTOCOMPLETE_LIMIT: 検索バーの先行入力に対して取得される候補の最大数。デフォルト値は 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 という名前の config map を作成し、suggestedSearches セクションを設定します。リストされている検索候補もコンソールから表示されます。各検索オブジェクトには、id, name, and searchText が必要です。次の config map の例を確認してください。

    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
    検索が有効になっている namespace を追加します。

1.2.2. コンソールでのクエリー

検索ボックス にテキスト値を入力すると、名前や namespace などのプロパティーからのその値が含まれる結果が表示されます。空白を含むクエリーはサポートされていません。

必要なアクセス権: クラスター管理者

検索結果をさらに絞り込むには、検索にプロパティーセレクターを追加します。プロパティーに関連する値を組み合わせて、検索範囲をより正確に指定できます。たとえば、cluster:dev red と検索すると、dev クラスター内で "red" の文字列と一致する結果が返されます。

検索でクエリーを作成するには、次の手順を実行します。

  1. ナビゲーションメニューの 検索 をクリックします。
  2. Search box に単語を入力すると、検索機能で、対象の値が含まれたリソースを見つけ出します。

    • リソースを検索すると、元の検索結果に関連する他のリソースが表示されるので、リソースがシステム内にある他のリソースとどのように対話するのかを視覚的に確認できます。
    • 検索すると、各クラスターと、検索したリソースが返され、リスト表示されます。ハブ クラスターのリソースの場合には、クラスター名は local-cluster として表示されます。
    • 検索結果は、kind でグループ化され、リソースの kind ごとに表でグループ化されます。
    • 検索オプションはクラスターオブジェクトにより異なります。
    • 特定のラベルで結果を絞り込むことができます。ラベルのクエリー時の検索は、大文字と小文字が区別されます。フィルタリング用に選択できる例 namenamespacestatus、およびその他のリソースフィールドを参照してください。自動補完では、補完候補を表示して検索を絞り込むことができます。以下の例を参照してください。
    • kind:pod など、フィールド 1 つを検索すると、すべての Pod リソースが返されます。
    • kind:pod namespace:default など、複数のフィールドを検索すると、デフォルトの namespace にある 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 を検索すると、最低でも 2 回再起動した全 Pod が返されます。
  3. 検索を保存する場合は、Save search アイコンをクリックします。
  4. 検索結果をダウンロードするには、Export as CSV ボタンを選択します。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat