Related Repositories

플랫폼		어플리케이션 플랫폼		컨테이너 플랫폼
포털		AP 포털		CP 포털
		🚩 모니터링 대시보드
모니터링		Monitoring	InfluxDB	Redis
		Pinpoint	Pinpoint Buildpack	Zabbix
AP 서비스		Cubrid	Gateway	GlusterFS	Lifecycle
		Logging	MongoDB	MySQL	Pinpoint APM
		Pipeline	RabbitMQ	Redis	Source Control
		WEB-IDE
CP 서비스		Pipeline	Source Control

🚩 You are here.

PaaS-TA monitoring-dashboard-source

1. 개요
2. 선행 요소
3. 애플리케이션 개발환경 설정
4. 모듈/패키지 단위 및 디렉터리별 명세

1. 개요

이 문서는 본 저장소를 이용하여 로컬 개발환경을 구성하고, 모듈/패키지 단위 및 디렉터리별 설명을 명세한 가이드를 제공하기 위해 작성되었다.

2. 선행 요소

본 저장소를 통해 공개된 모듈 또는 패키지 단위의 실행 프로그램의 일부는 개발환경 설정시에 애플리케이션을 실행하는데 필요한 다른 주변 애플리케이션(DB 등)과의 선행적 연결 수립이 요구되기도 한다. 따라서 개발환경 설정에 앞서 PaaS-TA 애플리케이션 플랫폼(AP), 컨테이너 플랫폼(CP), 모니터링 플랫폼(Monitoring Dashboard)의 배포 및 설치가 선행되어 있어야 한다. 각 플랫폼의 설치는 공식 가이드의 설치 가이드를 참고할 수 있다.

3. 애플리케이션 개발환경 설정

본 문서의 개발환경은 윈도우 운영체제를 기준으로 하고 있으며 애플리케이션 개발을 위한 IDE로는 GoLand를 사용하고 있다. 다음 내용을 통해 로컬 개발환경을 설정하는 방법을 참고할 수 있다.

3.1. GoLand 설치

다음 경로를 통해 JetBrains 사에서 제공하는 30일간 사용 가능한 Goland IDE 설치 파일을 다운로드 받을 수 있다. 설치 파일 다운로드 후 설치 마법사의 안내에 따라 설치를 완료한다.

GoLand IDE Download

3.2. GoLand 설정

본 내용은 PaaS-TA Monitoring Web (Portal) 애플리케이션 개발환경 설정을 예시로 작성하였다. 아래 원격 저장소를 통해 애플리케이션 개발에 필요한 소스코드 전체를 다운로드 받을 수 있다.

PaaS-TA/monitoring-dashboard-source Download

PaaS-TA Monitoring Web (Portal) 개발을 위해 GoLand를 실행한 후 다운로드 받은 패키지 구조 중 paasta-monitoring-portal 디렉터리를 프로젝트로 연다.

config.ini 파일에 '2. 선행 요소'에서 언급했던 주변 실행 환경의 연결 정보 또는 접속 정보를 알맞게 입력한다.

상단 메뉴 바의 [실행] > [구성 편집] 메뉴를 선택한다. 이어서 [실행/디버그 구성] 창의 설정을 다음을 참고해 설정한다.

ㆍ [실행 종류] : 파일
ㆍ [파일] : ...\monitoring-dashboard-source\paasta-monitoring-portal\src\kr\paasta\monitoring\main.go
ㆍ [작업 디렉터리] : ...\monitoring-dashboard-source\paasta-monitoring-portal\src\kr\paasta\monitoring

우측 상단의 실행 버튼(Shift + F10)을 눌러 프로그램을 실행한다. 정상적으로 실행되면 IDE 하단의 실행 로그에 'Monit Application Started'라는 메시지가 노출된다.

웹 브라우저에서 'localhost:8080' 경로를 통해 로컬에서 GoLand를 기반으로 실행된 애플리케이션의 웹 화면을 확인할 수 있다.

4. 모듈/패키지 단위 및 디렉터리별 명세

┃ Agent Modules

　 paasta-agents ― AP diego-cell VM 기반 컨테이너 환경(Garden-runC)의 메트릭 정보를 수집/전송하는 에이전트
　├ cadvisor
　└ rep

　 paasta-monitoring-agent ― BOSH 포함 AP를 구성하는 VM 기반 환경의 메트릭 정보를 수집/전송하는 에이전트
　└ src/kr/paasta/monitoring_agent
　　├ handler
　　└ services

┃ Batch Modules

　 paasta-monitoring-batch ― AP 시스템 메트릭 조건에 따라 알람을 전송하는 배치 모듈
　└ src/kr/paasta/monitoring-batch
　　├ alarm
　　├ dao
　　├ handler
　　├ model
　　├ service
　　└ util

　 paasta-caas-monitoring-batch ― CP 시스템 메트릭 조건에 따라 알람을 전송하는 배치 모듈
　└ src/kr/paasta/monitoring-batch
　　├ caas
　　├ config
　　├ dao
　　├ model
　　├ notify
　　└ util

　 paasta-saas-monitoring-batch ― 애플리케이션 시스템 메트릭 조건에 따라 알람을 전송하는 배치 모듈
　└ src/kr/paasta/monitoring-batch
　　├ dao
　　├ model
　　├ notify
　　├ saas
　　└ util

　 paasta-iaas-monitoring-batch ― 인프라 시스템 메트릭에 조건에 따라 알람을 전송하는 배치 모듈
　└ src/kr/paasta/iaas-monitoring-batch
　　├ config
　　├ dao
　　├ model
　　├ service
　　├ util
　　└ zabbix-client

┃ Interface Modules

　 paasta-monitoring-api ― 모니터링 기능을 통합 제공하는 API 모듈 및 Swagger 기반 API 가이더
　└ src/kr/paasta/monitoring-api
　　├ apiHelpers
　　├ connections
　　├ controllers
　　├ dao
　　├ docs
　　├ helpers
　　├ middlewares
　　├ models
　　├ routers
　　└ services

　 paasta-monitoring-portal ― 모니터링 정보와 수치를 시각화한 GUI를 제공하는 웹 애플리케이션
　└ src/kr/paasta/monitoring
　　├ caas
　　├ common
　　├ handlers
　　├ iaas_new
　　├ openstack-client
　　├ paas
　　├ public
　　├ routes
　　├ saas
　　├ utils
　　└ zabbix-client