Hướng dẫn cài MongoDB loadable plugin Cho Zabbix

MongoDB loadable plugin là một công cụ giúp theo dõi mongodb trên Zabbix toàn diện bao gồm hầu hết các thông tin từ Connection pool, Connections, Cursors, Network, Operations rate

Mặc định thì hệ thống không có plugin này chúng ta cần cài thêm như sau:

1: Xây dựng từ mã nguồn

Mã nguồn của plugin có tại đây chúng ta dùng git để tải về

git clone https://git.zabbix.com/scm/ap/mongodb.git

Do mã nguồn này viết bằng golang nên chúng ta cần phải thêm golang bằng các lệnh cài đặt như sau

wget https://go.dev/dl/go1.23.5.linux-amd64.tar.gz
rm -rf /usr/local/go && tar -C /usr/local -xzf go1.23.5.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

Sau khi có được thông tin thì chúng ta sẽ tiến hành vào thư mục code tải về bằng git trên và tiến hành chạy lệnh make

cd mongodb/
make

sau khi chạy song chúng ta sẽ thu được một file có tên là zabbix-agent2-plugin-mongodb

Bạn cần lưu file này ra chỗ nào đó dễ và tiện cho quản lý để chạy ví dụ mình lưu vào thư mục /etc/zabbix/zabbix_agent2.d/file/ với đường dẫn full như sau

/etc/zabbix/zabbix_agent2.d/file/zabbix-agent2-plugin-mongodb

2: Cấu hình Zabbix

Để cấu hình tốt thì chúng ta mở file mongodb.conf trong thư mục code tải về trên git bỏ comment đoạn code sau

# Plugins.MongoDB.System.Path=

Và điền thông tin file chúng ta mới build ở trên

Plugins.MongoDB.System.Path=/etc/zabbix/zabbix_agent2.d/file/zabbix-agent2-plugin-mongodb

Sau đó chuyển file này vào thư mục /etc/zabbix/zabbix_agent2.d/plugins.d/ chúng ta thu được một thư mục như sau

root@mongodb-s-2vcpu-4gb-sfo3-01:/home/mongodb# ls -la /etc/zabbix/zabbix_agent2.d/plugins.d/
total 48
drwxr-xr-x 2 root root 4096 Jan 21 07:26 .
drwxr-xr-x 4 root root 4096 Jan 21 07:22 ..
-rw-r--r-- 1 root root 2237 Dec 20 09:38 ceph.conf
-rw-r--r-- 1 root root  366 Dec 20 09:38 docker.conf
-rw-r--r-- 1 root root 1818 Dec 20 09:38 memcached.conf
-rw-r--r-- 1 root root  592 Dec 20 09:38 modbus.conf
-rw-r--r-- 1 root root 3142 Jan 21 07:26 mongodb.conf
-rw-r--r-- 1 root root 3137 Dec 20 09:38 mqtt.conf
-rw-r--r-- 1 root root 3931 Dec 20 09:38 mysql.conf
-rw-r--r-- 1 root root 2588 Dec 20 09:38 oracle.conf
-rw-r--r-- 1 root root 1353 Dec 20 09:38 redis.conf
-rw-r--r-- 1 root root  388 Dec 20 09:38 smart.conf

Bây giờ chúng ta cấu hình máy chủ ở file /etc/zabbix/zabbix_agent2.conf thay đổi các thông số cho phù hợp nhớ thay 127.0.0.1 thành IP máy chủ zabbix

Server=127.0.0.1
ListenIP=0.0.0.0
ServerActive=127.0.0.1
Hostname=Zabbix server

Sau đó khởi động lại agent

root@mongodb-s-2vcpu-4gb-sfo3-01:/etc/zabbix# service zabbix-agent2 restart
root@mongodb-s-2vcpu-4gb-sfo3-01:/etc/zabbix# service zabbix-agent2 status
● zabbix-agent2.service - Zabbix Agent 2
     Loaded: loaded (/lib/systemd/system/zabbix-agent2.service; enabled; vendor preset: enabled)
     Active: active (running) since Tue 2025-01-21 07:30:45 UTC; 3s ago
   Main PID: 76496 (zabbix_agent2)
      Tasks: 8 (limit: 4647)
     Memory: 10.1M
        CPU: 55ms
     CGroup: /system.slice/zabbix-agent2.service
             └─76496 /usr/sbin/zabbix_agent2 -c /etc/zabbix/zabbix_agent2.conf

Jan 21 07:30:45 mongodb-s-2vcpu-4gb-sfo3-01 systemd[1]: Started Zabbix Agent 2.
Jan 21 07:30:45 mongodb-s-2vcpu-4gb-sfo3-01 zabbix_agent2[76496]: Starting Zabbix Agent 2 (7.2.1)
Jan 21 07:30:45 mongodb-s-2vcpu-4gb-sfo3-01 zabbix_agent2[76496]: Zabbix Agent2 hostname: [Mongodb]
Jan 21 07:30:45 mongodb-s-2vcpu-4gb-sfo3-01 zabbix_agent2[76496]: Press Ctrl+C to exit.

Khi bạn thêm host vào zabbix thì lưu ý chọn template là MongoDB cluster by Zabbix agent 2 nếu bạn chạy cluster còn không thì là MongoDB node by Zabbix agent 2

Trong phần Macros thì bạn điền thông tin theo giá trij

Giá trị	Value
{$MONGODB.CONNSTRING}	tcp://localhost:27057
{$MONGODB.PASSWORD}	mật khẩu tài khoản
{$MONGODB.USER}	tài khoản

Bạn có thể dùng tài khoản admin mongodb hoặc một tài khoản với quyền giới hạn với câu lệnh tạo như sau

db.createUser({
  "user": "zabbix_agent2",
  "pwd": "xxxxxxxxxxxx",
  "roles": [
    { role: "readAnyDatabase", db: "admin" },
    { role: "clusterMonitor", db: "admin" },
  ]
})

Thay xxxx thành mật khẩu của bạn sau đó lưu lại là chúng ta có được thông tin giám sát trên zabbix cần thiết