1.3. 启用 observability 服务

监控使用 observability 服务（multicluster-observability-operator）的受管集群的监控状态。

需要的访问权限：集群管理员或 open-cluster-management:cluster-manager-admin 角色。

先决条件:

  • 您必须安装 Red Hat Advanced Cluster Management for Kubernetes。如需更多信息，请参阅在线安装。

  • 您必须配置对象存储来创建存储解决方案。Red Hat Advanced Cluster Management 只支持带有稳定对象存储的云供应商，如 Amazon S3（或其他 S3 兼容对象存储，如 Ceph）、Google Cloud Storage 和 Azure 存储。

    重要：当您配置对象存储时，请确保在敏感数据持久化时满足加密要求。如需支持的对象存储的完整列表，请参阅 Thanos 文档。

1.3.1. 启用可观察性

通过创建一个 MultiClusterObservability CustomResource（CR）实例来启用 observability 服务。完成以下步骤以启用可观察服务：

  1. 登录到您的 Red Hat Advanced Cluster Management hub 集群。

  2. 使用以下命令，为可观察服务创建一个命名空间： 

    oc create namespace open-cluster-management-observability

  3. 生成 pull-secret。如果在 open-cluster-management 命名空间中安装了 Red Hat Advanced Cluster Management，请运行以下命令： 

    DOCKER_CONFIG_JSON=`oc extract secret/multiclusterhub-operator-pull-secret -n open-cluster-management --to=-`
oc create secret generic multiclusterhub-operator-pull-secret \
    -n open-cluster-management-observability \
    --from-literal=.dockerconfigjson="$DOCKER_CONFIG_JSON" \
    --type=kubernetes.io/dockerconfigjson

    如果命名空间中没有定义 multiclusterhub-operator-pull-secret，将 openshift-config 命名空间中的 pull-secret 复制到 open-cluster-management-observability 命名空间中。运行以下命令： 

    DOCKER_CONFIG_JSON=`oc extract secret/pull-secret -n openshift-config --to=-`
oc create secret generic multiclusterhub-operator-pull-secret \
    -n open-cluster-management-observability \
    --from-literal=.dockerconfigjson="$DOCKER_CONFIG_JSON" \
    --type=kubernetes.io/dockerconfigjson

  4. 为对象存储创建 secret。您的 secret 必须包含存储解决方案的凭证。例如，运行以下命令： 

    oc create -f thanos-object-storage.yaml -n open-cluster-management-observability

    1. 查看以下受支持对象存储的 secret 示例：

      1. 对于 Amazon S3 或 S3 兼容，您的 secret 可能类似以下文件： 

        apiVersion: v1
kind: Secret
metadata:
  name: thanos-object-storage
type: Opaque
stringData:
  thanos.yaml: |
    type: s3
    config:
      bucket: YOUR_S3_BUCKET
      endpoint: YOUR_S3_ENDPOINT
      insecure: false
      access_key: YOUR_ACCESS_KEY
      secret_key: YOUR_SECRET_KEY

      2. 对于 Google，您的 secret 可能类似以下文件： 

        type: GCS
config:
  bucket: YOUR_GCS_BUCKET
  service_account: YOUR_SERVICE_ACCOUNT

      3. 对于 Azure，您的 secret 可能类似以下文件： 

        type: AZURE
config:
  storage_account: YOUR_STORAGE_ACCT
  storage_account_key: YOUR_STORAGE_KEY
  container: YOUR_CONTAINER
  endpoint: YOUR_ENDPOINT
  max_retries: 0

  5. 通过完成以下步骤，为受管集群创建 MultiClusterObservability 自定义资源（mco CR）：

    1. 创建名为 multiclusterobservability_cr.yaml 的 MultiClusterObservability 自定义资源 YAML 文件。

      查看以下默认 YAML 文件以查看可观察性： 

      apiVersion: observability.open-cluster-management.io/v1beta1
kind: MultiClusterObservability
metadata:
  name: observability #Your customized name of MulticlusterObservability CR
spec:
  availabilityConfig: High # Available values are High or Basic
  imagePullPolicy: Always
  imagePullSecret: multiclusterhub-operator-pull-secret
  observabilityAddonSpec: # The ObservabilityAddonSpec defines the global settings for all managed clusters which have observability add-on enabled
    enableMetrics: true # EnableMetrics indicates the observability addon push metrics to hub server
    interval: 60 # Interval for the observability addon push metrics to hub server
  retentionResolution1h: 30d # How long to retain samples of 1 hour in bucket
  retentionResolution5m: 14d
  retentionResolutionRaw: 5d
  storageConfigObject: # Specifies the storage to be used by Observability
    metricObjectStorage:
      name: thanos-object-storage
      key: thanos.yaml
    statefulSetSize: 10Gi # The amount of storage applied to the Observability StatefulSets, i.e. Amazon S3 store, Rule, compact and receiver.
    statefulSetStorageClass: gp2

      您可能想要修改 retentionResolution 参数的值。如需更多信息，请参阅 Thanos Downsampling 分辨率和保留时间。取决于受管集群的数量，您可能需要更新 statefulSetSize。如需更多信息，请参阅 Observability API。

    2. 要在基础架构机器集上部署，您必须通过更新 MultiClusterObservability YAML 中的 nodeSelector 来为设置设置一个标签。您的 YAML 可能类似以下内容： 

      nodeSelector:
    node-role.kubernetes.io/infra:

      如需更多信息，请参阅创建基础架构机器集。

    3. 运行以下命令，将可观察 YAML 应用到集群： 

      oc apply -f multiclusterobservability_cr.yaml

      用于 Thanos、Grafana 和 AlertManager 的所有 pod 在 open-cluster-management-observability 命名空间中创建。所有连接到 Red Hat Advanced Cluster Management hub 集群的受管集群都会被启用，以将指标数据发送回 Red Hat Advanced Cluster Management Observability 服务。

  6. 要验证是否已启用了 observabilty 服务，启动 Grafana 仪表板，查看其中是否包括了相关的数据。完成以下步骤：

    1. 登录到 Red Hat Advanced Cluster Management 控制台。
    2. 在导航菜单中选择 Observe environments > Overview。

    3. 点击位于控制台标头旁的 Grafana 链接，从您的受管集群中查看指标。

      注:如果要排除特定的受管集群收集可观察性数据，请将以下集群标签添加到集群中： vendor:OpenShift.