Nirsa

자빅스 로켓챗 연동 방법

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 으로 원복 해주시면 됩니다.

자빅스 에이전트 5.4.1 설치 (Zabbix agent 5.4.1 install)

1. zabbix agent 5.4.1 install

# CentOS 7
rpm -Uvh https://repo.zabbix.com/zabbix/5.4/rhel/7/x86_64/zabbix-release-5.4-1.el7.noarch.rpm
yum install -y zabbix-agent

# CentOS 8
rpm -Uvh https://repo.zabbix.com/zabbix/5.4/rhel/8/x86_64/zabbix-release-5.4-1.el8.noarch.rpm
dnf install -y zabbix-agent

2. zabbix_agentd.conf 설정

/etc/zabbix/zabbix_agentd.conf 파일을 열은 후 아래와 같이 Server, ServerActive 필드를 자빅스 서버의 IP로 입력

3. Firewall 설정

firewall-cmd --permanent --add-rich-rule='rule family="ipv4"\
source address=[자빅스 서버IP] port port="10050" protocol="tcp" accept'
firewall-cmd --reload

※ 해당 포스팅은 https://www.zabbix.com/integrations/rocketchat를 참고하여 진행한 경우에 한합니다.

자빅스 로켓챗 연동 시
Sending failed: Request failed with status code 400: "Invalid href value provided" 에러 해결 방법

해당 에러는 Media type에 의해 발생 합니다. Rocket Chat의 rc_title_link 필드를 보면 {$ZABBIX_URL} 이라는 전역 변수를 사용하는데, 이 전역 변수가 비어 있어 400 상태 코드를 반환하게 됩니다.

{$ZABBIX.URL} 을 삭제하고 직접 자신의 자빅스 URL을 입력 하거나 아래 과정을 따라가서 전역 변수를 설정 해주면 에러를 해결할 수 있습니다.

1. Administration → General → Macros
2. Add → 아래 이미지 참고하여 설정 진행 및 Update

CentOS 8 자빅스 5.4 설치 (zabbix 5.4 install centos8)

1. Install Zabbix server, frontend, agent

# Install Zabbix repository
rpm -Uvh https://repo.zabbix.com/zabbix/5.4/rhel/8/x86_64/zabbix-release-5.4-1.el8.noarch.rpm
dnf clean all

# Install Zabbix server, frontend, agent
dnf install -y zabbix-server-mysql zabbix-web-mysql zabbix-apache-conf zabbix-sql-scripts zabbix-agent

2. Install MySQL 8.0 & Create initial database

# Install MySQL 8.0
dnf install -y mysql mysql-server
systemctl start mysqld && systemctl enable mysqld
mysql -u root -p
[Enter]
mysql> alter user 'root'@'localhost' identified by '사용할 비밀번호';
mysql> commit;

# Create initial database
mysql> create database zabbix character set utf8 collate utf8_bin;
mysql> create user zabbix@localhost identified by '사용할 비밀번호';
mysql> grant all privileges on zabbix.* to zabbix@localhost;
mysql> quit;

zcat /usr/share/doc/zabbix-sql-scripts/mysql/create.sql.gz | mysql -uzabbix -p zabbix

3. Configure the database for Zabbix server

/etc/zabbix/zabbix_server.conf 경로에서 아래와 같이 DBPassword를 입력 합니다. DBPassword는 위에서 생성한 zabbix 계정의 패스워드 입니다.

# firewall open port
firewall-cmd --permanent --zone=public --add-port=80/tcp
firewall-cmd --permanent --zone=public --add-port=10050-10051/tcp
firewall-cmd --reload

# selinux permissive
setenforce 0

# service start
systemctl restart zabbix-server zabbix-agent httpd php-fpm
systemctl enable zabbix-server zabbix-agent httpd php-fpm

4. zabbix 웹 페이지 셋업

이전 페이지는 Next step 해주시고 아래 화면에서 Password를 입력 합니다. 이 Password는 위에서 설정한 MySQL zabbix 계정의 패스워드를 입력 해주시면 됩니다.

GUI settings 부분에서 time zone을 아래와 같이 Asia/Seoul로 맞춰 주세요. 이후 쭉 넘어가서 Finish 해주시면 됩니다.

초기 계정은 아래와 같습니다. (아이디 대소문자를 지켜주셔야 합니다)

• ID : Admin
• PW : zabbix