절차

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 사용자로 RHOSP(Red Hat OpenStack Platform) 언더클라우드에 로그인합니다.

2. /home/stack 디렉터리에 enable-stf.yaml 이라는 구성 파일을 생성합니다.

   중요

   EventPipelinePublishers 및 PipelinePublishers 를 표시하도록 설정하면 Gnocchi 또는 Panko와 같은 RHOSP Telemetry 구성 요소에 전달하는 이벤트 또는 지표 데이터가 발생하지 않습니다. 추가 파이프라인으로 데이터를 보내야 하는 경우 ExtraConfig 에 지정된 대로 Ceilometer 폴링 간격 30초가 RHOSP Telemetry 구성 요소를 초과할 수 있으며 간격을 300 과 같은 더 큰 값으로 늘려야 합니다. 값을 더 긴 폴링 간격으로 늘리면 STF에서 Telemetry 확인이 줄어듭니다.

   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. RHOSP 언더클라우드에 stack 사용자로 로그인합니다.
2. /home/stack 디렉터리에 stf-connectors.yaml 이라는 구성 파일을 생성합니다.

3. stf-connectors.yaml 파일에서 MetricsQdrConnectors 주소를 구성하여 오버클라우드의 AMQ Interconnect를 STF 배포에 연결합니다. STF의 기본값과 일치하도록 이 파일에서 Sensubility, Ceilometer, collectd에 대한 주제 주소를 구성합니다. 주제 및 클라우드 구성 사용자 지정에 대한 자세한 내용은 4.5절. “여러 클라우드 구성” 을 참조하십시오.

   • 여러 클라우드 배포에 대한 collectd-write-qdr.yaml 환경 파일이 포함되지 않으므로 resource_registry 구성이 collectd 서비스를 직접 로드합니다.
   • host 매개변수를 4.1.2절. “AMQ Interconnect 경로 주소 검색” 에서 검색한 HOST/PORT 값으로 바꿉니다.
   • caCertFileContent 매개변수를 4.1.1절. “오버클라우드 구성을 위한 Service Telemetry Framework에서 CA 인증서 가져오기” 에서 검색된 콘텐츠로 교체합니다.
   • MetricsQdrConnectors 의 호스트 하위 매개변수를 4.1.2절. “AMQ Interconnect 경로 주소 검색” 에서 검색한 HOST/PORT 값으로 바꿉니다.
   • Ceilometer 이벤트의 주제를 정의하려면 CeilometerQdrEventsConfig.topic 을 설정합니다. 이 값의 형식은 anycast/ceilometer/cloud1-event.sample 입니다.
   • CeilometerQdrMetricsConfig.topic 을 설정하여 Ceilometer 메트릭에 대한 주제를 정의합니다. 이 값의 형식은 anycast/ceilometer/cloud1-metering.sample 입니다.
   • CollectdAmqpInstances 를 설정하여 collectd 이벤트에 대한 주제를 정의합니다. 이 값의 형식은 collectd/cloud1-notify 입니다.

   • collectd 메트릭에 대한 주제를 정의하려면 CollectdAmqpInstances 를 설정합니다. 이 값의 형식은 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 사용자로 RHOSP(Red Hat OpenStack Platform) 언더클라우드에 로그인합니다.

2. 인증 파일을 소싱합니다.

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

3. RHOSP director 배포에 다음 파일을 추가하여 데이터 수집 및 AMQ Interconnect를 구성합니다.

   • Ceilometer Telemetry 및 이벤트가 STF로 전송되도록 ceilometer-write-qdr.yaml 파일
   • 메시지 버스가 활성화되어 STF 메시지 버스 라우터에 연결되어 있는지 확인하는 qdr-edge-only.yaml 파일
   • 기본값이 올바르게 구성되어 있는지 확인하는 enable-stf.yaml 환경 파일
   • STF에 대한 연결을 정의하는 stf-connectors.yaml 환경 파일

4. RHOSP 오버클라우드를 배포합니다.

   (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. 오버클라우드 노드에 로그인합니다(예: controller-0).

2. metrics_qdr 컨테이너가 노드에서 실행 중인지 확인합니다.

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

3. 포트 5666 에서 수신 대기하는 AMQ Interconnect가 실행 중인 내부 네트워크 주소를 반환합니다(예: 172.17 . 1.44).

   $ 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

   4개의 연결이 있습니다.

   • 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에 연결하고 알려진 연결을 나열합니다. 이 예에서는 연결 ID 22, 23 및 24인 RHOSP 노드에서 세 개의 에지 연결이 있습니다.

   $ 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 오브젝트를 편집하고 구성을 사용하여 clouds 매개변수를 추가합니다.

   주의

   긴 클라우드 이름은 63자의 최대 Pod 이름을 초과할 수 있습니다. ServiceTelemetry 이름 기본값 과 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. 각 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

절차

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 매개변수를 설정합니다.

   hostnames.yaml

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

3. 배포에 새 환경 파일을 추가합니다.

절차

1. Red Hat OpenStack Platform 언더클라우드에 stack 사용자로 로그인합니다.
2. /home/stack 디렉터리에 stf-connectors.yaml 이라는 구성 파일을 생성합니다.

3. stf-connectors.yaml 파일에서 MetricsQdrConnectors 주소를 구성하여 오버클라우드 배포의 AMQ Interconnect에 연결합니다. 이 클라우드 배포에 필요한 AMQP 주소와 일치하도록 CeilometerQdrEventsConfig,CeilometerQdrMetricsConfig 및 CollectdAmqpInstances 주제 값을 구성합니다.

   • 여러 클라우드 배포에 대한 collectd-write-qdr.yaml 환경 파일이 포함되지 않으므로 resource_registry 구성이 collectd 서비스를 직접 로드합니다.
   • MetricsQdrConnectors.host 매개변수를 4.1.2절. “AMQ Interconnect 경로 주소 검색” 에서 검색한 HOST/PORT 값으로 교체합니다.
   • caCertFileContent 매개변수를 4.1.1절. “오버클라우드 구성을 위한 Service Telemetry Framework에서 CA 인증서 가져오기” 에서 검색된 콘텐츠로 교체합니다.
   • Ceilometer 이벤트의 주제를 정의하려면 CeilometerQdrEventsConfig.topic 을 설정합니다. 이 값은 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 파일의 이름 지정 규칙이 Smart Gateway 구성의 spec.bridge.amqpUrl 필드와 일치하는지 확인합니다. 예를 들어 CeilometerQdrEventsConfig.topic 필드를 cloud1-event 값으로 구성합니다.

5. 인증 파일을 소싱합니다.

   [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 네임스페이스로 변경합니다.

   $ 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. 보존 기간을 backends.metrics.prometheus.storage의 storage 섹션에 7d 를 추가하여 보존 기간을 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 보안을 반환하고 새 값이 메모리에 로드되었는지 확인합니다. 예를 들어, 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-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 포드를 삭제합니다.

   $ 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에서 관리하는 업데이트된 보안을 생성해야 합니다.

   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. 구성이 보안에 적용되었는지 확인합니다.

   $ 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 포드를 삭제합니다.

   $ 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 오브젝트를 생성합니다. 매니페스트는 모든 지표 수집기 유형이 있는 단일 클라우드에서 Telemetry를 수신하는 데 적합한 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