流程

1. 查看 Service Telemetry Framework 中的可用证书列表：

   $ oc get secrets

2. 检索并记录 default-interconnect-selfsigned Secret 的内容：

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

流程

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. 以 stack 用户身份登录 Red Hat OpenStack Platform (RHOSP) undercloud。

2. 在 /home/stack 目录中创建一个名为 enable-stf.yaml 的配置文件。

   重要

   将 EventPipelinePublishers 和 PipelinePublishers 设置为空列表会导致事件或指标数据传递到 RHOSP 遥测组件，如 Gnocchi 或 Panko。如果您需要将数据发送到其他管道，CeiloConfig 轮询间隔为 30 秒（如 ExtraConfig 中所指定）可能会导致 RHOSP 遥测组件，且您必须将间隔增加到更大值，如 300。将该值增大到较长的轮询间隔会导致 STF 中的遥测分辨率减少。

   enable-stf.yaml

   parameter_defaults:
       # only send to STF, not other publishers
       EventPipelinePublishers: []
       PipelinePublishers: []
   
       # manage the polling and pipeline configuration files for Ceilometer agents
       ManagePolling: true
       ManagePipeline: true
   
       # enable Ceilometer metrics and events
       CeilometerQdrPublishMetrics: true
       CeilometerQdrPublishEvents: true
   
       # set collectd overrides for higher telemetry resolution and extra plugins to load
       CollectdConnectionType: amqp1
       CollectdAmqpInterval: 5
       CollectdDefaultPollingInterval: 5
       CollectdExtraPlugins:
       - vmem
   
       # set standard prefixes for where metrics and events 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
           - disk.*
           - ip.*
           - image.*
           - memory
           - memory.*
           - network.*
           - perf.*
           - port
           - port.*
           - switch
           - switch.*
           - storage.*
           - volume.*
   
           # to avoid filling the memory buffers if disconnected from the message bus
           # note: Adjust the value of the `send_queue_limit` to handle your required volume of metrics.
           collectd::plugin::amqp1::send_queue_limit: 5000
   
           # receive extra information about virtual memory
           collectd::plugin::vmem::verbose: true
   
           # 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
   
           # align defaults across OSP versions
           collectd::plugin::cpu::reportbycpu: true
           collectd::plugin::cpu::reportbystate: true
           collectd::plugin::cpu::reportnumcpu: false
           collectd::plugin::cpu::valuespercentage: true
           collectd::plugin::df::ignoreselected: true
           collectd::plugin::df::reportbydevice: true
           collectd::plugin::df::fstypes: ['xfs']
           collectd::plugin::load::reportrelative: true
           collectd::plugin::virt::extra_stats: "pcpu cpu_util vcpupin vcpu memory disk disk_err disk_allocation disk_capacity disk_physical domain_state job_stats_background perf"

流程

1. 以 stack 用户身份登录到 RHOSP undercloud。
2. 在 /home/stack 目录中创建一个名为 stf-connectors.yaml 的配置文件。

3. 在 stf-connectors.yaml 文件中，配置 MetricsQdrConnectors 地址，将 overcloud 上的 AMQ Interconnect 连接到 STF 部署。您可以在此文件中为 Sensubility、Ceilometer 和 collectd 配置主题地址，以匹配 STF 中的默认值。有关自定义主题和云配置的更多信息，请参阅 第 4.5 节 “配置多个云”。

   • resource_registry 配置直接加载 collectd 服务，因为您不为多个云部署包含 collectd-write-qdr.yaml 环境文件。
   • 将 host 参数替换为您在 第 4.1.2 节 “检索 AMQ Interconnect 路由地址” 中检索的 HOST/PORT 值。
   • 将 caCertFileContent 参数替换为在 第 4.1.1 节 “从用于 overcloud 配置的服务 Telemetry Framework 获取 CA 证书” 中检索的内容。
   • 将 MetricsQdrConnectors 的主机 子参数替换为您在 第 4.1.2 节 “检索 AMQ Interconnect 路由地址” 中检索的 HOST/PORT 的值。
   • 设置 CeilometerQdrEventsConfig.topic，以定义 Ceilometer 事件的主题。这个值的格式为 anycast/ceilometer/cloud1-event.sample。
   • 设置 CeilometerQdrMetricsConfig.topic，以定义 Ceilometer 指标的主题。这个值的格式为 anycast/ceilometer/cloud1-metering.sample。
   • 设置 CollectdAmqpInstances，以定义 collectd 事件的主题。这个值的格式为 collectd/cloud1-notify。

   • 设置 CollectdAmqpInstances，以定义 collectd 指标的主题。这个值的格式为 collectd/cloud1-telemetry。

     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: stf-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-----
     
         CeilometerQdrEventsConfig:
             driver: amqp
             topic: cloud1-event
     
         CeilometerQdrMetricsConfig:
             driver: amqp
             topic: cloud1-metering
     
         CollectdAmqpInstances:
             cloud1-notify:
                 notify: true
                 format: JSON
                 presettle: false
             cloud1-telemetry:
                 format: JSON
                 presettle: false

流程

1. 以 stack 用户身份登录 Red Hat OpenStack Platform (RHOSP) undercloud。

2. 提供身份验证文件：

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

3. 在 RHOSP director 部署中添加以下文件来配置数据收集和 AMQ Interconnect：

   • ceilometer-write-qdr.yaml 文件，以确保 Ceilometer 遥测和事件发送到 STF
   • qdr-edge-only.yaml 文件，以确保消息总线被启用并连接到 STF 消息总线路由器
   • enable-stf.yaml 环境文件，以确保正确配置了默认值
   • stf-connectors.yaml 环境文件来定义到 STF 的连接

4. 部署 RHOSP overcloud：

   (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/enable-stf.yaml \
     --environment-file /home/stack/stf-connectors.yaml

流程

1. 登录 overcloud 节点，如 controller-0。

2. 确保 metrics_qdr 容器在节点上运行：

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

3. 返回运行 AMQ Interconnect 的内部网络地址，如 172.17.1.44 侦听端口 5666 ：

   $ sudo docker 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 docker 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

   有四个连接：

   • 出站到 STF 的连接
   • 来自 ceilometer 的入站连接
   • collectd 的入站连接

   • 来自 qdstat 客户端的入站连接

     出站 STF 连接提供给 MetricsQdrConnectors 主机参数，是 STF 存储域的路由。其他主机是与这个 AMQ Interconnect 的客户端连接的内部网络地址。

5. 为确保传递信息，列出链接，并在 deliv 列中查看用于传递消息的 _edge 地址：

   $ sudo docker 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。

   $ 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 命名空间：

   $ oc project service-telemetry

3. 编辑默认 ServiceTelemetry 对象，并使用您的 配置添加一个 cloud 参数：

   警告

   长云名称可能会超过最大 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: ceilometer
           subscriptionAddress: anycast/ceilometer/cloud1-metering.sample
     - name: cloud2
       events:
         ...

4. 保存 ServiceTelemetry 对象。

5. 验证每个智能网关正在运行。这可能需要几分钟时间，具体取决于智能卡数量：

   $ 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

流程

1. 使用您要管理 Service Telemetry Operator 的云对象列表定义您的 clouds 参数。更多信息请参阅 “clouds 参数”一节。

2. 编辑 ServiceTelemetry 对象并添加 cloudsRemoveOnMissing 参数：

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

3. 保存修改。

4. 验证 Operator 是否已删除智能卡。Operator 协调更改时可能需要几分钟时间：

   $ oc get smartgateways

流程

1. 创建新的环境文件，如 hostname .yaml。

2. 在环境文件中设置 CloudDomain 参数，如下例所示：

   hostnames.yaml

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

3. 将新环境文件添加到您的部署中。

流程

1. 以 stack 用户身份登录 Red Hat OpenStack Platform undercloud。
2. 在 /home/stack 目录中创建一个名为 stf-connectors.yaml 的配置文件。

3. 在 stf-connectors.yaml 文件中，配置 MetricsQdrConnectors 地址以连接到 overcloud 部署上的 AMQ Interconnect。配置 CeilometerQdrEventsConfig、CeilometerQdrMetricsConfig 和 CollectdAmqpInstances 主题值，以匹配此云部署的 AMQP 地址。

   • resource_registry 配置直接加载 collectd 服务，因为您不为多个云部署包含 collectd-write-qdr.yaml 环境文件。
   • 将 MetricsQdrConnectors.host 参数替换为您在 第 4.1.2 节 “检索 AMQ Interconnect 路由地址” 中检索的 HOST/PORT 的值。
   • 将 caCertFileContent 参数替换为在 第 4.1.1 节 “从用于 overcloud 配置的服务 Telemetry Framework 获取 CA 证书” 中检索的内容。
   • 设置 CeilometerQdrEventsConfig.topic，以定义 Ceilometer 事件的主题。这个值是 anycast/ceilometer/cloud1-event.sample 的地址格式。
   • 设置 CeilometerQdrMetricsConfig.topic，以定义 Ceilometer 指标的主题。这个值是 anycast/ceilometer/cloud1-metering.sample 的地址格式。
   • 设置 CollectdAmqpInstances，以定义 collectd 事件的主题。这个值是 collectd/cloud1-notify 的格式。

   • 设置 CollectdAmqpInstances，以定义 collectd 指标的主题。这个值是 collectd/cloud1-telemetry 的格式。

     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: stf-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-----
     
         CeilometerQdrEventsConfig:
             driver: amqp
             topic: cloud1-event
     
         CeilometerQdrMetricsConfig:
             driver: amqp
             topic: cloud1-metering
     
         CollectdAmqpInstances:
             cloud1-notify:
                 notify: true
                 format: JSON
                 presettle: false
             cloud1-telemetry:
                 format: JSON
                 presettle: false

4. 确保 stf-connectors.yaml 文件中的命名约定与智能网关配置中的 spec.bridge.amqpUrl 字段一致。例如，将 CeilometerQdrEventsConfig.topic 字段配置为 cloud1-event 的值。

5. 提供身份验证文件：

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

6. 在 openstack overcloud deployment 命令中包含 stf-connectors.yaml 文件以及唯一域名环境文件 hostname.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 overcloud。

流程

1. 登录 Red Hat OpenShift Container Platform。

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

   $ 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: v4
     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.v4.6.0   Grafana Operator   4.6.0     grafana-operator.v4.5.1   Succeeded

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'

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. 登录 Red Hat OpenShift Container Platform。

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

   $ 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 参数。

流程

1. 登录 Red Hat OpenShift Container Platform。

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

   $ 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 命名空间：

   $ 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: Collectd metrics receive rate is zero
             expr: rate(sg_total_collectd_msg_received_count[1m]) == 0
   EOF

   要更改规则，请编辑 expr 参数的值。

4. 要验证 Operator 是否将规则加载到 Prometheus 中，请使用基本身份验证针对 default-prometheus-proxy 路由运行 curl 命令：

   $ curl -k --user "internal:$(oc get secret default-prometheus-htpasswd -ogo-template='{{ .data.password | base64decode }}')" 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 prometheus-alarm-rules

2. 编辑 PrometheusRules 清单。
3. 保存并关闭清单。

流程

1. 登录 Red Hat OpenShift Container Platform。

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

   $ oc project service-telemetry

3. 为您的 STF 部署编辑 ServiceTelemetry 对象：

   $ oc edit stf default

4. 添加新参数 alertmanagerConfigManifest 和 Secret 对象内容，以定义 Alertmanager 的 alertmanager.yaml 配置：

   注意

   此步骤加载 Service Telemetry Operator 管理的默认模板。要验证是否正确填充了更改，请更改值，返回 alertmanager-default secret，然后验证新值是否已加载到内存中。例如，将 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. 验证配置是否已应用到 secret：

   $ 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-proxy 服务运行 curl 命令，以检索 status 和 configYAML 内容，并验证提供的配置是否与 Alertmanager 中的配置匹配：

   $ oc run curl -it --serviceaccount=prometheus-k8s --restart='Never' --image=radial/busyboxplus:curl -- sh -c "curl -k -H \"Content-Type: application/json\" -H \"Authorization: Bearer \$(cat /var/run/secrets/kubernetes.io/serviceaccount/token)\" https://default-alertmanager-proxy:9095/api/v1/status"
   
   {"status":"success","data":{"configYAML":"...",...}}

7. 验证 configYAML 字段是否包含您预期的更改。

8. 要清理环境，请删除 curl pod：

   $ oc delete pod curl
   
   pod "curl" deleted

流程

1. 登录 Red Hat OpenShift Container Platform。

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

   $ oc project service-telemetry

3. 为您的 STF 部署编辑 ServiceTelemetry 对象：

   $ oc edit stf default

4. 要使用 STF 部署自定义 Alertmanager 路由，您必须将 alertmanagerConfigManifest 参数传递给 Service Telemetry Operator，这会导致 Prometheus Operator 管理的更新 secret：

   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
       data:
         alertmanager.yaml: Z2xvYmFsOgogIHJlc29sdmVfdGltZW91dDogMTBtCiAgc2xhY2tfYXBpX3VybDogPHNsYWNrX2FwaV91cmw+CnJlY2VpdmVyczoKICAtIG5hbWU6IHNsYWNrCiAgICBzbGFja19jb25maWdzOgogICAgLSBjaGFubmVsOiAjc3RmLWFsZXJ0cwogICAgICB0aXRsZTogfC0KICAgICAgICAuLi4KICAgICAgdGV4dDogPi0KICAgICAgICAuLi4Kcm91dGU6CiAgZ3JvdXBfYnk6IFsnam9iJ10KICBncm91cF93YWl0OiAzMHMKICBncm91cF9pbnRlcnZhbDogNW0KICByZXBlYXRfaW50ZXJ2YWw6IDEyaAogIHJlY2VpdmVyOiAnc2xhY2snCg==

5. 验证配置是否已应用到 secret：

   $ 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. 针对 alertmanager-proxy 服务运行 curl 命令，以检索 status 和 configYAML 内容，并验证提供的配置是否与 Alertmanager 中的配置匹配：

   $ oc run curl -it --serviceaccount=prometheus-k8s --restart='Never' --image=radial/busyboxplus:curl -- sh -c "curl -k -H \"Content-Type: application/json\" -H \"Authorization: Bearer \$(cat /var/run/secrets/kubernetes.io/serviceaccount/token)\" https://default-alertmanager-proxy:9095/api/v1/status"
   
   {"status":"success","data":{"configYAML":"...",...}}

7. 验证 configYAML 字段是否包含您预期的更改。

8. 要清理环境，请删除 curl pod：

   $ oc delete pod curl
   
   pod "curl" deleted

流程

1. 登录 Red Hat OpenShift Container Platform。

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

   $ oc project service-telemetry

3. 使用 oc 命令编辑 ServiceTelemetry 对象：

   $ oc edit stf default

4. 在 spec 部分添加 highAvailability.enabled: true ：

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

5. 保存您的更改，并关闭对象。

流程

1. 登录 Red Hat OpenShift Container Platform。

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

   $ 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. 在 spec 参数中创建一个带有属性 observabilityStrategy: none 的 ServiceTelemetry 对象。清单显示的结果是采用 STF 的默认部署，适用于从具有所有指标收集器类型的单个云接收遥测。

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

2. 要验证所有工作负载是否都正常运行，请查看 pod 和每个 pod 的状态：

   $ oc get pods
   NAME                                                      READY   STATUS    RESTARTS   AGE
   default-cloud1-ceil-meter-smartgateway-59c845d65b-gzhcs   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