Zhong__zabbix安装与pyzabbix使用

时间：2021.03.03

环境：CentOS Linux release 7.8.2003 (Core)/Python3.9

目的：安装zabbix 使用Python操作zabbix

说明：本教程使用CentOS7系统 安装5.0LTS zabbix版本 使用MySQL数据库 使用Apache web server

           可直接根据官网指导下载安装与配置 本文对官网指导文档做了整理与补充 具体以官网为准

作者：Zhong QQ交流群：121160124 欢迎加入！

 

下载安装

官网下载地址与安装指导网址：zabbix下载

1. 选择合适平台

选择你要安装的zabbix版本、系统与版本、数据库(MySQL/PostgreSQL)和web服务代理(Apache/NGINX)

2. 安装与配置zabbix服务

a. 安装Zabbix仓库

rpm -Uvh https://repo.zabbix.com/zabbix/5.0/rhel/7/x86_64/zabbix-release-5.0-1.el7.noarch.rpm
yum clean all

b. 安装Zabbix server 和agent

yum install zabbix-server-mysql zabbix-agent

c. 安装Zabbix前端

启用Red Hat Software Collections

yum install centos-release-scl

编辑/etc/yum.repos.d/zabbix.repo文件 启用zabbix-frontend仓库

[zabbix-frontend]
...
enabled=1
...

安装Zabbix前端包

yum install zabbix-web-mysql-scl zabbix-apache-conf-scl

d. 创建、初始化数据库

确认已安装并启动了数据库服务

运行如下的命令进入数据库 并创建zabbix用户和zabbix数据库 完成用户授权

mysql -uroot -p
# 根据提示输入数据库密码
mysql> create database zabbix character set utf8 collate utf8_bin;
mysql> create user zabbix@localhost identified by 'password';
mysql> grant all privileges on zabbix.* to zabbix@localhost;
mysql> quit;

在Zabbix服务主机上使用zabbix用户导入zabbix初始化数据到zabbix数据库 此处提示要输入的密码为上面设置zabbix用户的密码

zcat /usr/share/doc/zabbix-server-mysql*/create.sql.gz | mysql -uzabbix -p zabbix
# 根据提示输入密码

e. 为Zabbix server配置数据库

编辑/etc/zabbix/zabbix_server.conf文件 password为MySQL用户zabbix的密码

DBPassword=password

f. 为Zabbix前端配置PHP

编辑/etc/opt/rh/rh-php72/php-fpm.d/zabbix.conf文件 去掉下面内容的注释 并配置时区 如 php_value[date.timezone] = Asia/Shanghai

; php_value[date.timezone] = Europe/Riga

g. 开启Zabbix server和agent进程

开启Zabbix server和agent进程 设置开机启动

systemctl restart zabbix-server zabbix-agent httpd rh-php72-php-fpm
systemctl enable zabbix-server zabbix-agent httpd rh-php72-php-fpm

h. 配置Zabbix前端

浏览器输入地址连接到刚才安装的Zabbix前端: http://server_ip_or_name/zabbix  如 192.168.1.2/zabbix  请确认防火墙策略允许通信 登录页面如下图

此处的用户名/密码默认为Admin/zabbix

后面的步骤按照实际情况与环境的要求自己配置就行了

简单使用

web页面默认为英文界面  可在User settings菜单设置显示语言为中文

新建主机

新建监控主机 菜单栏依次选择Configuration → Hosts 然后选择Create host按钮创建被监控的主机 可以是其它主机 也可以是server主机

根据要求填入相应内容 Host name全局唯一 可唯一标识一台主机  hostid也是

新建item

有了主机就可以建立item

选择目标主机点击相应的Items 选择Create item来进行创建 填入相应的内容即可

这儿的Key可以选择系统内置的 也可以直接写入在/etc/zabbix/zabbix_agentd.conf文件中Option: UserParameter里自定义的key  以下为多个自定义key演示

...
UserParameter=goodboy,cat /proc/cpuinfo | grep "physical id" | sort | uniq | wc -l
UserParameter=axiba,ls -l
...

 返回类型要与实际一致

选择Test按钮可以进行测试配置

pyzabbix安装与简单使用

安装

pip install pyzabbix

使用

You can now import and use pyzabbix like so

from pyzabbix import ZabbixAPI

zapi = ZabbixAPI("http://zabbixserver.example.com")
zapi.login("zabbix user", "zabbix pass")
print("Connected to Zabbix API Version %s" % zapi.api_version())

for h in zapi.host.get(output="extend"):
    print(h['hostid'])

Customizing the HTTP request

from pyzabbix import ZabbixAPI

zapi = ZabbixAPI("http://zabbixserver.example.com")

# Enable HTTP auth
zapi.session.auth = ("http user", "http password")

# Disable SSL certificate verification
zapi.session.verify = False

# Specify a timeout (in seconds)
zapi.timeout = 5.1

# Login (in case of HTTP Auth, only the username is needed, the password, if passed, will be ignored)
zapi.login("http user", "http password")

简单封装获取item信息

import sys
from pprint import pprint
from pyzabbix import ZabbixAPI

class PyZabbix():

    """
    使用pyzabbix获取zabbix数据信息
    """

    def __init__(self, url, username, password):
        # self.url = url
        # self.username = username
        # self.password = password
        self.zapi = self.login(url=url, username=username, password=password)

    # 连接登录
    def login(self, url, username, password):
        try:
            zapi = ZabbixAPI(url)
            zapi.login(username, password)
            print("登录成功！")
            print("Connected to Zabbix API 版本: %s" % zapi.api_version())
            return zapi
        except Exception as e:
            print("未成功登录! 请检查登录信息! error：\n", e)
            sys.exit(0)

    # 退出登录
    def logout(self):
        self.zapi.user.logout()
        print("退出成功！")

    # 获取所有的主机信息
    def get_allhost(self):
        for h in self.zapi.host.get(output="extend"):
            # pprint(h)
            print("host:\n%s" % h['host'])
            print("hostid:\n %s" % h['hostid'])
            print("name:\n %s" % h['name'])

    # 获取指定主机的item数据
    def get_item_data(self, item_keys=None, hostids_list=None, host_list=None):
        res = {}
        # 指定hostids或者host
        if hostids_list:
            for hostids in hostids_list:
                res[hostids] = []
                for key_ in item_keys:
                    item_res = self.zapi.item.get(hostids=hostids, search={"key_": key_}, output="extend")  # 输出所有内容
                    if item_res:
                        if key_ == "vm.memory.size[total]":
                            item_res[0]['lastvalue'] = str("%0.2f" % (int(item_res[0]['lastvalue']) / 1024 ** 3)) + 'G'
                        elif key_ == "vfs.fs.size[/,total]":
                            item_res[0]['lastvalue'] = str("%0.2f" % (int(item_res[0]['lastvalue']) / 1024 ** 3)) + 'G'
                        elif key_ == "vm.memory.size[available]":
                            item_res[0]['lastvalue'] = str("%0.2f" % (int(item_res[0]['lastvalue']) / 1024 ** 3)) + 'G'

                        res[hostids].append(item_res)
        if host_list:
            for host in host_list:
                res[host] = []
                for key_ in item_keys:
                    item_res = self.zapi.item.get(host=host, search={"key_": key_}, output=['hostid', 'name', 'key_', 'lastvalue'])  # 输出指定内容
                    if item_res:
                        if key_ == "vm.memory.size[total]":
                            item_res[0]['lastvalue'] = str("%0.2f" % (int(item_res[0]['lastvalue']) / 1024 ** 3)) + 'G'
                        elif key_ == "vfs.fs.size[/,total]":
                            item_res[0]['lastvalue'] = str("%0.2f" % (int(item_res[0]['lastvalue']) / 1024 ** 3)) + 'G'
                        elif key_ == "vm.memory.size[available]":
                            item_res[0]['lastvalue'] = str("%0.2f" % (int(item_res[0]['lastvalue']) / 1024 ** 3)) + 'G'

                        res[host].append(item_res)

        return res

    # 获取所有监控主机的item数据
    def get_allhost_item(self):
        all_item_info = self.zapi.item.get(output="extend")
        return all_item_info

if __name__ == '__main__':
    url = "http://127.0.0.1/zabbix/"
    username = "Admin"  # 默认用户名
    password = "zabbix"  # 默认密码

    host_list = ["Zabbix server", "thisisit"]  # zabbix创建新的主机时命名的主机名
    # host_list = []  # zabbix创建新的主机时命名的主机名
    hostids_list = [10084, 10355]  # zabbix创建主机时分配的主机id唯一标识
    # hostids_list = []  # zabbix创建主机时分配的主机id唯一标识
    item_keys = [
        "vm.memory.size[total]",
        "vm.memory.size[available]",
        "vfs.fs.size[/,total]",
        "abc",  # 不存在的key 将忽略
        "goodboy"  # 自定义的key_ 对应/etc/zabbix/zabbix_agentd.conf文件中配置
         ]

    # 创建PyZabbix实例
    zabbix_api = PyZabbix(url=url, username=username, password=password)

    # 获取所有的主机信息
    # zabbix_api.get_allhost()

    # 获取所有监控主机的item数据
    # all_item_info = zabbix_api.get_allhost_item()
    # pprint(all_item_info)

    # 获取指定主机的item数据
    res = zabbix_api.get_item_data(host_list=host_list, hostids_list=hostids_list, item_keys=item_keys)
    pprint(res)

    # 退出登录
    zabbix_api.logout()

关注微信公众号