API使用
zabbix官网文档：https://www.zabbix.com/documentation/2.2/manual/api，
Zabbix API是基于JSON-RPC 2.0规格，具体实现可以选择任何自己爱好的编程语言，可以采用Perl、Ruby、PHP之类的。
本文已python为例。python zabbix api模块较多，使用较为方便。
下面是各个语言zabbix模块及github连接，可共参考。
数据流程
下面的流程图代表了Zabbix API 工作的典型工作流。验证（方法user.login）是获取验证ID的强制步骤。这个ID又允许我们调用API提供的任何权限允许的方法来进行操作。在之前的例子中没有提到user.logout方法，这也是一次验证ID能够重复使用的原因所在。使用user.logout方法后将会使验证ID失效，后面的操作将不能再使用此ID。
Python
py-zabbixby Alexey Dubkov - Zabbix Modules for Python (PyPI py-zabbix, no python3)
ZabbixPythonApiby Frank Yao - Zabbix API for Python (no python3)
zabbixby gescheit - a Python library (PyPI zabbix-api)
PyZabbixby Luke Cyca - a Python module (PyPI pyzabbix, depends-on requests)
zabbix_apiby Grigoriy Netsman - scripts for creating and deleting hosts (depends on zabbix-api)
zabbix-clientby Jesús Losada - a Python library (PyPI zabbix-client)
zabbix-api-erigonesby Erigones - a Python library (PyPI zabbix-api-erigones)
pyZabbixSenderby Kurt Momberg - a zabbix_sender replacement for Python.
Ruby
Zabbix APIby nelsonab (latest code seems to be on github) - a Ruby wrapper
Rubixby Dhruv Bansal - a Ruby library for working with the API and both retrieving and sending data to Zabbix server
zabbyby Farzad Farid - a Ruby library and client for Zabbix
Perl
Zabbix-APIby SFR-ZABBIX - Perl distribution to access the Zabbix API
ZabbixAPIby Tomohiro Ikeda - a Perl library
Zabipiby Andrey Konovalov - Monitoring::Zabipi module that lets you use official Zabbix API documentation to create Perl applications interacting with Zabbix. Contains additional methods (such as queue.get) and hacks (such as expandNames parameter for item.get). Many examples of usage included in distributive.
Net-Zabbixby ksyz - Perl wrapper for Zabbix API
Zabbix-API-Clientby Matsumoto Ryosuke - Zabbix API client for Perl
Java
zabbix-api by hengyunabc - Java library to access Zabbix API
zabbix-sender by hengyunabc - Java library to use Zabbix sender protocol
PHP
PhpZabbixApi by confirm IT solutions GmbH - a PHP wrapper class and a wrapper code generator
microzabbixapiconnector by Alex Kashin - a Micro-Zabbix-Api-Connector with proxy usage support
PowerShell
ZabbixPosh Api by simsaull - A Zabbix PowerShell Module
Zabbix by Benjamin RIOUAL - An other Zabbix module, based on Invoke-RestMethod
JavaScript
jqzabbix by Kodai Terashima - jQuery plugin for Zabbix API
zabbix.js by Kristoffer Berdal - a library based around request.js
C#
c# api library by cheezus - a C# library for .NET 2.0
C# Library by HenriqueCaires - a C# library for .NET 4.5
Go
zabbixby Ryan Day - Zabbix API for Go
go-zabbix "by Alexey Dubkov" - Zabbix Packages for Go
zabbix-senderAlexey Palazhchenko - push data to Zabbix server's trapper items from Go application
zabbix.goAlexey Palazhchenko - Zabbix API for Go
自动化简介
目前我们使用pyzabbix模块，用json定义template 文件。
下文讲解用法（api 参考官网手册）：
#!/usr/bin/env python
#jiayun
#version 1.3
from pyzabbix import ZabbixAPI
import json
import os,sys
import re,time
import logging
rule = json.load(file('D:\pycharm\project\REGION Manage Script\qn_rolerule.json')) #template 文件
def login():
zapi= ZabbixAPI("http://10.4.0.247") #登录zabbix
zapi.login("admin","zabbix")
return zapi
def get_hostgroups(group_name):
return zapi.hostgroup.get(search={"name":group_name },output="extend") #搜索输入的组别，提取组id
def get_hosts(groupid):
groupids = [groupid]
return zapi.host.get(groupids=groupids,output="extend") #返回该组id 下的所有host 信息
def get_drules():
return zapi.drule.get(output="extend")
def get_templates_by_names(template_names):
return zapi.template.get(filter={"host": template_names})
def create_group(group_name): #创建组
if not zapi.hostgroup.exists(name=group_name):
zapi.hostgroup.create(name=group_name)
def create_host(group_name,host_name,ip): #创建主机并附加指定模板
groups=get_hostgroups(group_name)
host_name=host_name.lower()
ip_tail=ip.split(".")[-1]
domain = "server-"+ ip_tail +".0." + host_name + ".ustack.in"
for hostgroup in groups:
groupid=hostgroup['groupid']
ip_tail=ip.split(".")[-1]
role = None
for ru in rule:
range = rule[ru]['range']
if "-" in range:
head = range.split("-")[0]
tail = range.split("-")[1]
if int(ip_tail) <= int(tail) and int(ip_tail) >=int(head):
role = ru
else:
if ip_tail == range:
role = ru
template_names = rule[role]['templates']
template_ids = get_templates_by_names(template_names)
print domain,ip,groupid,template_ids
zapi.host.create(host=domain,interfaces=[{
"type":1,
"main":1,
"useip":1,
"ip":ip,
"dns":"",
"port":''
}],groups=[{"groupid":groupid}],templates=template_ids)
print "Add Successfull!!!!!"
#logging.info("%s,%s,%s,%s Add Successfull!!!!!"%(domain,ip,groupid,template_ids))
def create_macro(group_name,traffic,value): #创建macro，不同主机有不同的macro
groups=get_hostgroups(group_name)
for group in groups:
hosts=get_hosts(group['groupid'])
for host in hosts:
hostname=host["name"]
hostid=host["hostid"]
if not re.search("^server",hostname):continue
m=re.search("[0-9]+",hostname).group()
if m == "":continue
if m in ['','','','']:
zapi.host.update(hostid=hostid,macros=[{"macro":"{$INP}","value":""},
{"macro":"{$OUP}","value":""},
{"macro":"{$INT}","value":"%s"%traffic},
{"macro":"{$OUT}","value":"%s"%traffic},
{"macro":"{$PDISK}","value":"%s"%value}])
else:
zapi.host.update(hostid=hostid,macros=[{"macro":"{$PDISK}","value":"%s"%value}])
print hostname ,hostid,m,traffic,value
if __name__ == "__main__":
zapi=login()
region="qn"
host_list=["","","","","","","","","","","","","","","","","","","","",
"","","","","","","","","","","","","","","","","","","","","","",""] #添加主机，不建议用discovery
ip_list=host_list
if type(ip_list) == str:
print "%s Must be a list,please checking !!!"%sys.argv[2]
sys.exit()
group_name="Region [%s 0]"% region.upper()
if not zapi.hostgroup.exists(name=group_name):
create_group(group_name)
ip={"qn":"10.4.0."}
if region in ip:
for num in ip_list:
value=""
traffic="300M"
ipaddress=ip[region]+str(num)
print group_name,region,ipaddress
create_host(group_name,region,ipaddress) #传参至函数
time.sleep(5)
create_macro(group_name,traffic,value)
else:
print "you input region error,please checking"