第 6 章 使用 Service Telemetry Framework 的操作功能

流程

1. 登录到托管 STF 的 Red Hat OpenShift Container Platform 环境。

2. 使用 community-operators CatalogSource 订阅 Grafana Operator：

   警告

   社区 Operator 是尚未被红帽审查或验证的 Operator。社区 Operator 应谨慎使用，因为其稳定性未知。红帽不支持社区 Operator。

   了解更多有关红帽的第三方软件支持政策

   $ 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 凭据登录。有关登录的详情请参考 第 3.3 节 “访问 STF 组件的用户界面”。
6. 要查看仪表板，请点 Dashboards 和 Browse。受管仪表板位于 service-telemetry 文件夹中。

流程

1. 登录到 Red Hat OpenShift Container Platform。

2. 进入 service-telemetry 命名空间：

   $ oc project service-telemetry

3. 为 stf-prometheus-reader 服务帐户创建新令牌 secret

   $ 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. 从 secret 检索令牌

   $ 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. 只要 secret 存在，令牌就会保持有效。您可以通过删除 secret 来撤销令牌。

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