第1章検索

Red Hat Advanced Cluster Management Search サービスを学習します。検索を使用して、クラスターからリソースデータをクエリーします。以下のドキュメントを参照してください。

1.1. 検索サービス
リンクのコピー

Red Hat Advanced Cluster Management for Kubernetes では、検索機能でクラスター全体の Kubernetes リソースを視認できるようにします。検索では、Kubernetes リソースや他のリソースとの関係もインデックス化されます。

1.1.1. 検索コンポーネント
リンクのコピー

検索アーキテクチャーは、以下のコンポーネントで構成されています。

Expand

表1.1 検索コンポーネントテーブル
コンポーネント名	メトリクス	メトリクスのタイプ	説明
`search-collector`			Kubernetes リソースを監視し、リソースメタデータを収集し、すべてのマネージドクラスターにわたるリソースの関係を計算し、収集したデータを `search-indexer` に送信します。マネージドクラスターの `search-collector` は、`klusterlet-addon-search` という名前の Pod として実行されます。
`search-indexer` コレクターからリソースのメタデータを受信し、PostgreSQL データベースに書き込みます。`search-indexer` はハブクラスターのリソースを監視し、アクティブなマネージドクラスターを追跡します。	`search_indexer_request_duration`	ヒストグラム	検索インデクサーが (マネージドクラスターからの) 要求を処理するのにかかる時間 (秒)。
	`search_indexer_request_size`	ヒストグラム	(マネージドクラスターからの) 検索インデクサー要求における変更の合計 (追加、更新、削除)。
	`search_indexer_request_count`	カウンター	検索インデクサーが (マネージドクラスターから) 受信したリクエストの合計。
	`search_indexer_requests_in_flight`	ゲージ	検索インデクサーが指定された時間で処理する要求の合計数。
`search-api` GraphQL を介して `search-indexer` 内のすべてのクラスターデータへのアクセスを提供し、ロールベースのアクセス制御 (RBAC) を適用します。	`search_api_requests`	ヒストグラム	HTTP 要求の継続時間のヒストグラム (秒単位)。
	`search_dbquery_duration_seconds`	ヒストグラム	データベース要求のレイテンシー (秒単位)。
	`search_api_db_connection_failed_total`	カウンター	失敗したデータベース接続試行の合計数。
`search-postgres`			すべてのマネージドクラスターから収集されたデータを PostgreSQL データベースのインスタンスに保存します。

デフォルトでは、検索はハブクラスターで設定されます。マネージドクラスターをプロビジョニングするか、手動でインポートすると、klusterlet-addon-search が有効になります。マネージドクラスターの検索を無効にする場合は、クラスターの klusterlet アドオン設定の変更を参照してください。

1.1.2. 検索のカスタマイズと設定
リンクのコピー

search-v2-operator カスタムリソースのデフォルト値を変更できます。カスタムリソースの詳細を表示するには、次のコマンドを実行します。

oc get search search-v2-operator -o yaml

検索オペレーターは、search-v2-operator カスタムリソースを監視し、変更を調整して、アクティブな Pod を更新します。次の設定の説明を参照してください。

PostgreSQL データベースストレージ:
Red Hat Advanced Cluster Management をインストールすると、PostgreSQL データベースは、PostgreSQL データを空のディレクトリー (emptyDir) ボリュームに保存するように設定されます。空のディレクトリーサイズが制限されている場合は、PostgreSQL データを永続ボリューム要求 (PVC) に保存して、検索パフォーマンスを向上させることができます。Red Hat Advanced Cluster Management ハブクラスターからストレージクラスを選択して、検索データをバックアップできます。たとえば、gp2 ストレージクラスを選択した場合、設定は次の例のようになります。
```
apiVersion: search.open-cluster-management.io/v1alpha1
kind: Search
metadata:
  name: search-v2-operator
  namespace: open-cluster-management
  labels:
    cluster.open-cluster-management.io/backup: ""
spec:
  dbStorage:
    size: 10Gi
    storageClassName: gp2
```
この設定により、gp2-search という名前の PVC が作成され、search-postgres Pod にマウントされます。デフォルトでは、ストレージサイズは 10Gi です。ストレージサイズを変更できます。たとえば、約 200 のマネージドクラスターには 20Gi で十分な場合があります。

4 つの検索 Pod (indexer、database、queryapi、collector) の Pod メモリーまたは CPU 要件、レプリカ数、更新ログレベルを調整することでコストを最適化します。search-v2-operator カスタムリソースの deployment セクションを更新します。search-v2-operator によって管理される 4 つのデプロイメントがあり、個別に更新できます。search-v2-operator カスタムリソースは、次のファイルのようになる場合があります。

apiVersion: search.open-cluster-management.io/v1alpha1
kind: Search
metadata:
  name: search-v2-operator
  namespace: open-cluster-management
spec:
  deployments:
    collector:
      resources:


        limits:
          cpu: 500m
          memory: 128Mi
        requests:
          cpu: 250m
          memory: 64Mi
    indexer:
      replicaCount: 3
    database:


        envVar:
          - name: POSTGRESQL_EFFECTIVE_CACHE_SIZE
            value: 1024MB
          - name: POSTGRESQL_SHARED_BUFFERS
            value: 512MB
          - name: WORK_MEM
            value: 128MB
    queryapi:
      arguments:


      - -v=3

1: リソースを、indexer、database、queryapi、collector の Pod に適用できます。
2: envVar セクションに複数の環境変数を追加して、名前を付けた各変数の値を指定できます。
3: - -v=3 引数を追加することで、前述した 4 つの Pod のいずれかでログの詳細レベルを制御できます。

以下は、メモリーリソースがインデクサー Pod に適用される例です。

    indexer:
      resources:
        limits:
          memory: 5Gi
        requests:
          memory: 1Gi

検索 Pod のノード配置を定義できます。

nodeSelector パラメーターまたは tolerations パラメーターを使用して、検索 Pod の Placement リソースを更新できます。次の設定例を表示します。

spec:
 dbStorage:
  size: 10Gi
 deployments:
  collector: {}
  database: {}
  indexer: {}
  queryapi: {}
 nodeSelector:
  node-role.kubernetes.io/infra: ""
 tolerations:
 - effect: NoSchedule
  key: node-role.kubernetes.io/infra
  operator: Exists

Advanced search ドロップダウンボタンを選択して検索クエリーを指定し、Column、Operator、Value オプションをフィルタリングするか、検索制約を追加します。

1.1.3. 検索操作とデータ型
リンクのコピー

検索操作を条件として使用して検索クエリーを指定します。>, >=, <, <=, != などの文字がサポートされます。以下の検索操作の表を参照してください。

Expand

表1.2 検索操作表
デフォルトの動作	データのタイプ	説明
`=`	string, number	これがデフォルトの動作です。
`!` または `!=`	string, number	これは、NOT 操作を表します。これは、検索結果から除外することを意味します。
`<, ⇐, >, >=`	number
`>`	date	過去時間、日、週、月、および年に一致する日付。
`*`	string	部分文字列の一致。

1.1.4. 関連情報
リンクのコピー

Red Hat Advanced Cluster Management for Kubernetes コンソールに関するその他のトピックは、Web コンソールを参照してください。

第1章検索

1.1. 検索サービス
リンクのコピー

1.1.1. 検索コンポーネント
リンクのコピー

1.1.2. 検索のカスタマイズと設定
リンクのコピー

1.1.3. 検索操作とデータ型
リンクのコピー

1.1.4. 関連情報
リンクのコピー

詳細情報

試用、購入および販売

コミュニティー

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

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第1章 検索

1.1. 検索サービスリンクのコピーリンクがクリップボードにコピーされました!

1.1.1. 検索コンポーネントリンクのコピーリンクがクリップボードにコピーされました!

1.1.2. 検索のカスタマイズと設定リンクのコピーリンクがクリップボードにコピーされました!

1.1.3. 検索操作とデータ型リンクのコピーリンクがクリップボードにコピーされました!

1.1.4. 関連情報リンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

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

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第1章検索

1.1. 検索サービス
リンクのコピー

1.1.1. 検索コンポーネント
リンクのコピー

1.1.2. 検索のカスタマイズと設定
リンクのコピー

1.1.3. 検索操作とデータ型
リンクのコピー

1.1.4. 関連情報
リンクのコピー