[Zabbix 5.4] 자빅스 로켓챗 연동 방법 (zabbix rocketchat integration, zabbix rocketchat webhook)

자빅스 로켓챗 연동 방법

 

1. 로켓챗 로그인 → 내 계정 → 개인 접근 토큰 → 임의 문자열 입력 → 추가

※ 로켓챗 계정은 알람용으로 사용할 계정으로 진행 하시면 됩니다. 

 

 

아래 내용에서 출력되는 토큰과 사용자 ID는 메모장이나 다른 문서에 저장하신 후 ok 버튼을 눌러 창을 종료 해주세요.

 

2. Administration → Media types → Rocket.Chat

※ Rocket.Chat이 없을 경우 https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/rocketchat/media_rocketchat.yaml 에서 yaml파일을 Import 해주세요.

 

1. rc_url : 로켓챗 URL 입력
2. rc_user_id : 1번 과정에서 획득한 사용자 ID 입력
3. rc_user_token : 1번 과정에서 획득한 토큰 입력

 

3. Administration → General → Macros → {$ZABBIX.URL} 전역 변수 추가

 

 

Value에는 자빅스 URL 주소를 입력 해주시면 됩니다. (ex. http://10.10.10.10/zabbix)

 

4. Administration → Users → Create User

 

아래와 같이 사용자 계정 정보를 입력 합니다.

 

Media → Add 버튼을 클릭한 후 아래와 같이 Type은 Rocket.Chat을 작성 해주세요. Send to 필드는 알람 받을 채널명을 입력 해주시면 됩니다. (ex. 비공개 채널: #test / 특정 사람: @user)

※ 로켓챗에 존재하는 채널명으로 작성해야 합니다.
※ 실제 로캣챗 채널명과는 관계 없이 소문자로만 작성 해보시길 바랍니다. 필자의 경우 Send to 필드에 대소문자를 구분해 작성 했더니 "Cannot read property 'tmid' of undefined" 에러가 발생 했습니다.

 

Permissions 에서 Suer admin role을 선택하고 저장 해주세요.

 

5. Configuration → Actions → Trigger actions → Create action

 

 

※ Conditions 필드의 경우 어떤 서버들을 대상으로 Action할지에 대한 조건부 입니다. zabbix server로 테스트할 생각이라면 아래와 같이 설정 해주시기 바랍니다.

 

Opertaions 클릭 후 아래 스크린샷을 참고하여 설정을 진행 합니다.

 

 

알람 테스트

 

 

ICMP Ping 템플릿(자빅스에서 기본 제공)을 추가 해주세요.

 

ICMP를 검색하고 Triggers를 눌러 줍니다.

 

아래 스크린샷을 참고하여 =0을 =1로 변경 해줍니다.

※ 0=Up, 1=Down 입니다. 임의로 트리거 조건을 변경해주어 알람을 발생 시키는 것 입니다.

 

아래와 같이 알람 수신을 확인하면 끝 입니다. 알람이 잘 동작하는걸 확인 하셨다면 위에서 수정한 ICMP 트리거 설정을 =0 으로 원복 해주시면 됩니다.