17.3. 可観測性

手順

1. 次の例のように、ConfigMap CR を作成し、monitoringConfigMap.yaml として保存します。

   apiVersion: v1
   kind: ConfigMap
   metadata:
    name: cluster-monitoring-config
    namespace: openshift-monitoring
    data:
    config.yaml: |
      alertmanagerMain:
        enabled: false
      telemeterClient:
        enabled: false
      prometheusK8s:
         retention: 24h

2. シングルノード OpenShift で、次のコマンドを実行して ConfigMap CR を適用します。

   $ oc apply -f monitoringConfigMap.yaml

3. 次の例のように、NameSpace CR を作成し、monitoringNamespace.yaml として保存します。

   apiVersion: v1
   kind: Namespace
   metadata:
     name: open-cluster-management-observability

4. ハブクラスターで、次のコマンドを実行して、ハブクラスターに Namespace CR を適用します。

   $ oc apply -f monitoringNamespace.yaml

5. 次の例のように、ObjectBucketClaim CR を作成し、monitoringObjectBucketClaim.yaml として保存します。

   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     name: multi-cloud-observability
     namespace: open-cluster-management-observability
   spec:
     storageClassName: openshift-storage.noobaa.io
     generateBucketName: acm-multi

6. ハブクラスターで、次のコマンドを実行して ObjectBucketClaim CR を適用します。

   $ oc apply -f monitoringObjectBucketClaim.yaml

7. 次の例のように、Secret CR を作成し、monitoringSecret.yaml として保存します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: multiclusterhub-operator-pull-secret
     namespace: open-cluster-management-observability
   stringData:
     .dockerconfigjson: 'PULL_SECRET'

8. ハブクラスターで、次のコマンドを実行して Secret CR を適用します。

   $ oc apply -f monitoringSecret.yaml

9. 次のコマンドを実行して、ハブクラスターから NooBaa サービスのキーとバックエンドバケット名を取得します。

   $ NOOBAA_ACCESS_KEY=$(oc get secret noobaa-admin -n openshift-storage -o json | jq -r '.data.AWS_ACCESS_KEY_ID|@base64d')

   $ NOOBAA_SECRET_KEY=$(oc get secret noobaa-admin -n openshift-storage -o json | jq -r '.data.AWS_SECRET_ACCESS_KEY|@base64d')

   $ OBJECT_BUCKET=$(oc get objectbucketclaim -n open-cluster-management-observability multi-cloud-observability -o json | jq -r .spec.bucketName)

10. 次の例のように、バケットストレージ用の Secret CR を作成し、monitoringBucketSecret.yaml として保存します。

    apiVersion: v1
    kind: Secret
    metadata:
      name: thanos-object-storage
      namespace: open-cluster-management-observability
    type: Opaque
    stringData:
      thanos.yaml: |
        type: s3
        config:
          bucket: ${OBJECT_BUCKET}
          endpoint: s3.openshift-storage.svc
          insecure: true
          access_key: ${NOOBAA_ACCESS_KEY}
          secret_key: ${NOOBAA_SECRET_KEY}

11. ハブクラスターで、次のコマンドを実行して Secret CR を適用します。

    $ oc apply -f monitoringBucketSecret.yaml

12. 次の例のように、MultiClusterObservability CR を作成し、monitoringMultiClusterObservability.yaml として保存します。

    apiVersion: observability.open-cluster-management.io/v1beta2
    kind: MultiClusterObservability
    metadata:
      name: observability
    spec:
      advanced:
        retentionConfig:
          blockDuration: 2h
          deleteDelay: 48h
          retentionInLocal: 24h
          retentionResolutionRaw: 3d
      enableDownsampling: false
      observabilityAddonSpec:
        enableMetrics: true
        interval: 300
      storageConfig:
        alertmanagerStorageSize: 10Gi
        compactStorageSize: 100Gi
        metricObjectStorage:
          key: thanos.yaml
          name: thanos-object-storage
        receiveStorageSize: 25Gi
        ruleStorageSize: 10Gi
        storeStorageSize: 25Gi

13. ハブクラスターで、次のコマンドを実行して MultiClusterObservability CR を適用します。

    $ oc apply -f monitoringMultiClusterObservability.yaml

検証

1. 次のコマンドを実行して、namespace 内のルートと Pod を確認し、サービスがハブクラスターにデプロイされていることを確認します。

   $ oc get routes,pods -n open-cluster-management-observability

   出力例

   NAME                                         HOST/PORT                                                                                        PATH      SERVICES                          PORT          TERMINATION          WILDCARD
   route.route.openshift.io/alertmanager        alertmanager-open-cluster-management-observability.cloud.example.com        /api/v2   alertmanager                      oauth-proxy   reencrypt/Redirect   None
   route.route.openshift.io/grafana             grafana-open-cluster-management-observability.cloud.example.com                       grafana                           oauth-proxy   reencrypt/Redirect   None 1
   route.route.openshift.io/observatorium-api   observatorium-api-open-cluster-management-observability.cloud.example.com             observability-observatorium-api   public        passthrough/None     None
   route.route.openshift.io/rbac-query-proxy    rbac-query-proxy-open-cluster-management-observability.cloud.example.com              rbac-query-proxy                  https         reencrypt/Redirect   None
   
   NAME                                                           READY   STATUS    RESTARTS   AGE
   pod/observability-alertmanager-0                               3/3     Running   0          1d
   pod/observability-alertmanager-1                               3/3     Running   0          1d
   pod/observability-alertmanager-2                               3/3     Running   0          1d
   pod/observability-grafana-685b47bb47-dq4cw                     3/3     Running   0          1d
   <...snip…>
   pod/observability-thanos-store-shard-0-0                       1/1     Running   0          1d
   pod/observability-thanos-store-shard-1-0                       1/1     Running   0          1d
   pod/observability-thanos-store-shard-2-0                       1/1     Running   0          1d

   1

   リスト表示される Grafana ルートからダッシュボードにアクセスできます。これを使用して、すべてのマネージドクラスターのメトリクスを表示できます。

手順

1. 次の例のように、ConfigMap CR を作成し、monitoringConfigMap.yaml として保存します。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cluster-monitoring-config
     namespace: openshift-monitoring
   data:
     config.yaml: |
       enableUserWorkload: true 1

   1

   true に設定してワークロードのモニタリングを有効にします。

2. 次のコマンドを実行して ConfigMap CR を適用します。

   $ oc apply -f monitoringConfigMap.yaml

3. 次の例のように、ServiceMonitor CR を作成し、monitoringServiceMonitor.yaml として保存します。

   apiVersion: monitoring.coreos.com/v1
   kind: ServiceMonitor
   metadata:
     labels:
       app: ui
     name: myapp
     namespace: myns
   spec:
     endpoints: 1
     - interval: 30s
       port: ui-http
       scheme: http
       path: /healthz 2
     selector:
       matchLabels:
         app: ui

   1

   エンドポイントを使用してワークロードメトリクスを定義します。

   2

   Prometheus はデフォルトでパス /metrics をスクレイピングします。ここでカスタムパスを定義できます。

4. 次のコマンドを実行して、ServiceMonitor CR を適用します。

   $ oc apply -f monitoringServiceMonitor.yaml