IBM Cloud Private(ICP)에서 Mobile Foundation 모니터링

improve this page | report issue

개요

이 학습서에서는 IBM Cloud Private에서 실행 중인 Mobile Foundation을 모니터하기 위해 Prometheus를 통합하는 방법을 요약합니다.

IBM Mobile Foundation은 MicroProfile 메트릭 API로 인스트루먼트화된 Mobile Foundation Server, Analytics 및 Application Center를 모니터할 수 있도록 mpMetrics-1.0 기능을 설정함으로써 모니터링 기능을 제공합니다. 이는 ICP에 배치된 Mobile Foundation 컨테이너의 JVM 및 시스템 레벨 메트릭을 모니터하는 데 도움이 됩니다.

/metrics API 요청에 대한 기본 응답 형식은 텍스트 형식이며 이 형식은 Prometheus와 호환 가능합니다.

프로시저

IBM Cloud Private에서 Mobile Foundation의 모니터링을 설정하려면 아래 단계를 완료하십시오.

1단계: IBM Monitoring 서비스 배치

a. IBM Cloud Private 카탈로그에서 Monitoring 서비스를 배치하십시오.
b. 카탈로그로 이동하여 ibm-icpmonitoring helm 차트를 선택하고 설치하십시오. helm 차트는 IBM Cloud Private에 설치됩니다.
icpmonitoring helm 선택

2단계: Prometheus configmap 구성 업데이트

ICP 클러스터의 컨텍스트 구성 정보가 있는 ICP 인스턴스인 적절히 소싱된 터미널에서 다음 명령을 실행하십시오.

kubectl get svc | grep prometheus


ibm-icpmonitoring 차트에 의해 배치되는 다수의 서비스가 표시됩니다. 이 학습서에서는 아래의 스크린샷에 표시된 바와 같이 <name used for the helm release>-promethues(mfp-prometheus-prometheus)라는 서비스에 초점을 맞추고 사용할 것입니다.

배치된 서비스 가져오기
이러한 서비스는 각각 연관된 configmap 오브젝트가 있습니다. Mobile Foundation 팟(Pod)의 메트릭 데이터를 가져오려면 Mobile Foundation Server에 대한 mfpfserver 어노테이션, Analytics에 대한 mfpfanalytics 어노테이션 및 Application Center에 대한 mfpfappcenter 어노테이션을 기타 몇몇 속성과 함께 서비스 배치에 추가하여 mfp-prometheus-prometheus 서비스와 연관된 configmap을 수정해야 합니다.
이를 달성하는 가장 간단한 방법은 아래 명령을 사용하여 소싱된 터미널에서 의도한 configmap 오브젝트를 편집하는 것입니다.

  kubectl edit configmap mfp-prometheus-prometheus


이 명령은 vi 편집기에 요청된 YAML 파일을 가져옵니다. 파일 끝으로 화면 이동하여 kind: ConfigMap 바로 앞에 아래의 텍스트를 삽입하십시오.

Mobile Foundation Server 메트릭 구성(아래의 YAML 스니펫):

# Configuration for MFP Server Monitoring
- job_name: 'mfpf-server'
scheme: 'https'
basic_auth:
  username: 'mfpRESTUser'
  password: 'mfpadmin'
tls_config:
  insecure_skip_verify: true
kubernetes_sd_configs:
  - role: endpoints
relabel_configs:
  - source_labels: [__meta_kubernetes_service_annotation_mfpfserver]
    action: keep
    regex: true
  - source_labels: [__address__, __meta_kubernetes_service_annotation_prometheus_io_port]
    action: replace
    target_label: __address__
    regex: (.+)(?::\d+);(\d+)
    replacement: $1:$2
  - action: labelmap
    regex: __meta_kubernetes_service_label_(.+)


Mobile Foundation Server 상태 검사 모니터링을 위한 구성(아래의 YAML 스니펫):

# Configuration for MFP Health check  Monitoring<br/>
- job_name: 'mfp-healthcheck'
metrics_path: /mfpadmin/management-apis/2.0/diagnostic/healthCheck
scheme: 'https'
basic_auth:
  username: 'admin'
  password: 'admin'
tls_config:
  insecure_skip_verify: true
kubernetes_sd_configs:
  - role: endpoints
relabel_configs:
  - source_labels: [__meta_kubernetes_service_annotation_mfpfserver]
    action: keep
    regex: true
  - source_labels: [__address__, __meta_kubernetes_service_annotation_prometheus_io_port]
    action: replace
    target_label: __address__
    regex: (.+)(?::\d+);(\d+)
    replacement: $1:$2
  - action: labelmap
    regex: __meta_kubernetes_service_label_(.+)


참고: Mobile Foundation Analytics 및 Application Center 배치는 유사한 메트릭 구성을 따릅니다.

job_namesource_labels의 값은 앞에서 설명한 대로 변경됩니다.

3단계: 작업 업데이트 후 Prometheus 구성 다시 로드

아래의 curl 명령을 실행하십시오.

curl -s -XPOST http://<ip address of the proxy node>:31271/-/reload


Prometheus config

4단계: Mobile Foundation 통계 모니터링

a. 브라우저에서 URL을 사용하여 Prometheus 콘솔로 이동하십시오.

http://<ip address of the Proxy Node>:31271

b. Prometheus 콘솔에서 아래 스크린샷에 표시된 대로 먼저 상태를 클릭한 후 드롭 다운에서 대상을 클릭하십시오.
Prometheus 콘솔 c. Prometheus가 통계를 얻고 있는 모든 대상이 표시됩니다.
appcenter를 대상으로 지정
모두를 대상으로 지정
위의 스크린샷은 Mobile Foundation Server, Analytics 및 Application Center 대상을 명확히 보여줍니다. 2단계에 표시된 configmap YAML 파일의 job_name 속성의 값을 참조하십시오.
배치 샘플을 두 개의 복제본으로 스케일업했으며 이로 인해 Prometheus는 서버에 대해 두 개의 엔드포인트가 스크랩되는 것을 보여줍니다.

Prometheus 콘솔 및 후속 패널에서 그래프를 클릭하는 경우 아래의 스크린샷에 표시된 대로 커서에서 메트릭 삽입을 클릭하십시오.
Prometheus 그래프

현재 Prometheus 구성으로 모니터할 수 있는 다수의 메트릭이 표시됩니다. 긴 목록의 메트릭 중 base:로 시작하는 메트릭 이름은 mpMetrics-1.0 기능이 제공하는 Mobile Foundation 컨테이너에서 가져온 것입니다.
Mobile Foundation 메트릭

Liberty 메트릭(예: base:thread_count)을 선택하면 아래 스크린샷에 표시된 대로 Prometheus 그래프에서 두 Mobile foundation Server 팟의 값을 볼 수 있습니다.
스레드 수 그래프

콘솔을 클릭하여 Prometheus에서 기타 관련 메트릭을 그래픽 및 숫자 형식으로 탐색할 수 있습니다.
배치를 스케일링할 수도 있습니다. 단기간 내에 Prometheus 콘솔의 엔드포인트 수가 복제본의 수와 일치하게 됩니다.

참고: Prometheus의 configmap 파일에서 비밀번호에 일반 텍스트를 사용했지만 Prometheus는 Prometheus 패널에 해당 구성이 표시될 때 비밀번호를 표시하지 않습니다.

5단계: Grafana 대시보드에서 메트릭 보기

Mobile Foundation helm 차트에는 샘플 Grafana 대시보드 json 파일이 포함되며, 1단계에서 배치된 Monitoring 서비스에는 Grafana가 갖추어져 있습니다.

JSON 파일에서 Grafana 대시보드를 가져오는 방법은 다음과 같습니다.

  • 배치된 모니터링 서비스에서 Grafana를 시작하십시오.
    워크로드 -> Helm 릴리스 -> <name used for the helm release>(예: mfp-prometheus) ->시작)

  • GitHub에서 로컬 워크스테이션으로 JSON 대시보드 파일을 다운로드하십시오.

  • Grafana 인터페이스에서 단추를 클릭한 후 대시보드 가져오기를 클릭하십시오.

  • .json 파일 업로드 단추를 클릭하고 로컬 파일 시스템에서 Grafana 대시보드 JSON 파일을 선택하십시오.

  • 데이터 소스 선택 메뉴에서 prometheus를 선택하십시오(아직 선택하지 않은 경우).

  • 가져오기를 클릭하십시오.

아래의 스크린샷에 Mobile Foundation Server용 샘플 모니터링 대시보드가 표시되어 있습니다.
대시보드 1 대시보드 2 대시보드 3

Last modified on December 18, 2018