3장. 3scale API Management 모니터링 활성화

프로세스

1. OperatorHub 에서 Grafana 4 커뮤니티 Operator를 설치합니다.

   • OpenShift 관리자 인증 정보를 사용하여 OCP(OpenShift Container Platform)에 로그인합니다.

   • Grafana 커뮤니티 Operator를 설치할 프로젝트 목록에서 프로젝트를 선택합니다.

     중요

     3scale Operator를 설치한 동일한 프로젝트에 Grafana 커뮤니티 Operator를 설치합니다.

   • Operators > OperatorHub 로 이동합니다.
   • "grafana"를 검색하고 Grafana Operator 를 클릭합니다.

   • Grafana Community Operator 페이지에서 설치를 클릭합니다. Create Operator Subscription 페이지가 표시됩니다. Grafana Operator 서브스크립션을 생성하려면 다음 단계를 완료합니다.

     1. 클러스터에서 특정 네임스페이스를 클릭하고 Grafana 커뮤니티 Operator를 설치할 프로젝트를 선택합니다.
     2. Subscribe를 클릭합니다.
     3. 승인 을 클릭합니다.

2. OperatorHub 에서 최신 Prometheus 커뮤니티 Operator를 설치합니다.

   • OpenShift 관리자 인증 정보를 사용하여 OCP(OpenShift Container Platform)에 로그인합니다.

   • Prometheus 커뮤니티 Operator를 설치할 프로젝트 목록에서 프로젝트를 선택합니다.

     중요

     3scale Operator를 설치한 동일한 프로젝트에 Prometheus 커뮤니티 Operator를 설치합니다.

   • Operators > OperatorHub 로 이동합니다.
   • "prometheus"를 검색하고 Prometheus Operator 를 클릭합니다.

   • Prometheus Community Operator 페이지에서 설치를 클릭합니다. Create Operator Subscription 페이지가 표시됩니다. Prometheus Operator 서브스크립션을 생성하려면 다음 단계를 완료합니다.

     1. 클러스터에서 특정 네임스페이스를 클릭하고 Prometheus Operator를 설치할 프로젝트를 선택합니다.
     2. Subscribe를 클릭합니다.
     3. 승인 을 클릭합니다.

3. 3scale 배포 YAML의 spec.monitoring.enabled 매개변수를 true 로 설정하여 모니터링을 활성화합니다. 예를 들면 다음과 같습니다.

   apiVersion: apps.3scale.net/v1alpha1
   kind: APIManager
   metadata: ...
   spec:
     monitoring:
       enabled: true
     ...

   1. OpenShift 클러스터에 로그인합니다. 3scale의 OpenShift 프로젝트에서 edit 클러스터 역할을 가진 사용자로 로그인해야 합니다(예: cluster-admin ).

      $ oc login

   2. 3scale 프로젝트로 전환합니다.

      $ oc project <project_name>

4. Prometheus의 새 서비스 계정을 생성합니다.

   $ oc create serviceaccount prometheus-monitoring

5. ClusterRoleBinding을 생성하여 Prometheus ServiceAccount에 메트릭을 스크랩하는 데 필요한 RBAC(역할 기반 액세스 제어) 권한을 부여합니다. ClusterRoleBinding을 생성하기 전에 ServiceAccount 네임스페이스를 업데이트합니다.

   $ oc adm policy add-cluster-role-to-user cluster-monitoring-view -z prometheus-monitoring -n "<3scale_namespace>

6. prometheus-monitoring ServiceAccount에 대한 토큰을 생성합니다.

   $ oc create token prometheus-monitoring

   이 토큰이 만료되면 Prometheus는 필요한 리소스에 대한 액세스 권한이 손실됩니다. --duration X[s|m|h] 를 추가하여 토큰의 유효 기간을 지정합니다.

7. 생성한 토큰으로 3scale-scrape-configs.yaml bearer_token 필드를 업데이트합니다.

8. additional-scrape-config 시크릿을 생성합니다.

   $ oc create secret generic additional-scrape-configs --from-file=3scale-scrape-configs.yaml=./3scale-scrape-configs.yaml

9. Prometheus를 배포합니다.

   • Prometheus.yaml 파일에서 spec.externalUrl 필드를 외부 URL로 채웁니다. URL 템플릿은 다음과 같아야 합니다.

     spec:
       ...
       externalUrl: https://prometheus.<namespace-name>.apps.<cluster-domain>

10. Prometheus 서버를 배포합니다.

    $ oc apply -f prometheus.yaml

11. Prometheus 경로를 생성합니다.

    $ oc expose service prometheus-operated --hostname prometheus.<namespace-name>.apps.<cluster-name>

12. Grafana 데이터 소스를 배포합니다.

    $ oc apply -f datasource-v4.yaml

13. Grafana 배포

    $ oc apply -f grafana-v4.yaml