[Grafana] Grafana에서 이메일 알림 보내기
[Grafana] Grafana에서 이메일 알림 보내기
l Grafana, PMM
Grafana(“그라파나”)에서는 이상 징후를 감지했을 때, 대시보드 패널에서 알림 규칙을 추가하여 다양한 방식으로 알림을 받을 수 있다. 이번 포스트에서는 그라파나에서 이메일로 알람을 보낼 수 있도록 설정하는 방법에 대해서 알아본다.
알람을 이메일로 보내기 위해서는 그라파나에서 SMTP 설정을 해야한다. 물론 SMTP 로 사용할 이메일 서버에서는 SMTP 서비스가 허용되어 있어야 한다. 그라파나가 설치된 서버에서 Grafana.ini 설정파일을 수정하여 SMTP 정보를 등록한다.
| vi /etc/Grafana/Grafana.ini |
설정파일에서 아래 내용을 참고하여 추가하도록 한다.
| [smtp] enabled = true host = smtp.office365.com:587 user = <o365 username> password = <o365 Password> ;cert_file = ;key_file = skip_verify = false from_address = <o365 username> ;from_name = Grafana ;EHLO identity in SMTP dialog (defaults to instance_name) ;ehlo_identity = dashboard.example.com [emails] ;welcome_email_on_sign_up = false |
이번 포스트에서는 네이버 메일로 SMTP를 설정하였다.
| [smtp] enabled = true host = smtp.naver.com587 user = email@naver.com password = your_passwrod ;cert_file = ;key_file = skip_verify = false from_address = email@naver.com ;from_name = Grafana ;EHLO identity in SMTP dialog (defaults to instance_name) ;ehlo_identity = dashboard.example.com [emails] ;welcome_email_on_sign_up = false |
네이버 메일의 SMTP를 사용하려면 네이버에 로그인한 다음 사용자 이메일 설정에서 SMTP를 사용가능하도록 설정이 필요하다. 해당 설정 부분은 다른 글을 참고한다.
grafana.ini 설정이 완료 되었으면 Grafana 서비스를 재시작하여 변경된 설정을 적용한다.
| supervisorctl restart grafana |
컨테이너로 그라파나를 운영하는 경우 아래와 같은 명령으로 컨테이너 내부에서 수정할 수 있다,
| →$sudo docker exec -it pmm-server bash →##cd /etc/grafana →## vi grafana.ini |
또는 컨테이너 실행시 환경변수로 대입하여 설정할 수 있다.
| # Docker run -d -p 80:80 -p 443:443 --volumes-from pmm-data --name pmm-server \ --restart always \ -e GF_SMTP_ENABLED=true \ -e GF_SMTP_HOST=smtp.gmail.com:587 \ -e GF_SMTP_USER=<gmail username> \ -e GF_SMTP_PASSWORD=<gmail password> \ -e GF_SMTP_SKIP_VERIFY=false \ -e GF_SMTP_FROM_ADDRESS=<gmail email address> \ -e GF_SMTP_FROM_NAME=Grafana \ percona/pmm-server:2 |
SMTP 설정이 완료되었으면 Grafana 대시보드의 좌측 메뉴에서 Alerting – Contact point를 클릭 한다.
Alerting 페이지의 Contact point 탭 화면에서 [New contact point]를 클릭한다.
발지자에 사용할 이름과 수신자의 이메일을 등록한다. [Test] 버튼을 클릭하면 이메일을 보내어 정상적으로 발신이 되는지 확인할 수 있다. 설정이 완료되었으면 [Save contact point]를 클릭한다.
메일함을 열어 확인해보면 Grafana가 Test 단계에서 보낸 이메일을 확인할 수 있다.
이메일 세팅이 완료되었으므로, 사용자 환경에 맞게 템플릿을 활용하거나 직접 코드를 작성하여 대시보드에서 이상징후가 감지되었을 때 이메일로 받을 수 있다. 이메일로 알람을 받을 때에는 해당 알람의 관련 그래프나 기타 정보를 함께 포함하여 발송할 수 있다.
2023-11-16 / Sungwook Kang / https://sungwookkang.com
그라파나, Grafana, 알림설정, Alert, email notification, 이메일 설정, 그라파나SMTP, Grafana.ini