Service Telemetry Framework 1.5

手順

1. STF がホストされている Red Hat OpenShift Container Platform 環境にログインします。

2. Prometheus にメトリクスを保存するには、redhat-operators CatalogSource を使用して Cluster Observability Operator を有効にします。

   $ oc create -f - <<EOF
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: cluster-observability-operator
     namespace: openshift-operators
   spec:
     channel: development
     installPlanApproval: Automatic
     name: cluster-observability-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
   EOF

3. Cluster Observability Operator の ClusterServiceVersion のステータスが Succeeded であることを確認します。

   $ oc wait --for jsonpath="{.status.phase}"=Succeeded csv --namespace=openshift-operators -l operators.coreos.com/cluster-observability-operator.openshift-operators
   
   clusterserviceversion.operators.coreos.com/observability-operator.v0.0.26 condition met

手順

1. STF がホストされている Red Hat OpenShift Container Platform 環境にログインします。

2. Red Hat OpenShift Container Platform クラスターに cert-manager がインストールされていないことを確認します。結果が返された場合、それ以上は cert-manager インスタンスをインストールしないでください。

   $ oc get sub --all-namespaces -o json | jq '.items[] | select(.metadata.name | match("cert-manager")) | .metadata.name'

3. cert-manager Operator の namespace を作成します。

   $ oc create -f - <<EOF
   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: cert-manager-operator
   spec:
     finalizers:
     - kubernetes
   EOF

4. cert-manager Operator の OperatorGroup を作成します。

   $ oc create -f - <<EOF
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: cert-manager-operator
     namespace: cert-manager-operator
   spec:
     targetNamespaces:
     - cert-manager-operator
     upgradeStrategy: Default
   EOF

5. redhat-operators CatalogSource を使用して、cert-manager Operator にサブスクライブします。

   $ oc create -f - <<EOF
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openshift-cert-manager-operator
     namespace: cert-manager-operator
     labels:
       operators.coreos.com/openshift-cert-manager-operator.cert-manager-operator: ""
   spec:
     channel: stable-v1
     installPlanApproval: Automatic
     name: openshift-cert-manager-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
   EOF

6. ClusterServiceVersion を検証します。cert-manager Operator が Succeeded のフェーズを表示していることを確認します。

   oc wait --for jsonpath="{.status.phase}"=Succeeded csv --namespace=cert-manager-operator --selector=operators.coreos.com/openshift-cert-manager-operator.cert-manager-operator
   
   clusterserviceversion.operators.coreos.com/cert-manager-operator.v1.12.1 condition met

手順

1. STF コンポーネントが含まれる namespace を作成します (例: service-telemetry)。

   $ oc new-project service-telemetry

2. Operator Pod をスケジュールできるように、namespace に OperatorGroup を作成します。

   $ oc create -f - <<EOF
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: service-telemetry-operator-group
     namespace: service-telemetry
   spec:
     targetNamespaces:
     - service-telemetry
   EOF

   詳細は、OperatorGroups を参照してください。

3. Service Telemetry Operator サブスクリプションを作成し、STF インスタンスを管理します。

   $ oc create -f - <<EOF
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: service-telemetry-operator
     namespace: service-telemetry
   spec:
     channel: stable-1.5
     installPlanApproval: Automatic
     name: service-telemetry-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
   EOF

4. Service Telemetry Operator および依存する Operator のフェースが Succeeded になるかどうかを検証します。

   $ oc wait --for jsonpath="{.status.phase}"=Succeeded csv --namespace=service-telemetry -l operators.coreos.com/service-telemetry-operator.service-telemetry ; oc get csv --namespace service-telemetry
   
   clusterserviceversion.operators.coreos.com/service-telemetry-operator.v1.5.1700688542 condition met
   
   NAME                                         DISPLAY                                  VERSION          REPLACES                             PHASE
   amq7-interconnect-operator.v1.10.17          Red Hat Integration - AMQ Interconnect   1.10.17          amq7-interconnect-operator.v1.10.4   Succeeded
   observability-operator.v0.0.26               Cluster Observability Operator           0.1.0                                                 Succeeded
   service-telemetry-operator.v1.5.1700688542   Service Telemetry Operator               1.5.1700688542                                        Succeeded
   smart-gateway-operator.v5.0.1700688539       Smart Gateway Operator                   5.0.1700688539                                        Succeeded

手順

1. ServiceTelemetry オブジェクトを編集します。

   $ oc edit stf default

2. backends.metrics.prometheus.enabled パラメーターの値を true に設定します。

   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   metadata:
     name: default
     namespace: service-telemetry
   spec:
     [...]
     backends:
       metrics:
         prometheus:
           enabled: true

手順

1. 利用可能なストレージクラスをリスト表示します。

   $ oc get storageclasses
   NAME                 PROVISIONER                RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
   csi-manila-ceph      manila.csi.openstack.org   Delete          Immediate              false                  20h
   standard (default)   kubernetes.io/cinder       Delete          WaitForFirstConsumer   true                   20h
   standard-csi         cinder.csi.openstack.org   Delete          WaitForFirstConsumer   true                   20h

2. ServiceTelemetry オブジェクトを編集します。

   $ oc edit stf default

3. backends.metrics.prometheus.enabled パラメーターの値を true にbackends.metrics.prometheus.storage.strategy の値を persistent に設定します。

   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   metadata:
     name: default
     namespace: service-telemetry
   spec:
     [...]
     backends:
       metrics:
         prometheus:
           enabled: true
           storage:
             strategy: persistent
             persistent:
               storageClass: standard-csi
               pvcStorageRequest: 50G

手順

1. ServiceTelemetry オブジェクトを編集します。

   $ oc edit stf default

2. backends.events.elasticsearch.enabled パラメーターの値を true に設定し、関連する Elasticsearch インスタンスを使用して hostUrl を設定します。

   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   metadata:
     name: default
     namespace: service-telemetry
   spec:
     [...]
     backends:
       events:
         elasticsearch:
           enabled: true
           forwarding:
             hostUrl: https://external-elastic-http.domain:9200
             tlsServerName: ""
             tlsSecretName: elasticsearch-es-cert
             userSecretName: elasticsearch-es-elastic-user
             useBasicAuth: true
             useTls: true

3. userSecretName パラメーターで指定されたシークレットを作成して、basic auth の認証情報を保存します。

   $ oc create secret generic elasticsearch-es-elastic-user --from-literal=elastic='<PASSWORD>'

4. CA 証明書を EXTERNAL-ES-CA.pem という名前のファイルにコピーし、tlsSecretName パラメーターで指定されたシークレットを作成して STF で使用できるようにします。

   $ cat EXTERNAL-ES-CA.pem
   -----BEGIN CERTIFICATE-----
   [...]
   -----END CERTIFICATE-----
   
   $ oc create secret generic elasticsearch-es-cert --from-file=ca.crt=EXTERNAL-ES-CA.pem

手順

1. STF で使用可能な証明書のリストを表示します。

   $ oc get secrets

2. default-interconnect-selfsigned シークレットの内容を取得して書き留めます。

   $ oc get secret/default-interconnect-selfsigned -o jsonpath='{.data.ca\.crt}' | base64 -d

手順

1. STF がホストされている Red Hat OpenShift Container Platform 環境にログインします。

2. service-telemetry プロジェクトに変更します。

   $ oc project service-telemetry

3. AMQ Interconnect のパスワードを取得します。

   $ oc get secret default-interconnect-users -o json | jq -r .data.guest | base64 -d

手順

1. STF がホストされている Red Hat OpenShift Container Platform 環境にログインします。

2. service-telemetry プロジェクトに変更します。

   $ oc project service-telemetry

3. AMQ インターコネクトのルートアドレスを取得します。

   $ oc get routes -ogo-template='{{ range .items }}{{printf "%s\n" .spec.host }}{{ end }}' | grep "\-5671"
   default-interconnect-5671-service-telemetry.apps.infra.watch

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. /home/stack ディレクトリーに enable-stf.yaml という名前の設定ファイルを作成します。

   重要

   PipelinePublishers を空のリストに設定すると、Gnocchi や Panko などの RHOSP Telemetry コンポーネントにメトリクスデータは渡されません。追加のパイプラインにデータを送信する必要がある場合、ExtraConfig で指定する 30 秒の Ceilometer ポーリング間隔により、RHOSP テレメトリーコンポーネントが過負荷になる可能性があります。間隔を 300 などの大きな値に増やす必要があります。その場合、STF でのテレメトリー解像度が低くなります。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。
2. /home/stack ディレクトリーに stf-connectors.yaml という設定ファイルを作成します。

3. stf-connectors.yaml ファイルで、オーバークラウド上の AMQ Interconnect を STF デプロイメントに接続するように MetricsQdrConnectors アドレスを設定します。このファイルの Sensubility、Ceilometer、および collectd のトピックアドレスを、STF のデフォルトに一致するように設定します。トピックおよびクラウド設定のカスタマイズに関する詳細は、「複数のクラウドの設定」 を参照してください。

   stf-connectors.yaml

   resource_registry:
     OS::TripleO::Services::Collectd: /usr/share/openstack-tripleo-heat-templates/deployment/metrics/collectd-container-puppet.yaml
   
   parameter_defaults:
       ExtraConfig:
           qdr::router_id: "%{::hostname}.cloud1"
   
       MetricsQdrConnectors:
           - host: default-interconnect-5671-service-telemetry.apps.infra.watch
             port: 443
             role: edge
             verifyHostname: false
             sslProfile: sslProfile
             saslUsername: guest@default-interconnect
             saslPassword: <password_from_stf>
   
       MetricsQdrSSLProfiles:
           - name: sslProfile
             caCertFileContent: |
               -----BEGIN CERTIFICATE-----
               <snip>
               -----END CERTIFICATE-----
   
       CeilometerQdrMetricsConfig:
           driver: amqp
           topic: cloud1-metering
   
       CollectdAmqpInstances:
           cloud1-telemetry:
               format: JSON
               presettle: false
   
       CollectdSensubilityResultsChannel: sensubility/cloud1-telemetry

   • qdr::router_id 設定は、ホストの完全修飾ドメイン名 (FQDN) を使用するデフォルト値をオーバーライドします。場合によっては、FQDN を使用することでルーター ID の長さが 61 文字を超え、QDR 接続が失敗することがあります。FQDN 値がそれより短いデプロイメントの場合、これは必要ありません。
   • 複数のクラウドデプロイメント用に collectd-write-qdr.yaml 環境ファイルを含めないため、resource_registry 設定は collectd サービスを直接ロードします。
   • MetricsQdrConnectors の host サブパラメーターを、「AMQ Interconnect ルートアドレスの取得」 で取得した値に置き換えます。
   • MetricsQdrConnectors の saslPassword サブパラメーターの <password_from_stf> 部分を、「AMQ Interconnect のパスワードの取得」 で取得した値に置き換えます。
   • caCertFileContent パラメーターを、「オーバークラウドの設定向け Service Telemetry Framework からの CA 証明書の取得」 で取得したコンテンツに置き換えます。
   • CeilometerQdrMetricsConfig.topic の topic 値を設定して、Ceilometer メトリクスのトピックを定義します。値は、cloud1-metering などのクラウドの一意のトピック識別子です。
   • CollectdAmqpInstances サブパラメーターを設定して、collectd メトリクスのトピックを定義します。セクション名は、cloud1-telemetry などのクラウドの一意のトピック識別子です。
   • CollectdSensubilityResultsChannel を設定して、collectd-sensubility イベントのトピックを定義します。値は、sensubility/cloud1-telemetry などのクラウドの一意のトピック識別子です。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。

2. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source ~/stackrc

3. データコレクションと AMQ Interconnect 環境ファイルを他の環境ファイルとともにスタックに追加し、オーバークラウドをデプロイします。

   (undercloud)$ openstack overcloud deploy --templates \
    -e [your environment files] \
    -e /usr/share/openstack-tripleo-heat-templates/environments/metrics/ceilometer-write-qdr.yaml \
    -e /usr/share/openstack-tripleo-heat-templates/environments/metrics/qdr-edge-only.yaml \
    -e /home/stack/enable-stf.yaml \
    -e /home/stack/stf-connectors.yaml

   • Ceilometer Telemetry が STF に送信されるようにするには、ceilometer-write-qdr.yaml ファイルを含めます。
   • qdr-edge-only.yaml ファイルを含めて、メッセージバスが有効になり、STF メッセージバスルーターに接続されていることを確認します。
   • デフォルトが正しく設定されていることを確認するには、enable-stf.yaml 環境ファイルを組み込みます。
   • STF への接続を定義するための stf-connectors.yaml 環境ファイルを含めます。

手順

1. オーバークラウドノード (例: controller-0) にログインします。

2. metrics_qdr とコレクションエージェントコンテナーがノード上で実行されていることを確認します。

   $ sudo podman container inspect --format '{{.State.Status}}' metrics_qdr collectd ceilometer_agent_notification ceilometer_agent_central
   running
   running
   running
   running

   注記

   Compute ノードで次のコマンドを使用します。

   $ sudo podman container inspect --format '{{.State.Status}}' metrics_qdr collectd ceilometer_agent_compute

3. AMQ Interconnect が実行されている内部ネットワークアドレスを返します (ポート 5666 でリッスンする 172.17.1.44 など)。

   $ sudo podman exec -it metrics_qdr cat /etc/qpid-dispatch/qdrouterd.conf
   
   listener {
       host: 172.17.1.44
       port: 5666
       authenticatePeer: no
       saslMechanisms: ANONYMOUS
   }

4. ローカルの AMQ インターコネクトへの接続のリストを返します。

   $ sudo podman exec -it metrics_qdr qdstat --bus=172.17.1.44:5666 --connections
   
   Connections
     id   host                                                                  container                                                                                                  role    dir  security                            authentication  tenant
     ============================================================================================================================================================================================================================================================================================
     1    default-interconnect-5671-service-telemetry.apps.infra.watch:443      default-interconnect-7458fd4d69-bgzfb                                                                      edge    out  TLSv1.2(DHE-RSA-AES256-GCM-SHA384)  anonymous-user
     12   172.17.1.44:60290                                                     openstack.org/om/container/controller-0/ceilometer-agent-notification/25/5c02cee550f143ec9ea030db5cccba14  normal  in   no-security                         no-auth
     16   172.17.1.44:36408                                                     metrics                                                                                                    normal  in   no-security                         anonymous-user
     899  172.17.1.44:39500                                                     10a2e99d-1b8a-4329-b48c-4335e5f75c84                                                                       normal  in   no-security                         no-auth

   接続は 4 つあります。

   • STF へのアウトバウンド接続
   • ceilometer からのインバウンド接続
   • collectd からのインバウンド接続

   • qdstat クライアントからの受信接続

     STF の送信接続は MetricsQdrConnectors ホストパラメーターに提供され、STF ストレージドメインのルートとなります。他のホストは、この AMQ インターコネクトへのクライアント接続の内部ネットワークアドレスです。

5. メッセージが配信されていることを確認するには、リンクをリスト表示してメッセージ配信の deliv 列に _edge アドレスを表示します。

   $ sudo podman exec -it metrics_qdr qdstat --bus=172.17.1.44:5666 --links
   Router Links
     type      dir  conn id  id    peer  class   addr                  phs  cap  pri  undel  unsett  deliv    presett  psdrop  acc  rej  rel     mod  delay  rate
     ===========================================================================================================================================================
     endpoint  out  1        5           local   _edge                      250  0    0      0       2979926  0        0       0    0    2979926 0    0      0
     endpoint  in   1        6                                              250  0    0      0       0        0        0       0    0    0       0    0      0
     endpoint  in   1        7                                              250  0    0      0       0        0        0       0    0    0       0    0      0
     endpoint  out  1        8                                              250  0    0      0       0        0        0       0    0    0       0    0      0
     endpoint  in   1        9                                              250  0    0      0       0        0        0       0    0    0       0    0      0
     endpoint  out  1        10                                             250  0    0      0       911      911      0       0    0    0       0    911    0
     endpoint  in   1        11                                             250  0    0      0       0        911      0       0    0    0       0    0      0
     endpoint  out  12       32          local   temp.lSY6Mcicol4J2Kp       250  0    0      0       0        0        0       0    0    0       0    0      0
     endpoint  in   16       41                                             250  0    0      0       2979924  0        0       0    0    2979924 0    0      0
     endpoint  in   912      1834        mobile  $management           0    250  0    0      0       1        0        0       1    0    0       0    0      0
     endpoint  out  912      1835        local   temp.9Ok2resI9tmt+CT       250  0    0      0       0        0        0       0    0    0       0    0      0

6. RHOSP ノードから STF へのアドレスをリスト表示するには、Red Hat OpenShift Container Platform に接続して AMQ Interconnect Pod 名を取得し、接続をリスト表示します。利用可能な AMQ Interconnect Pod をリスト表示します。

   $ oc get pods -l application=default-interconnect
   
   NAME                                    READY   STATUS    RESTARTS   AGE
   default-interconnect-7458fd4d69-bgzfb   1/1     Running   0          6d21h

7. Pod に接続し、既知の接続をリスト表示します。この例では、RHOSP ノードから接続 id 22、23、および 24 の 3 つの edge 接続があります。

   $ oc exec -it deploy/default-interconnect -- qdstat --connections
   
   2020-04-21 18:25:47.243852 UTC
   default-interconnect-7458fd4d69-bgzfb
   
   Connections
     id  host               container                                                      role    dir  security                                authentication  tenant  last dlv      uptime
     ===============================================================================================================================================================================================
     5   10.129.0.110:48498  bridge-3f5                                                    edge    in   no-security                             anonymous-user          000:00:00:02  000:17:36:29
     6   10.129.0.111:43254  rcv[default-cloud1-ceil-meter-smartgateway-58f885c76d-xmxwn]  edge    in   no-security                             anonymous-user          000:00:00:02  000:17:36:20
     7   10.130.0.109:50518  rcv[default-cloud1-coll-event-smartgateway-58fbbd4485-rl9bd]  normal  in   no-security                             anonymous-user          -             000:17:36:11
     8   10.130.0.110:33802  rcv[default-cloud1-ceil-event-smartgateway-6cfb65478c-g5q82]  normal  in   no-security                             anonymous-user          000:01:26:18  000:17:36:05
     22  10.128.0.1:51948   Router.ceph-0.redhat.local                                     edge    in   TLSv1/SSLv3(DHE-RSA-AES256-GCM-SHA384)  anonymous-user          000:00:00:03  000:22:08:43
     23  10.128.0.1:51950   Router.compute-0.redhat.local                                  edge    in   TLSv1/SSLv3(DHE-RSA-AES256-GCM-SHA384)  anonymous-user          000:00:00:03  000:22:08:43
     24  10.128.0.1:52082   Router.controller-0.redhat.local                               edge    in   TLSv1/SSLv3(DHE-RSA-AES256-GCM-SHA384)  anonymous-user          000:00:00:00  000:22:08:34
     27  127.0.0.1:42202    c2f541c1-4c97-4b37-a189-a396c08fb079                           normal  in   no-security                             no-auth                 000:00:00:00  000:00:00:00

8. ネットワークによって配信されるメッセージ数を表示するには、各アドレスを oc exec コマンドで使用します。

   $ oc exec -it deploy/default-interconnect -- qdstat --address
   
   2020-04-21 18:20:10.293258 UTC
   default-interconnect-7458fd4d69-bgzfb
   
   Router Addresses
     class   addr                                phs  distrib    pri  local  remote  in           out          thru  fallback
     ==========================================================================================================================
     mobile  anycast/ceilometer/event.sample     0    balanced   -    1      0       970          970          0     0
     mobile  anycast/ceilometer/metering.sample  0    balanced   -    1      0       2,344,833    2,344,833    0     0
     mobile  collectd/notify                     0    multicast  -    1      0       70           70           0     0
     mobile  collectd/telemetry                  0    multicast  -    1      0       216,128,890  216,128,890  0     0

手順

1. Red Hat OpenShift Container Platform にログインします。

2. service-telemetry namespace に切り替えます。

   $ oc project service-telemetry

3. default の ServiceTelemetry オブジェクトを編集し、設定で clouds パラメーターを追加します。

   警告

   クラウド名が長くなると、Pod 名の最大長 63 文字を超える可能性があります。ServiceTelemetry 名の default と clouds.name の組み合わせが 19 文字を超えないようにしてください。クラウド名には、- などの特殊文字を含めることはできません。クラウド名を英数字 (a-z、0-9) に制限します。

   トピックアドレスには文字の制限がなく、clouds.name の値とは異なる場合があります。

   $ oc edit stf default

   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   metadata:
     ...
   spec:
     ...
     clouds:
     - name: cloud1
       events:
         collectors:
         - collectorType: collectd
           subscriptionAddress: collectd/cloud1-notify
         - collectorType: ceilometer
           subscriptionAddress: anycast/ceilometer/cloud1-event.sample
       metrics:
         collectors:
         - collectorType: collectd
           subscriptionAddress: collectd/cloud1-telemetry
         - collectorType: sensubility
           subscriptionAddress: sensubility/cloud1-telemetry
         - collectorType: ceilometer
           subscriptionAddress: anycast/ceilometer/cloud1-metering.sample
     - name: cloud2
       events:
         ...

4. ServiceTelemetry オブジェクトを保存します。

5. 各 Smart Gateway が起動していることを確認します。この作業は、Smart Gateway の台数によっては数分かかることがあります。

   $ oc get po -l app=smart-gateway
   NAME                                                      READY   STATUS    RESTARTS   AGE
   default-cloud1-ceil-event-smartgateway-6cfb65478c-g5q82   2/2     Running   0          13h
   default-cloud1-ceil-meter-smartgateway-58f885c76d-xmxwn   2/2     Running   0          13h
   default-cloud1-coll-event-smartgateway-58fbbd4485-rl9bd   2/2     Running   0          13h
   default-cloud1-coll-meter-smartgateway-7c6fc495c4-jn728   2/2     Running   0          13h
   default-cloud1-sens-meter-smartgateway-8h4tc445a2-mm683   2/2     Running   0          13h

手順

1. Service Telemetry Operator が管理するクラウドオブジェクトのリストで clouds パラメーターを定義します。詳細は、「clouds パラメーター」 を参照してください。

2. ServiceTelemetry オブジェクトを編集し、cloudsRemoveOnMissing パラメーターを追加します。

   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   metadata:
     ...
   spec:
     ...
     cloudsRemoveOnMissing: true
     clouds:
       ...

3. 修正内容を保存します。

4. オペレーターが Smart Gateway を削除したことを確認します。Operator が変更を調整する間、数分かかることがあります。

   $ oc get smartgateways

手順

1. 新しい環境ファイルを作成します (例: hostnames.yaml)。

2. 以下の例に示すように、環境ファイルで CloudDomain パラメーターを設定します。

   hostnames.yaml

   parameter_defaults:
       CloudDomain: newyork-west-04
       CephStorageHostnameFormat: 'ceph-%index%'
       ObjectStorageHostnameFormat: 'swift-%index%'
       ComputeHostnameFormat: 'compute-%index%'

3. 新しい環境ファイルをデプロイメントに追加します。

手順

1. アンダークラウドホストに stack ユーザーとしてログインします。
2. /home/stack ディレクトリーに stf-connectors.yaml という設定ファイルを作成します。

3. stf-connectors.yaml ファイルで、オーバークラウドデプロイメント上の AMQ Interconnect をに接続するように MetricsQdrConnectors アドレスを設定します。CeilometerQdrMetricsConfig、CollectdAmqpInstances、および CollectdSensubilityResultsChannel トピックの値を、このクラウドデプロイメントに必要な AMQP アドレスと一致するように設定します。

   stf-connectors.yaml

   resource_registry:
     OS::TripleO::Services::Collectd: /usr/share/openstack-tripleo-heat-templates/deployment/metrics/collectd-container-puppet.yaml
   
   parameter_defaults:
       ExtraConfig:
           qdr::router_id: %{::hostname}.cloud1
   
       MetricsQdrConnectors:
           - host: default-interconnect-5671-service-telemetry.apps.infra.watch
             port: 443
             role: edge
             verifyHostname: false
             sslProfile: sslProfile
   
       MetricsQdrSSLProfiles:
           - name: sslProfile
             caCertFileContent: |
               -----BEGIN CERTIFICATE-----
               <snip>
               -----END CERTIFICATE-----
   
       CeilometerQdrMetricsConfig:
           driver: amqp
           topic: cloud1-metering
   
       CollectdAmqpInstances:
           cloud1-telemetry:
               format: JSON
               presettle: false
   
       CollectdSensubilityResultsChannel: sensubility/cloud1-telemetry

   • qdr::router_id 設定は、ホストの完全修飾ドメイン名 (FQDN) を使用するデフォルト値をオーバーライドします。場合によっては、FQDN を使用することでルーター ID の長さが 61 文字を超え、QDR 接続が失敗することがあります。FQDN 値がそれより短いデプロイメントの場合、これは必要ありません。
   • 複数のクラウドデプロイメント用に collectd-write-qdr.yaml 環境ファイルを含めないため、resource_registry 設定は collectd サービスを直接ロードします。
   • host パラメーターを、「AMQ Interconnect ルートアドレスの取得」 で取得した値に置き換えます。
   • caCertFileContent パラメーターを、「オーバークラウドの設定向け Service Telemetry Framework からの CA 証明書の取得」 で取得したコンテンツに置き換えます。
   • MetricsQdrConnectors の host サブパラメーターを、「AMQ Interconnect ルートアドレスの取得」 で取得した値に置き換えます。
   • CeilometerQdrMetricsConfig.topic の topic 値を設定して、Ceilometer メトリクスのトピックを定義します。値は、cloud1-metering などのクラウドの一意のトピック識別子です。
   • CollectdAmqpInstances サブパラメーターを設定して、collectd メトリクスのトピックを定義します。セクション名は、cloud1-telemetry などのクラウドの一意のトピック識別子です。

   • CollectdSensubilityResultsChannel を設定して、collectd-sensubility イベントのトピックを定義します。値は、sensubility/cloud1-telemetry などのクラウドの一意のトピック識別子です。

     注記

     collectd および Ceilometer のトピックを定義すると、指定した値は、Smart Gateway クライアントがメッセージをリッスンするために使用する完全なトピックに置き換えられます。

     Ceilometer トピック値はトピックアドレス anycast/ceilometer/<TOPIC>.sample に置き換えられ、collectd トピック値はトピックアドレス collectd/<TOPIC> に置き換えられます。sensubility の値は完全なトピックパスであり、トピック値からトピックアドレスへの転置はありません。

     完全なトピックアドレスを参照する ServiceTelemetry オブジェクトのクラウド設定の例については、「clouds パラメーター」 を参照してください。

4. stf-connectors.yaml ファイルの命名規則が、Smart Gateway 設定の spec.bridge.amqpUrl フィールドと一致していることを確認します。たとえば、CeilometerQdrMetricsConfig.topic フィールドの値を cloud1-metering に設定します。
5. アンダークラウドホストに stack ユーザーとしてログインします。

6. stackrc アンダークラウド認証情報ファイルを入手します。

   $ source stackrc

7. 実際の環境に該当するその他の環境ファイルと共に、openstack overcloud deployment コマンドに stf-connectors.yaml ファイルおよび一意のドメイン名環境ファイル hostnames.yaml を追加します。

   警告

   カスタム CollectdAmqpInstances パラメーターで collectd-write-qdr.yaml ファイルを使用する場合、データはカスタムおよびデフォルトのトピックに公開されます。複数のクラウド環境では、stf-connectors.yaml ファイルの resource_registry パラメーターの設定では collectd サービスを読み込みます。

   (undercloud)$ openstack overcloud deploy --templates \
   -e [your environment files] \
   -e /usr/share/openstack-tripleo-heat-templates/environments/metrics/ceilometer-write-qdr.yaml \
   -e /usr/share/openstack-tripleo-heat-templates/environments/metrics/qdr-edge-only.yaml \
   -e /home/stack/hostnames.yaml \
   -e /home/stack/enable-stf.yaml \
   -e /home/stack/stf-connectors.yaml

8. Red Hat OpenStack Platform オーバークラウドのデプロイ

手順

1. STF で使用可能な証明書のリストを表示します。

   $ oc get secrets

2. default-interconnect-selfsigned シークレットの内容を取得して書き留めます。

   $ oc get secret/default-interconnect-selfsigned -o jsonpath='{.data.ca\.crt}' | base64 -d

手順

1. STF がホストされている Red Hat OpenShift Container Platform 環境にログインします。

2. service-telemetry プロジェクトに変更します。

   $ oc project service-telemetry

3. AMQ インターコネクトのルートアドレスを取得します。

   $ oc get routes -ogo-template='{{ range .items }}{{printf "%s\n" .spec.host }}{{ end }}' | grep "\-5671"
   default-interconnect-5671-service-telemetry.apps.infra.watch

手順

1. RHOSP director Operator がデプロイされている Red Hat OpenShift Container Platform 環境にログインし、RHOSP デプロイメントをホストするプロジェクトに変更します。

   $ oc project openstack

2. heat-env-config-deploy ConfigMap CR を編集するために開きます。

   $ oc edit heat-env-config-deploy

3. enable-stf.yaml 設定を heat-env-config-deploy ConfigMap に追加し、編集内容を保存してファイルを閉じます。

   enable-stf.yaml

   apiVersion: v1
   data:
     [...]
     enable-stf.yaml: |
       parameter_defaults:
           # only send to STF, not other publishers
           PipelinePublishers: []
   
           # manage the polling and pipeline configuration files for Ceilometer agents
           ManagePolling: true
           ManagePipeline: true
           ManageEventPipeline: false
   
           # enable Ceilometer metrics and events
           CeilometerQdrPublishMetrics: true
   
           # enable collection of API status
           CollectdEnableSensubility: true
           CollectdSensubilityTransport: amqp1
   
           # enable collection of containerized service metrics
           CollectdEnableLibpodstats: true
   
           # set collectd overrides for higher telemetry resolution and extra plugins
           # to load
           CollectdConnectionType: amqp1
           CollectdAmqpInterval: 30
           CollectdDefaultPollingInterval: 30
           # to collect information about the virtual memory subsystem of the kernel
           # CollectdExtraPlugins:
           # - vmem
   
           # set standard prefixes for where metrics are published to QDR
           MetricsQdrAddresses:
           - prefix: 'collectd'
             distribution: multicast
           - prefix: 'anycast/ceilometer'
             distribution: multicast
   
           ExtraConfig:
              ceilometer::agent::polling::polling_interval: 30
              ceilometer::agent::polling::polling_meters:
              - cpu
              - memory.usage
   
              # to avoid filling the memory buffers if disconnected from the message bus
              # note: this may need an adjustment if there are many metrics to be sent.
              collectd::plugin::amqp1::send_queue_limit: 5000
   
              # to receive extra information about virtual memory, you must enable vmem plugin in CollectdExtraPlugins
              # collectd::plugin::vmem::verbose: true
   
              # provide name and uuid in addition to hostname for better correlation
              # to ceilometer data
              collectd::plugin::virt::hostname_format: "name uuid hostname"
   
              # to capture all extra_stats metrics, comment out below config
              collectd::plugin::virt::extra_stats: cpu_util vcpu disk
   
              # provide the human-friendly name of the virtual instance
              collectd::plugin:ConfigMap :virt::plugin_instance_format: metadata
   
              # set memcached collectd plugin to report its metrics by hostname
              # rather than host IP, ensuring metrics in the dashboard remain uniform
              collectd::plugin::memcached::instances:
                local:
                  host: "%{hiera('fqdn_canonical')}"
                  port: 11211
   
              # report root filesystem storage metrics
              collectd::plugin::df::ignoreselected: false

手順

1. RHOSP director Operator がデプロイされている Red Hat OpenShift Container Platform 環境にログインし、RHOSP デプロイメントをホストするプロジェクトに変更します。

   $ oc project openstack

2. heat-env-config-deploy ConfigMap を開いて編集します。

   $ oc edit configmap heat-env-config-deploy

3. 環境に適切な stf-connectors.yaml 設定を heat-env-config-deploy ConfigMap に追加し、編集内容を保存してファイルを閉じます。

   stf-connectors.yaml

   apiVersion: v1
   data:
     [...]
     stf-connectors.yaml: |
       resource_registry:
         OS::TripleO::Services::Collectd: /usr/share/openstack-tripleo-heat-templates/deployment/metrics/collectd-container-puppet.yaml
   
       parameter_defaults:
           MetricsQdrConnectors:
               - host: default-interconnect-5671-service-telemetry.apps.ostest.test.metalkube.org
                 port: 443
                 role: edge
                 verifyHostname: false
                 sslProfile: sslProfile
                 saslUsername: guest@default-interconnect
                 saslPassword: <password_from_stf>
   
           MetricsQdrSSLProfiles:
               - name: sslProfile
   
           CeilometerQdrMetricsConfig:
               driver: amqp
               topic: cloud1-metering
   
           CollectdAmqpInstances:
               cloud1-telemetry:
                   format: JSON
                   presettle: false
   
           CollectdSensubilityResultsChannel: sensubility/cloud1-telemetry

   • 複数のクラウドデプロイメント用に collectd-write-qdr.yaml 環境ファイルを含めないため、resource_registry 設定は collectd サービスを直接ロードします。
   • MetricsQdrConnectors の host サブパラメーターを、「AMQ Interconnect ルートアドレスの取得」 で取得した値に置き換えます。
   • MetricsQdrConnectors の saslPassword サブパラメーターの <password_from_stf> 部分を、「AMQ Interconnect のパスワードの取得」 で取得した値に置き換えます。
   • caCertFileContent パラメーターを、「オーバークラウドの設定向け Service Telemetry Framework からの CA 証明書の取得」 で取得したコンテンツに置き換えます。
   • CeilometerQdrMetricsConfig.topic の topic 値を設定して、Ceilometer メトリクスのトピックを定義します。値は、cloud1-metering などのクラウドの一意のトピック識別子です。
   • CollectdAmqpInstances サブパラメーターを設定して、collectd メトリクスのトピックを定義します。セクション名は、cloud1-telemetry などのクラウドの一意のトピック識別子です。
   • CollectdSensubilityResultsChannel を設定して、collectd-sensubility イベントのトピックを定義します。値は、sensubility/cloud1-telemetry などのクラウドの一意のトピック識別子です。

手順

1. RHOSP director Operator がデプロイされている Red Hat OpenShift Container Platform 環境にログインし、RHOSP デプロイメントをホストするプロジェクトに変更します。

   $ oc project openstack

2. OpenStackConfigGenerator カスタムリソースを、編集するために開きます。

   $ oc edit OpenStackConfigGenerator

3. heatEnvs パラメーターの値として、metrics/ceilometer-write-qdr.yaml および metrics/qdr-edge-only.yaml 環境ファイルを追加します。編集内容を保存し、OpenStackConfigGenerator カスタムリソースを閉じます。

   注記

   すでに director Operator を使用して Red Hat OpenStack Platform 環境をデプロイしている場合は、OpenStackConfigVersion を再生成するために、既存の OpenStackConfigGenerator を削除し、完全な設定で新しいオブジェクトを作成する必要があります。

   OpenStackConfigGenerator

   apiVersion: osp-director.openstack.org/v1beta1
   kind: OpenStackConfigGenerator
   metadata:
     name: default
     namespace: openstack
   spec:
     heatEnvConfigMap: heat-env-config-deploy
     heatEnvs:
     - <existing_environment_file_references>
     - metrics/ceilometer-write-qdr.yaml
     - metrics/qdr-edge-only.yaml

4. すでに director Operator を使用して Red Hat OpenStack Platform 環境をデプロイし、新しい OpenStackConfigVersion を生成している場合は、デプロイメントの OpenStackDeploy オブジェクトを編集し、spec.configVersion の値を新しい OpenStackConfigVersion に設定してオーバークラウドデプロイメントを更新します。

手順

1. STF がホストされている Red Hat OpenShift Container Platform 環境にログインします。

2. Community-operators CatalogSource を使用して、Grafana Operator を購読します。

   警告

   コミュニティーオペレーターは、Red Hat による精査または検証を受けていないオペレーターです。コミュニティーオペレーターは安定性が不明であるため、注意して使用する必要があります。Red Hat は、Community Operator のサポートを提供しません。

   Red Hat のサードパーティーソフトウェアサポートポリシーの詳細は、こちらをご覧ください。

   $ oc apply -f - <<EOF
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     labels:
       operators.coreos.com/grafana-operator.openshift-operators: ""
     name: grafana-operator
     namespace: openshift-operators
   spec:
     channel: v5
     installPlanApproval: Automatic
     name: grafana-operator
     source: community-operators
     sourceNamespace: openshift-marketplace
   EOF

3. Operator が正常に起動したことを確認します。コマンド出力で、PHASE 列の値が Succeeded の場合には、Operator は正常に起動されています。

   $ oc wait --for jsonpath="{.status.phase}"=Succeeded csv --namespace openshift-operators -l operators.coreos.com/grafana-operator.openshift-operators
   
   clusterserviceversion.operators.coreos.com/grafana-operator.v5.6.0 condition met

4. Grafana インスタンスを起動するには、ServiceTelemetry オブジェクトを作成または変更します。graphing.enabled および graphing.grafana.ingressEnabled を true に設定します。オプションで、graphing.grafana.baseImage の値を、デプロイされる Grafana ワークロードコンテナーイメージに設定します。

   $ oc edit stf default
   
   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   ...
   spec:
     ...
     graphing:
       enabled: true
       grafana:
         ingressEnabled: true
         baseImage: 'registry.redhat.io/rhel8/grafana:9'

5. Grafana インスタンスがデプロイされたことを確認します。

   $ oc wait --for jsonpath="{.status.phase}"=Running pod -l app=default-grafana --timeout=600s
   
   pod/default-grafana-deployment-669968df64-wz5s2 condition met

6. Grafana のデータソースが正しくインストールされたことを確認します。

   $ oc get grafanadatasources.grafana.integreatly.org
   
   NAME                        NO MATCHING INSTANCES   LAST RESYNC   AGE
   default-ds-stf-prometheus                           2m35s         2m56s

7. Grafana のルートが存在することを確認します。

   $ oc get route default-grafana-route
   
   NAME                    HOST/PORT                                                   PATH   SERVICES                  PORT   TERMINATION   WILDCARD
   default-grafana-route   default-grafana-route-service-telemetry.apps.infra.watch           default-grafana-service   web    reencrypt     None

手順

1. 管理対象のダッシュボードを有効にするには、ServiceTelemetry オブジェクトを作成または変更します。graphing.grafana.dashboards.enabled を true に設定します。

   $ oc edit stf default
   
   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   ...
   spec:
     ...
     graphing:
       enabled: true
       grafana:
         dashboards:
           enabled: true

2. Grafana ダッシュボードが作成されたことを確認します。Service Telemetry Operator がダッシュボードを作成するプロセスには、時間がかかる場合があります。

   $ oc get grafanadashboards.grafana.integreatly.org
   
   NAME                          NO MATCHING INSTANCES   LAST RESYNC   AGE
   memcached-dashboard-1                                 38s           38s
   rhos-cloud-dashboard-1                                39s           39s
   rhos-dashboard-1                                      39s           39s
   virtual-machine-dashboard-1                           37s           37s

3. Grafana のルートアドレスを取得します。

   $ oc get route default-grafana-route -ojsonpath='{.spec.host}'
   
   default-grafana-route-service-telemetry.apps.infra.watch

4. Web ブラウザーで、https://<grafana_route_address> に移動します。<grafana_route_address> は、直前の手順で取得した値に置き換えます。
5. OpenShift 認証情報を使用してログインします。ログインの詳細は、「STF コンポーネントのユーザーインターフェイスへのアクセス」 を参照してください。
6. ダッシュボードを表示するには、Dashboards および Browse をクリックします。管理対象のダッシュボードは、service-telemetry フォルダーで利用できます。

手順

1. Red Hat OpenShift Container Platform にログインします。

2. service-telemetry namespace に切り替えます。

   $ oc project service-telemetry

3. stf-prometheus-reader サービスアカウントの新しいトークンシークレットを作成します。

   $ oc create -f - <<EOF
   apiVersion: v1
   kind: Secret
   metadata:
     name: my-prometheus-reader-token
     namespace: service-telemetry
     annotations:
       kubernetes.io/service-account.name: stf-prometheus-reader
   type: kubernetes.io/service-account-token
   EOF

4. シークレットからトークンを取得します。

   $ TOKEN=$(oc get secret my-prometheus-reader-token -o template='{{.data.token}}' | base64 -d)

5. Prometheus のホスト名を取得します。

   $ PROM_HOST=$(oc get route default-prometheus-proxy -ogo-template='{{ .spec.host }}')

6. アクセストークンをテストします。

   $ curl -k -H "Authorization: Bearer ${TOKEN}" https://${PROM_HOST}/api/v1/query?query=up
   
   {"status":"success",[...]

7. 上記の PROM_HOST および TOKEN 値を使用して、サードパーティーツールを設定します。

   $ echo $PROM_HOST
   $ echo $TOKEN

8. トークンは、シークレットが存在する限り有効です。シークレットを削除すると、トークンを取り消すことができます。

   $ oc delete secret my-prometheus-reader-token
   secret "my-prometheus-reader-token" deleted

手順

1. Red Hat OpenShift Container Platform にログインします。

2. service-telemetry namespace に切り替えます。

   $ oc project service-telemetry

3. ServiceTelemetry オブジェクトを編集します。

   $ oc edit stf default

4. retention: 7d を backends.metrics.prometheus.storage の storage セクションに追加し、保持期間を 7 日間増やします。

   注記

   保持期間を長く設定すると、設定された Prometheus システムからデータを取得すると、クエリーで結果の速度が遅くなる可能性があります。

   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   metadata:
     name: default
     namespace: service-telemetry
   spec:
     ...
     backends:
       metrics:
         prometheus:
           enabled: true
           storage:
             strategy: persistent
             retention: 7d
       ...

5. 変更内容を保存し、オブジェクトを閉じます。

6. 新しい設定で prometheus が再起動されるまで待ちます。

   $ oc get po -l app.kubernetes.io/name=prometheus -w

7. Pod で使用されているコマンドライン引数をチェックして、新しい保持設定を確認します。

   $ oc describe po prometheus-default-0 | grep retention.time
         --storage.tsdb.retention.time=24h

手順

1. Red Hat OpenShift Container Platform にログインします。

2. service-telemetry namespace に切り替えます。

   $ oc project service-telemetry

3. アラートルールを含む PrometheusRule オブジェクトを作成します。Prometheus Operator は、ルールを Prometheus に読み込みます。

   $ oc apply -f - <<EOF
   apiVersion: monitoring.rhobs/v1
   kind: PrometheusRule
   metadata:
     creationTimestamp: null
     labels:
       prometheus: default
       role: alert-rules
     name: prometheus-alarm-rules
     namespace: service-telemetry
   spec:
     groups:
       - name: ./openstack.rules
         rules:
           - alert: Collectd metrics receive rate is zero
             expr: rate(sg_total_collectd_msg_received_count[1m]) == 0
   EOF

   ルールを変更するには、expr パラメーターの値を編集します。

4. Operator がルールを Prometheus に読み込んだことを確認するには、Basic 認証で default-prometheus-proxy ルートに対して curl コマンドを実行します。

   $ curl -k -H "Authorization: Bearer $(oc create token stf-prometheus-reader)" https://$(oc get route default-prometheus-proxy -ogo-template='{{ .spec.host }}')/api/v1/rules
   
   {"status":"success","data":{"groups":[{"name":"./openstack.rules","file":"/etc/prometheus/rules/prometheus-default-rulefiles-0/service-telemetry-prometheus-alarm-rules.yaml","rules":[{"state":"inactive","name":"Collectd metrics receive count is zero","query":"rate(sg_total_collectd_msg_received_count[1m]) == 0","duration":0,"labels":{},"annotations":{},"alerts":[],"health":"ok","evaluationTime":0.00034627,"lastEvaluation":"2021-12-07T17:23:22.160448028Z","type":"alerting"}],"interval":30,"evaluationTime":0.000353787,"lastEvaluation":"2021-12-07T17:23:22.160444017Z"}]}}

手順

1. oc edit コマンドを使用します。

   $ oc edit prometheusrules.monitoring.rhobs prometheus-alarm-rules

2. PrometheusRules マニフェストを編集します。
3. マニフェストを保存し、終了します。

手順

1. Red Hat OpenShift Container Platform にログインします。

2. service-telemetry namespace に切り替えます。

   $ oc project service-telemetry

3. STF デプロイメントの ServiceTelemetry オブジェクトを編集します。

   $ oc edit stf default

4. 新規パラメーター alertmanagerConfigManifest および Secret オブジェクトの内容を追加し、Alertmanager の alertmanager.yaml 設定を定義します。

   注記

   この手順では、Service Telemetry Operator が管理するデフォルトのテンプレートを読み込みます。変更が正しく入力されていることを確認するには、値を変更して alertmanager-default シークレットを返し、新しい値がメモリーに読み込まれていることを確認します。たとえば、パラメーター global.resolve_timeout の値を 5m から 10m に変更します。

   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   metadata:
     name: default
     namespace: service-telemetry
   spec:
     backends:
       metrics:
         prometheus:
           enabled: true
     alertmanagerConfigManifest: |
       apiVersion: v1
       kind: Secret
       metadata:
         name: 'alertmanager-default'
         namespace: 'service-telemetry'
       type: Opaque
       stringData:
         alertmanager.yaml: |-
           global:
             resolve_timeout: 10m
           route:
             group_by: ['job']
             group_wait: 30s
             group_interval: 5m
             repeat_interval: 12h
             receiver: 'null'
           receivers:
           - name: 'null'

5. 設定がシークレットに適用されたことを確認します。

   $ oc get secret alertmanager-default -o go-template='{{index .data "alertmanager.yaml" | base64decode }}'
   
   global:
     resolve_timeout: 10m
   route:
     group_by: ['job']
     group_wait: 30s
     group_interval: 5m
     repeat_interval: 12h
     receiver: 'null'
   receivers:
   - name: 'null'

6. Prometheus Pod から alertmanager-proxy サービスに対して wget コマンドを実行して、ステータスと configYAML の内容を取得し、提供された設定が Alertmanager の設定と一致することを確認します。

   $ oc exec -it prometheus-default-0 -c prometheus -- sh -c "wget --header \"Authorization: Bearer \$(cat /var/run/secrets/kubernetes.io/serviceaccount/token)\" https://default-alertmanager-proxy:9095/api/v1/status -q -O -"
   
   {"status":"success","data":{"configYAML":"...",...}}

7. configYAML フィールドに予想される変更が含まれることを確認します。

手順

1. Red Hat OpenShift Container Platform にログインします。

2. service-telemetry namespace に切り替えます。

   $ oc project service-telemetry

3. 次の例のように、alertmanager.yaml というファイルに必要な alertmanager 設定を作成します。

   $ cat > alertmanager.yaml <<EOF
   global:
     resolve_timeout: 10m
     slack_api_url: <slack_api_url>
   receivers:
     - name: slack
       slack_configs:
       - channel: #stf-alerts
         title: |-
           ...
         text: >-
           ...
   route:
     group_by: ['job']
     group_wait: 30s
     group_interval: 5m
     repeat_interval: 12h
     receiver: 'slack'
   EOF

4. 設定マニフェストを生成して、STF デプロイメントの ServiceTelemetry オブジェクトに追加します。

   $ CONFIG_MANIFEST=$(oc create secret --dry-run=client generic alertmanager-default --from-file=alertmanager.yaml -o json)
   $ oc patch stf default --type=merge -p '{"spec":{"alertmanagerConfigManifest":'"$CONFIG_MANIFEST"'}}'

5. 設定がシークレットに適用されたことを確認します。

   注記

   operator が各オブジェクトを更新するため、少し時間がかかります。

   $ oc get secret alertmanager-default -o go-template='{{index .data "alertmanager.yaml" | base64decode }}'
   
   global:
     resolve_timeout: 10m
     slack_api_url: <slack_api_url>
   receivers:
     - name: slack
       slack_configs:
       - channel: #stf-alerts
         title: |-
           ...
         text: >-
           ...
   route:
     group_by: ['job']
     group_wait: 30s
     group_interval: 5m
     repeat_interval: 12h
     receiver: 'slack'

6. Prometheus Pod から alertmanager-proxy サービスに対して wget コマンドを実行して、ステータスと configYAML の内容を取得し、提供された設定が Alertmanager の設定と一致することを確認します。

   $ oc exec -it prometheus-default-0 -c prometheus -- /bin/sh -c "wget --header \"Authorization: Bearer \$(cat /var/run/secrets/kubernetes.io/serviceaccount/token)\" https://default-alertmanager-proxy:9095/api/v1/status -q -O -"
   
   {"status":"success","data":{"configYAML":"...",...}}

7. configYAML フィールドに予想される変更が含まれることを確認します。

手順

1. Red Hat OpenShift Container Platform にログインします。

2. service-telemetry namespace に切り替えます。

   $ oc project service-telemetry

3. SNMP トラップを有効にするには、ServiceTelemetry オブジェクトを変更します。

   $ oc edit stf default

4. alerting.alertmanager.receivers.snmpTraps パラメーターを設定します。

   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   ...
   spec:
     ...
     alerting:
       alertmanager:
         receivers:
           snmpTraps:
             enabled: true
             target: 10.10.10.10

5. target の値は、SNMP トラップレシーバーの IP アドレスまたはホスト名に設定するようにしてください。

手順

1. Red Hat OpenShift Container Platform にログインします。

2. service-telemetry namespace に切り替えます。

   $ oc project service-telemetry

3. アラートルールと SNMP トラップ OID オーバーライド値を含む oid ラベルを含む PrometheusRule オブジェクトを作成します。

   $ oc apply -f - <<EOF
   apiVersion: monitoring.rhobs/v1
   kind: PrometheusRule
   metadata:
     creationTimestamp: null
     labels:
       prometheus: default
       role: alert-rules
     name: prometheus-alarm-rules-snmp
     namespace: service-telemetry
   spec:
     groups:
       - name: ./openstack.rules
         rules:
           - alert: Collectd metrics receive rate is zero
             expr: rate(sg_total_collectd_msg_received_count[1m]) == 0
             labels:
               oid: 1.3.6.1.4.1.50495.15.1.2.1
               severity: critical
   EOF

手順

1. TLS 証明書の期間を編集するには、QDR caCertDuration を設定します (例: 10 年間の場合は 87600h)。

   $ oc apply -f - <<EOF
   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   metadata:
     name: default
     namespace: service-telemetry
   spec:
     transport:
       qdr:
         enabled: true
         certificates:
           caCertDuration: 87600h
   EOF

検証

1. 証明書の有効期限が正しいことを確認します。

   $ oc get secret  default-interconnect-selfsigned -o jsonpath='{.data.tls\.crt}' | base64 -d  | openssl x509 -in - -text | grep "Not After"
               Not After : Mar  9 21:00:16 2033 GMT

手順

1. Red Hat OpenShift Container Platform にログインします。

2. service-telemetry namespace に切り替えます。

   $ oc project service-telemetry

3. oc コマンドで ServiceTelemetry オブジェクトを編集します。

   $ oc edit stf default

4. highAvailability.enabled: true を spec セクションに追加します。

   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   ...
   spec:
     ...
     highAvailability:
       enabled: true

5. 変更内容を保存し、オブジェクトを閉じます。

手順

1. spec パラメーターに observabilityStrategy: none プロパティーを指定して ServiceTelemetry オブジェクトを作成します。マニフェストは、すべてのメトリクスコレクタータイプを持つ単一のクラウドから Telemetry を受け取るのに適した STF のデフォルトデプロイメントを示しています。

   $ oc apply -f - <<EOF
   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   metadata:
     name: default
     namespace: service-telemetry
   spec:
     observabilityStrategy: none
   EOF

2. コミュニティー Operator が管理する残りのオブジェクトを削除します。

   $ for o in alertmanagers.monitoring.rhobs/default prometheuses.monitoring.rhobs/default elasticsearch/elasticsearch grafana/default-grafana; do oc delete $o; done

3. すべてのワークロードが適切に動作していることを確認するには、Pod および各 Pod のステータスを確認します。

   $ oc get pods
   NAME                                                      READY   STATUS    RESTARTS   AGE
   default-cloud1-ceil-event-smartgateway-6f8547df6c-p2db5   3/3     Running   0          132m
   default-cloud1-ceil-meter-smartgateway-59c845d65b-gzhcs   3/3     Running   0          132m
   default-cloud1-coll-event-smartgateway-bf859f8d77-tzb66   3/3     Running   0          132m
   default-cloud1-coll-meter-smartgateway-75bbd948b9-d5phm   3/3     Running   0          132m
   default-cloud1-sens-meter-smartgateway-7fdbb57b6d-dh2g9   3/3     Running   0          132m
   default-interconnect-668d5bbcd6-57b2l                     1/1     Running   0          132m
   interconnect-operator-b8f5bb647-tlp5t                     1/1     Running   0          47h
   service-telemetry-operator-566b9dd695-wkvjq               1/1     Running   0          156m
   smart-gateway-operator-58d77dcf7-6xsq7                    1/1     Running   0          47h

手順

1. stf-connectors.yaml ファイルを開き、CollectdEnableLibpodstats パラメーターを追加して enable-stf.yaml の設定を上書きします。stf-connectors.yaml が、enable-stf.yaml の後に openstack overcloud deploy コマンドから呼び出されていることを確認します。

     CollectdEnableLibpodstats: false

2. オーバークラウドの導入手順を続行します。詳細は、「オーバークラウドのデプロイ」 を参照してください。

手順

1. stf-connectors.yaml を開き、CollectdEnableSensubility パラメーターを追加して enable-stf.yaml の設定を上書きします。stf-connectors.yaml が、enable-stf.yaml の後に openstack overcloud deploy コマンドから呼び出されていることを確認します。

   CollectdEnableSensubility: false

2. オーバークラウドの導入手順を続行します。詳細は、「オーバークラウドのデプロイ」 を参照してください。