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

手順

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

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

   $ oc project service-telemetry

   Copy to Clipboard Toggle word wrap

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

   警告

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

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

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

   Copy to Clipboard Toggle word wrap

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

   $ oc get csv --selector operators.coreos.com/grafana-operator.service-telemetry
   
   NAME                       DISPLAY            VERSION   REPLACES                   PHASE
   grafana-operator.v4.10.1   Grafana Operator   4.10.1    grafana-operator.v4.10.0   Succeeded

   Copy to Clipboard Toggle word wrap

5. 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:7'

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   $ oc get grafanadatasources
   
   NAME                    AGE
   default-datasources     20h

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

手順

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

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

   Copy to Clipboard Toggle word wrap

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"}}}}'

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

手順

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

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

   Copy to Clipboard Toggle word wrap

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/rhos-cloud-dashboard.yaml
   
   grafanadashboard.integreatly.org/rhos-cloud-dashboard-1 created

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   $ oc get grafanadashboards
   
   NAME                         AGE
   memcached-dashboard-1        7s
   rhos-cloud-dashboard-1       23s
   rhos-cloudevents-dashboard   18s
   rhos-dashboard-1             29s
   virtual-machine-view-1       13s

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap
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

   Copy to Clipboard Toggle word wrap

3. STF オブジェクトから既存のユーザー名とパスワードを取得します。

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

   Copy to Clipboard Toggle word wrap

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

   $ oc edit stf default

   Copy to Clipboard Toggle word wrap

5. 新しい認証情報を設定して grafana Pod が再起動するまで待ちます。

   $ oc get po -l app=grafana -w

   Copy to Clipboard Toggle word wrap