Skip to content

Feature and Usage

Jump to bottom
hyokyungk edited this page Aug 19, 2021 · 26 revisions

[CB-Dragonfly 활용 개요]

user_scenario

그림에서 보는 바와 같이,
CB-Dragonfly를 이용하여 멀티클라우드를 모니터링하는 순서는 다음과 같다.
    1. 모니터링 알람 임계치 설정
    2. 모니터링 환경 설정
    3. CB-Dragonfly 구동
    4. 멀티클라우드 VM에 모니터링 에이전트 설치
    5. 멀티클라우드 VM 모니터링 실시

CB-Dragonfly가 제공하는 주요 기능은 다음과 같고, 세부 내용은 아래와 같다. 
    1. 모니터링 에이전트 자동 설치(Multi-Cloud Monitoring Agent Auto-Installation)
    2. 멀티클라우드 VM 모니터링 정보 조회(Multi-Cloud VM Monitoring Information Look-up)
    3. 멀티클라우드 모니터링 이상치 메트릭 알림(Multi-Cloud Monitoring Outlier Metric Alert)

1. 모니터링 에이전트 자동 설치(Multi-Cloud Monitoring Agent Auto-Installation)

  • 대상 클라우드(=CSP) VM에 모니터링 에이전트 자동 설치를 위하여 필요한 메타 데이터 정보를 입력받는다.
  • 메타 데이터 정보는 REST API를 통해 받으며 주요 정보는 다음과 같다
    • MCIS 정보: CSP 타입, MCIS ID, 네임스페이스 ID, VM ID, IP
    • VM 접속 정보: VM의 SSH 접속 계정, SSH 접근 키, 접속 포트
  • API 활용 예시 
     curl --location -g --request POST 'http://localhost:9090/dragonfly/agent/install' \
 --form 'mcis_id="test_mcis_id"' \
 --form 'vm_id="test_vm_id"' \
 --form 'public_ip="0.0.0.0"' \
 --form 'user_name="user_name"' \
 --form 'ssh_key="{{Hash Key}}' \
 --form 'cspType="AWS"'
  • 인터페이스 규격 및 예시

2. 멀티클라우드 VM 모니터링 정보 조회(Multi-Cloud VM Monitoring Metric Look-up)

  • CB-Dragonfly는 모니터링 메트릭, 모니터링 알림, CB-Dragonfly 환경 설정 정보를 API 기반으로 조회할 수 있다.

(1) 모니터링 메트릭 조회

  • 모니터링 메트릭은 VM 에이전트로부터 다음과 같은 모니터링 메트릭들을 수집한다.
  • VM 모니터링 메트릭 조회 기능은 사용자에게 모니터링 메트릭 또는 메트릭들의 평균, 최소, 최대 값 등의 정보를 제공한다.
    • 모니터링 메트릭 조회시 주요 입력 정보는 다음과 같다.
      • 네임스페이스 이름: 예시) test_namespace
      • MCIS 이름: 예시) test_mcis_id
      • VM 이름: 예시) test_vm_id
      • VM 주소 정보: 예시) 0.0.0.0
      • 조회하고자 하는 메트릭 이름: 예시) cpu
    • API 활용 예시: 모니터링 메트릭 조회 
      curl --location -g --request GET 'http://localhost:9090/dragonfly/ns/test_namespace/mcis/test_mcis_id/vm/test_vm_id/agent_ip/0.0.0.0/metric/cpu'
    • 모니터링 메트릭 통계치 조회시 주요 입력 정보는 다음과 같다.
      • 네임스페이스 이름: 예시) test_namespace
      • MCIS 이름: 예시) test_mcis_id
      • VM 이름: 예시) test_vm_id
      • 조회하고자 하는 메트릭 이름: 예시) cpu
      • 모니터링 단위: 예시) min
      • 메트릭 통계 기준: 예시) avg
      • 모니터링 조회 범위: 예시) 5m
    • API 활용 예시: 모니터링 메트릭 통계치 조회 
      curl --location -g --request GET 'http://localhost:9090/dragonfly/ns/test_namespace/mcis/test_mcis_id/vm/test_vm_id/metric/cpu/info?periodType=min&statisticsCriteria=avg&duration=5m'
  • MCIS 모니터링 메트릭 조회 기능은 사용자에게 MCIS 모니터링 메트릭 값을 제공한다.
  • 조회시 주요 입력 정보는 다음과 같다.
    • 네임스페이스 이름: 예시) test_namespace
    • MCIS 이름: 예시) test_mcis_id
    • VM 이름: 예시) test_vm_id
    • VM 주소 정보: 예시) 0.0.0.0
    • 조회하고자 하는 메트릭 이름: 예시) cpu
  • API 활용 예시 
    curl --location -g --request GET 'http://localhost:9090/dragonfly/ns/test_namespace/mcis/test_mcis_id/vm/test_vm_id/agent_ip/0.0.0.0/metric/cpu/mcis-monitoring-info'

(2) 모니터링 알림 조회

  • 모니터링 알림 조회 기능은 사용자에게 모니터링 알람 이벤트 및 이벤트 핸들러 정보를 제공한다.
    • API 활용 예시 
      curl --location -g --request GET 'http://localhost:9090/dragonfly/alert/task/cpualert/events?level=warning'
    • 알람 이벤트 핸들러 조회 API 활용 예시 
      curl --location --request GET 'http://localhost:9090/dragonfly/alert/eventhandlers?eventType=slack'

(3) 모니터링 설정 정보 조회

  • 모니터링 설정 정보 조회 기능은 사용자에게 CB-Dragonfly의 모니터링 설정 정보를 제공한다.
    • API 활용 예시 
      curl --location -g --request GET 'http://localhost:9090/dragonfly/config'
  • 인터페이스 규격 및 예시

3. 멀티클라우드 모니터링 이상치 메트릭 알림(Multi-Cloud Monitoring Outlier Metric Alert)

Table of contents

Clone this wiki locally