About

인베슘 에서는 하모니카 리눅스를 서버로 사용하는 경우 시스템 모니터링을 쉽게 할 수 있도록 제공하고 있습니다. 기본으로 제공되는 대시보드에 모니터링을 원하는 항목을 사용자 정의 패널로 자유롭게 추가할 수 있습니다.

아래의 환경에서 테스트 되었으며, 기타 SystemV Linux 계열에서도 docker, docker-compose 가 있으면 동일하게 사용가능합니다.

• HamoniKR 2.1
• HamoniKR Community Edition Moordev MATE 64bit 1.0
• Ubuntu 16.04, 18.04
• Linux Mint 18, 19

Requirement

쉬운 모니터링을 위하여 docker 기반의 서비스를 제공하므로, docker-compose 를 사용할 수 있는 준비가 먼저 필요합니다. 이미 설치되어 있다면 서비스 실행 으로 넘어가세요. 아래는 우분투 계열에서 docker, docker-compose 의 설치방법입니다.

$ sudo apt install -y docker.io docker-compose
$ sudo usermod -aG docker ${USER}

기타 OS 에서 docker, docker-compose 설치는 아래 링크를 참고하세요.

• Docker 설치문서 : https://docs.docker.com/install/
• docker-compose 설치문서 : https://docs.docker.com/compose/install/

사용법

데이터를 저장할 디렉토리 생성

서비스 재 구동시에도 데이터가 보관될 수 있도록 영구적으로 저장할 디렉토리를 생성해 줍니다.

$ sudo mkdir -p /var/hamonikr-mon-data/influxdb
$ sudo mkdir -p /var/hamonikr-mon-data/grafana
$ sudo chown 472:472 /var/hamonikr-mon-data/grafana

서비스 실행

이 저장소를 클론한 후에 아래의 명령을 실행하면 서비스가 구동됩니다.

$ git clone https://github.com/ivsteam/HamoniKR-Mon.git
$ cd HamoniKR-Mon
$ sudo docker-compose up -d

서비스 구동 후 아래의 주소에서 확인하세요 :

• http://localhost:3000 grafana web page (login with admin/admin)

서비스 중지

구동중인 서비스를 중지하려면 아래의 명령을 이용하세요.

$ sudo docker-compose down

대시보드 설정

1. grafana 로그인 후 아래의 정보대로 Datasource 를 생성합니다.

• url : http://influxdb:8086
• influxdb dbname : collectd

2. 왼쪽화면의 + 버튼을 누르고 Import 메뉴를 클릭하여 다음과 같이 6696 을 입력하고 Load 버튼을 클릭합니다.

Tip. 정상적으로 대시보드를 로드할 수 없는 경우

1. https://grafana.com/dashboards/6696 에서 Download JSON 을 클릭하여 JSON 파일을 다운받습니다.
2. Import 페이지에서 'Upload .json File' 을 통해 올립니다.

이전 단계에서 생성한 Datasource 이름 influxdb 를 다음과 같이 선택해줍니다.

Tip. 네트워크 디바이스가 eth0 이 아닌경우

ifconfig 명령어로 확인하여 사용 중인 네트워크 디바이스명을 확인하고 collected.conf 파일에서 섹션의 interface 값을 수정하고 다시 시작하세요.

다수의 서버를 한곳에서 모니터링 하고 싶은 경우

https://github.com/ivsteam/HamoniKR-Mon/wiki/Configuration-as-a-Central-Monitoring-Server-for-Clients

알림설정

1. grafana.ini 설정 변경 - gmail smtp 예시

[smtp]
enabled = true
host = smtp.gmail.com:587
user = 메일주소@gmail.com
# If the password contains # or ; you have to wrap it with trippel quotes. Ex """#password;"""
password = """비밀번호"""
;cert_file =
;key_file =
;skip_verify = false
from_address = 발송메일주소
from_name = Grafana
# EHLO identity in SMTP dialog (defaults to instance_name)
;ehlo_identity = dashboard.example.com

버그 제출 및 기타 이슈 제안

이 프로젝트와 관련하여 이슈는 상단의 이슈 탭을 이용해 주세요.

License

이 프로젝트와 관련하여 이슈는 상단의 이슈 탭을 이용해 주세요.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

For the versions available, see the tags on this repository.

Authors

• Kevin Kim - Initial work

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details