第5章 Service Telemetry Framework の運用機能の使用

手順

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

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

   $ oc project service-telemetry

3. Grafana オペレーターをデプロイします。

   $ 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 プラグイン を参照してください。

   $ 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. STF オブジェクトからデフォルトのユーザー名とパスワードを取得します。

   $ oc get stf default -o jsonpath="{.spec.graphing.grafana['adminUser','adminPassword']}"

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