手順

1. oc delete コマンドを実行します。

   $ oc delete project service-telemetry

2. リソースが namespace から削除されていることを確認します。

   $ oc get all
   No resources found.

手順

1. インストールの処理時に OperatorHub.io Community Catalog Source を有効にし、このカタログソースが必要なくなった場合は削除します。

   $ oc delete --namespace=openshift-marketplace catalogsource operatorhubio-operators
   catalogsource.operators.coreos.com "operatorhubio-operators" deleted

手順

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

2. service-telemetry プロジェクトで、AMQ Interconnect ルートアドレスを取得します。

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

手順

1. Red Hat OpenStack Platform ({OpenStackShort}) アンダークラウドに stack ユーザーとしてログオンします。

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

   重要

   EventPipelinePublishers および PipelinePublishers を空白の一覧として設定すると、Gnocchi や Panko などの {OpenStackShort} のレガシー Telemetry コンポーネントにイベントやメトリックデータが渡されません。データを追加のパイプラインに送信する必要がある場合に、ExtraConfig で指定されるように Ceilometer のポーリングを 30 秒間隔でを行うと、レガシーコンポーネントに過剰な負荷をかける可能性があるため、間隔を 300 などの大きな値に増やす必要があります。ポーリング間隔の値を増やすと、STF の Telemetry 解決が少なくなります。

   STF および Gnocchi を使用して Telemetry のコレクションを有効にする場合は、「Gnocchi および Service Telemetry Framework へのメトリックの送信」を参照してください。

手順

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

3. stf-connectors.yaml ファイルで、オーバークラウド上の AMQ Interconnect を STF デプロイメントに接続するように MetricsQdrConnectors アドレスを設定します。

   • host パラメーターは、「AMQ Interconnect ルートアドレスの取得」 で取得した HOST/PORT の値に置き換えます。

   parameter_defaults:
       MetricsQdrConnectors:
       - host: default-interconnect-5671-service-telemetry.apps.infra.watch
         port: 443
         role: edge
         sslProfile: sslProfile
         verifyHostname: false
   
       MetricsQdrSSLProfiles:
       -   name: sslProfile

手順

1. Red Hat OpenStack Platform ({OpenStackShort}) アンダークラウドに stack ユーザーとしてログオンします。

2. source コマンドで認証ファイルを読み込みます。

   [stack@undercloud-0 ~]$ source stackrc
   
   (undercloud) [stack@undercloud-0 ~]$

3. 以下のファイルを {OpenStackShort} director デプロイメントに追加して、データ収集および AMQ Interconnect を設定します。

   • collectd Telemetry およびイベントが STF に送信されることを確認する collectd-write-qdr.yaml ファイル
   • Ceilometer Telemetry およびイベントが STF に送信されることを確認する ceilometer-write-qdr.yaml ファイル
   • メッセージバスが有効で、STF メッセージバスルーターに接続されていることを確認する qdr-edge-only.yaml ファイル
   • デフォルト値が正しく設定されていることを確認する enable-stf.yaml 環境ファイル

   • STF への接続を定義する stf-connectors.yaml 環境ファイル

     (undercloud) [stack@undercloud-0 ~]$ openstack overcloud deploy <other_arguments>
     --templates /usr/share/openstack-tripleo-heat-templates \
       --environment-file <...other_environment_files...> \
       --environment-file /usr/share/openstack-tripleo-heat-templates/environments/metrics/ceilometer-write-qdr.yaml \
       --environment-file /usr/share/openstack-tripleo-heat-templates/environments/metrics/collectd-write-qdr.yaml \
       --environment-file /usr/share/openstack-tripleo-heat-templates/environments/metrics/qdr-edge-only.yaml \
       --environment-file /home/stack/enable-stf.yaml \
       --environment-file /home/stack/stf-connectors.yaml

4. オーバークラウドをデプロイします。

手順

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

2. metrics_qdr コンテナーがノードで実行されていることを確認します。

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

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 Interconnect への接続一覧を返します。

   $ 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 Interconnect に対するクライアント接続の内部ネットワークアドレスです。

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. {OpenStackShort} ノードから 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 に接続し、既知の接続を一覧表示します。この例では、OpenStackShort} ノードからの edge 接続として、接続 id 22、23、および 24 の 3 つがあります。

   $ oc exec -it default-interconnect-7458fd4d69-bgzfb -- 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 default-interconnect-7458fd4d69-bgzfb -- 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. Operator が Smart Gateways を削除していることを確認します。これは、Operator による変更の調整に数分かかる場合があります。

   $ oc get smartgateways

手順

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

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

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

3. 新しい環境ファイルをデプロイメントに追加します。詳しい情報は、『Overcloud Parameters』の 「複数クラウドの Red Hat OpenStack Platform 環境ファイルの作成」 および「Core overcloud parameters」を参照してください。

手順

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

3. stf-connectors.yaml ファイルで、オーバークラウドデプロイメント上の AMQ Interconnect をに接続するように MetricsQdrConnectors アドレスを設定します。CeilometerQdrEventsConfig、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    1
   
   parameter_defaults:
       MetricsQdrConnectors:
           - host: stf-default-interconnect-5671-service-telemetry.apps.infra.watch   2
             port: 443
             role: edge
             verifyHostname: false
             sslProfile: sslProfile
   
       MetricsQdrSSLProfiles:
           - name: sslProfile
   
       CeilometerQdrEventsConfig:
           driver: amqp
           topic: cloud1-event   3
   
       CeilometerQdrMetricsConfig:
           driver: amqp
           topic: cloud1-metering   4
   
       CollectdAmqpInstances:
           cloud1-notify:        5
               notify: true
               format: JSON
               presettle: false
           cloud1-telemetry:     6
               format: JSON
               presettle: false
   
       CollectdSensubilityResultsChannel: sensubility/cloud1-telemetry 7

   1

   複数のクラウドデプロイメント向けの collectd-write-qdr.yaml 環境ファイルが追加されていないので、collectd サービスを直接読み込みます。

   2

   host パラメーターは、「AMQ Interconnect ルートアドレスの取得」 で取得した HOST/PORT の値に置き換えます。

   3

   Ceilometer イベントのトピックを定義します。この値は、anycast/ceilometer/cloud1-event.sample のアドレス形式です。

   4

   Ceilometer メトリクスのトピックを定義します。この値は、anycast/ceilometer/cloud1-metering.sample のアドレス形式です。

   5

   collectd イベントのトピックを定義します。この値は、collectd/cloud1-notify の形式になります。

   6

   collectd メトリクスのトピックを定義します。この値は、collectd/cloud1-telemetry の形式になります。

   7

   collectd-sensubility イベントのトピックを定義します。この値は、正確な文字列形式 (sensubility/cloud1-telemetry) であることを確認します。

4. stf-connectors.yaml ファイルの命名規則が、Smart Gateway 設定の spec.bridge.amqpUrl フィールドと一致していることを確認します。たとえば、CeilometerQdrEventsConfig.topic フィールドを cloud1-event の値に設定します。

5. source コマンドで認証ファイルを読み込みます。

   [stack@undercloud-0 ~]$ source stackrc
   
   (undercloud) [stack@undercloud-0 ~]$

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

   警告

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

   (undercloud) [stack@undercloud-0 ~]$ openstack overcloud deploy <other_arguments>
   --templates /usr/share/openstack-tripleo-heat-templates \
     --environment-file <...other_environment_files...> \
     --environment-file /usr/share/openstack-tripleo-heat-templates/environments/metrics/ceilometer-write-qdr.yaml \
     --environment-file /usr/share/openstack-tripleo-heat-templates/environments/metrics/qdr-edge-only.yaml \
     --environment-file /home/stack/hostnames.yaml \
     --environment-file /home/stack/enable-stf.yaml \
     --environment-file /home/stack/stf-connectors.yaml

7. Red Hat OpenStack Platform オーバークラウドをデプロイします。

手順

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

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

   $ oc project service-telemetry

3. Grafana Operator をデプロイします。

   $ oc apply -f - <<EOF
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: grafana-operator
     namespace: service-telemetry
   spec:
     channel: alpha
     installPlanApproval: Automatic
     name: grafana-operator
     source: operatorhubio-operators
     sourceNamespace: openshift-marketplace
   EOF

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

   $ oc get csv --selector operators.coreos.com/grafana-operator.service-telemetry
   
   NAME                       DISPLAY            VERSION   REPLACES                   PHASE
   grafana-operator.v3.10.3   Grafana Operator   3.10.3    grafana-operator.v3.10.2   Succeeded

5. Grafana インスタンスを起動するには、ServiceTelemetry オブジェクトを作成または変更します。graphing.enabled および graphing.grafana.ingressEnabled を true に設定します。

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

6. Grafana インスタンスがデプロイされていることを確認します。

   $ oc get pod -l app=grafana
   
   NAME                                  READY   STATUS    RESTARTS   AGE
   grafana-deployment-7fc7848b56-sbkhv   1/1     Running   0          1m

7. Grafana データソースが正しくインストールされていることを確認します。

   $ oc get grafanadatasources
   
   NAME                    AGE
   default-datasources     20h

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

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

手順

1. Grafana の正しいバージョンがあることを確認します。

   $ oc get pod -l "app=grafana" -ojsonpath='{.items[0].spec.containers[0].image}'
   docker.io/grafana/grafana:7.3.10

2. 実行中のイメージが 8.1.0 よりも古い場合は、ServiceTelemetry オブジェクトにパッチを適用してイメージを更新します。Service Telemetry Operator は、Grafana デプロイメントを再起動する Grafana マニフェストを更新します。

   $ oc patch stf/default --type merge -p '{"spec":{"graphing":{"grafana":{"baseImage":"docker.io/grafana/grafana:8.1.5"}}}}'

3. 新しい Grafana Pod が存在し、Running の値が STATUS であることを確認します。

   $ oc get pod -l "app=grafana"
   NAME                                 READY     STATUS    RESTARTS   AGE
   grafana-deployment-fb9799b58-j2hj2   1/1       Running   0          10s

4. 新規インスタンスが更新されたイメージを実行していることを確認します。

   $ oc get pod -l "app=grafana" -ojsonpath='{.items[0].spec.containers[0].image}'
   docker.io/grafana/grafana:8.1.0

手順

1. インフラストラクチャーダッシュボードをインポートします。

   $ oc apply -f https://raw.githubusercontent.com/infrawatch/dashboards/master/deploy/stf-1.3/rhos-dashboard.yaml
   
   grafanadashboard.integreatly.org/rhos-dashboard-1.3 created

2. クラウドダッシュボードをインポートします。

   警告

   クラウドダッシュボードの一部のパネルについては、stf-connectors.yaml ファイルで collectd virt プラグインパラメーター hostname_format の値を name uuid hostname に設定する必要があります。このパラメーターを設定しない場合には、影響を受けるダッシュボードは空のままになります。Virt プラグインの詳細は、「 collectd plugins 」を参照してください。

   $ oc apply -f https://raw.githubusercontent.com/infrawatch/dashboards/master/deploy/stf-1.3/rhos-cloud-dashboard.yaml
   
   grafanadashboard.integreatly.org/rhos-cloud-dashboard-1.3 created

3. クラウドイベントダッシュボードをインポートします。

   $ oc apply -f https://raw.githubusercontent.com/infrawatch/dashboards/master/deploy/stf-1.3/rhos-cloudevents-dashboard.yaml
   
   grafanadashboard.integreatly.org/rhos-cloudevents-dashboard created

4. 仮想マシンダッシュボードをインポートします。

   $ oc apply -f https://raw.githubusercontent.com/infrawatch/dashboards/master/deploy/stf-1.3/virtual-machine-view.yaml
   
   grafanadashboard.integreatly.org/virtual-machine-view-1.3 configured

5. memcached ダッシュボードをインポートします。

   $ oc apply -f https://raw.githubusercontent.com/infrawatch/dashboards/master/deploy/stf-1.3/memcached-dashboard.yaml
   
   grafanadashboard.integreatly.org/memcached-dashboard-1.3 created

6. ダッシュボードが利用可能であることを確認します。

   $ oc get grafanadashboards
   
   NAME                   AGE
   memcached-dashboard-1.3      115s
   rhos-cloud-dashboard-1.3     2m12s
   rhos-cloudevents-dashboard   2m6s
   rhos-dashboard-1.3           2m17s
   virtual-machine-view-1.3     2m

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

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

8. Web ブラウザーで、https://<grafana_route_address> に移動します。<grafana_route_address> は、直前の手順で取得した値に置き換えます。
9. ダッシュボードを表示するには、Dashboards と Manage をクリックします。

手順

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

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

   $ oc project service-telemetry

3. デフォルトのユーザー名とパスワードを取得するには、Grafana オブジェクトを記述します。

   $ oc describe grafana default

4. ServiceTelemetry オブジェクトを介して Grafana 管理者のユーザー名およびパスワードのデフォルト値を変更するには、graphing.grafana.adminUser および graphing.grafana.adminPassword パラメーターを使用します。

手順

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: stf-default
     namespace: service-telemetry
   spec:
     ...
     backends:
       metrics:
         prometheus:
           enabled: true
           storage:
             strategy: persistent
             retention: 7d
       ...

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

手順

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.coreos.com/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: Metric Listener down
             expr: collectd_qpid_router_status < 1 1
   EOF

   1

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

4. Operator がルールを Prometheus に読み込んだことを確認するには、curl にアクセスできる Pod を作成します。

   $ oc run curl --generator=run-pod/v1 --image=radial/busyboxplus:curl -i --tty

5. curl コマンドを実行して prometheus-operated サービスにアクセスし、メモリーに読み込まれるルールを返します。

   [ root@curl:/ ]$ curl prometheus-operated:9090/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":[{"name":"Metric Listener down","query":"collectd_qpid_router_status \u003c 1","duration":0,"labels":{},"annotations":{},"alerts":[],"health":"ok","type":"alerting"}],"interval":30}]}}

6. 出力に Pod から定義された ./openstack.rules が含まれるかなど、出力に PrometheusRule オブジェクトに読み込まれるルールが表示されることを確認するには、Pod を終了します。

   [ root@curl:/ ]$ exit

7. curl Pod を削除して環境を消去します。

   $ oc delete pod curl
   
   pod "curl" deleted

手順

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

   $ oc edit prometheusrules 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. 設定が Alertmanager にロードされたことを確認するには、curl にアクセスできる Pod を作成します。

   $ oc run curl --generator=run-pod/v1 --image=radial/busyboxplus:curl -i --tty

7. alertmanager-operated サービスに対して curl を実行し、ステータスと configYAML の内容を取得し、提供された設定が Alertmanager の設定と一致することを確認します。

   [ root@curl:/ ]$ curl alertmanager-operated:9093/api/v1/status
   
   {"status":"success","data":{"configYAML":"global:\n  resolve_timeout: 10m\n  http_config: {}\n  smtp_hello: localhost\n  smtp_require_tls: true\n  pagerduty_url: https://events.pagerduty.com/v2/enqueue\n  hipchat_api_url: https://api.hipchat.com/\n  opsgenie_api_url: https://api.opsgenie.com/\n  wechat_api_url: https://qyapi.weixin.qq.com/cgi-bin/\n  victorops_api_url: https://alert.victorops.com/integrations/generic/20131114/alert/\nroute:\n  receiver: \"null\"\n  group_by:\n  - job\n  group_wait: 30s\n  group_interval: 5m\n  repeat_interval: 12h\nreceivers:\n- name: \"null\"\ntemplates: []\n",...}}

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

9. Pod を終了します。

   [ root@curl:/ ]$ exit

10. 環境を消去するには、curl Pod を削除します。

    $ oc delete pod curl
    
    pod "curl" deleted

手順

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. Red Hat OpenShift Container Platform にログインします。

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

   $ oc project service-telemetry

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

   $ oc edit stf default

4. ...storage.strategy: ephemeral パラメーターを関連コンポーネントの spec セクションに追加します。

   apiVersion: infra.watch/v1beta1
   kind: ServiceTelemetry
   metadata:
     name: stf-default
     namespace: service-telemetry
   spec:
     alerting:
       enabled: true
       alertmanager:
         storage:
           strategy: ephemeral
     backends:
       metrics:
         prometheus:
           enabled: true
           storage:
             strategy: ephemeral
       events:
         elasticsearch:
           enabled: true
           storage:
             strategy: ephemeral

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

手順

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

     CollectdEnableLibpodstats: false

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

手順

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

   CollectdEnableSensubility: false

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