1.10.7. マルチクラスターオブザーバビリティーアドオンの API の設定
マルチクラスターオブザーバビリティーアドオンのデフォルトのメトリクス固有 API を設定します。ClusterManagementAddon リソースで新しい配置を参照すると、multicluster-observability-addon-manager は自動的に特定のデフォルトの PrometheusAgent リソースを作成します。multicluster-observability-addon-manager は関連する Placement 設定に PrometheusAgent リソース参照を追加します。
配置によって作成される PrometheusAgent リソースは 1 つですが、デフォルトの ScrapeConfigs と PrometheusRules はすべての配置で共通です。PrometheusAgent、ScrapeConfigs、および PrometheusRules リソースは、マルチクラスターオブザーバビリティーアドオンのデフォルトの設定リソースです。
必要なアクセス権: クラスター管理者
前提条件
- マルチクラスターオブザーバビリティーアドオンがインストール、有効化されている。詳細は、マルチクラスターオブザーバビリティーアドオンの有効化 を参照してください。
手順
マルチクラスターオブザーバビリティーアドオンの API を設定するには、以下の手順を実行してください。
-
オプション:
scrapeIntervalパラメーターを変更して、PrometheusAgentリソースのデフォルトのスクレイピング間隔をオーバーライドします。デフォルト値は300 秒です。scrapeConfigリソースのscrapeIntervalをオーバーライドすることもできます。 ScrapeConfigリソースを設定して、マネージドクラスターの Prometheus から独立したフェデレーションを行うためのメトリクスセットを定義します。以下の手順を実行します。-
jobNameパラメーターには、参照するジョブの名前を追加してください。 -
Prometheus でメトリクスを統合させるには、
metricsPathパラメーターに/federateURL パスを追加します。 -
収集するメトリクス名とラベルを追加します。
ScrapeConfigリソースがupメトリクスを収集する以下の YAML ファイルの例を参照してください。
apiVersion: monitoring.rhobs/v1alpha1 kind: ScrapeConfig metadata: name: some-metrics-to-collect namespace: open-cluster-management-observability labels: - app.kubernetes.io/component: <platform-metrics-collector> or <user-workload-metrics-collector> spec: jobName: some-job-name metricsPath: /federate params: match[]: - '{__name__="up"}'-
PrometheusRuleリソースを設定して、ハブクラスターで収集するメトリクスのカーディナリティーを制限します。以下の手順を実行します。- マネージドクラスターにおけるプラットフォームおよびユーザーワークロード監視のためのアラートおよび記録ルールを定義します。
-
PrometheusRuleリソースでユーザーワークロードをターゲットにするには、observability.open-cluster-management.io/target-namespaceアノテーションを追加して、リソースをデプロイする namespace を定義します。
注記:
-
PrometheusRuleリソースでobservability.open-cluster-management.io/target-namespaceが設定されていない場合、PrometheusRuleリソースはデフォルトのインストール namespace にデプロイされます。openshift.io/cluster-monitoringがtrueに設定されている場合、PrometheusRuleリソースは OpenShift Container Platform のユーザーワークロードモニタリングスタックで監視されません。 -
PrometheusRuleリソースには、必ずmonitoring.coreos.comグループを使用してください。
AddonDeploymentConfigリソースを設定して、マネージドクラスターへのマルチクラスターオブザーバビリティーアドオンのデプロイをカスタマイズします。注:AddonDeploymentConfigリソースの値は、他のリソースの直接的な変更をオーバーライドします。以下の手順を実行します。-
agentInstallNamespaceパラメーターで、PrometheusAgentリソースのインストール先の namespace を定義します。デフォルトの namespace はopen-cluster-management-agent-addonです。 -
関連する
nodeSelectorおよびtolerationsパラメーターとともに、nodePlacement仕様を追加します。 -
httpProxyとnoProxyの設定を更新して、proxyConfigの仕様を編集します。
-