当前位置：首页 > ds >正文

Zabbix API自动化运维实战

ds 2025/8/12 16:35:02

在当今快速发展的IT环境中，自动化的价值不言而喻。通过使用Zabbix API进行自动化运维，不仅可以提高效率、减少错误，还能更好地管理和监控复杂的IT基础设施。本文将介绍如何利用Zabbix API来实现自动化运维，并分享一些实用的例子。

Zabbix API 实现自动化运维

Zabbix API 介绍

Zabbix API允许用户通过HTTP请求与Zabbix服务器交互，执行各种操作，如管理主机、获取监控数据、创建触发器等。API基于JSON-RPC 2.0协议，支持多种编程语言调用，包括Python、PHP、Java等，为自动化运维提供了强大的工具。API（Application Programming Interface，应用程序编程接口）是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组功能的能力，而又无需直接使用源代码，或理解内部工作机制的细节。
Zabbix API允许你以编程方式检索和修改Zabbix的配置，并提供对历史数据的访问。它广泛用于：

创建新的应用程序以使用Zabbix
将Zabbix与第三方软件集成
自动执行常规任务

Zabbix API是基于Web的API，作为Web前端的一部分提供。它使用JSON-RPC 2.0协议，这意味着：

该API包含一组独立的方法
客户端和API之间的请求和响应使用JSON格式进行编码

为什么选择Zabbix API？

灵活性：能够根据特定需求定制解决方案。
集成性：轻松与其他系统和应用集成，如CI/CD管道、告警系统等。
扩展性：支持大规模部署，适应不断增长的业务需求。
自动化：实现从监控到响应的一系列自动化操作，提高运维效率。

基本概念

API访问：需要有效的Zabbix用户名和密码进行身份验证，获得授权后才能调用API。
方法(Method)：代表要执行的操作，例如host.create用于创建新主机。
参数(Params)：每个方法都有相应的参数，描述了操作的具体细节。
结果(Result)：成功调用API后返回的数据或状态信息。
官方帮助

https://www.zabbix.com/documentation/7.0/zh/manual/api

Zabbix API 开始扮演着越来越重要的角色，尤其是在集成第三方软件和自动化日常任务时。很难想象管理数千台服务器而没有自动化是多么的困难。Zabbix API 为批量操作、第三方软件集成以及其他作用提供可编程接口。Zabbix API 是在 1.8 版本中开始引进并且已经被广泛应用。所有的 Zabbix 移动客户端都是基于 API，甚至原生的 WEB 前端部分也是建立在它之上。Zabbix API 中间件使得架构更加模块化也避免直接对数据库进行操作。
API 采用 JSON-RPC 实现。这意味着调用任何函数，都需要发送 POST 请求，输入输出数据都是以 JSON 格式。
Zabbix API由许多名义上分组的独立API方法组成。每个方法执行一个特定任务。
例如，方法 host.create 隶属于 host 这个API分组，用于创建新主机。API分组有时被称为”类“。
大多数API至少包含四种方法: get， create， update 和 delete ，分别是检索，创建，更新和删除数据，但是某些API提供一套完全不同的一组方法。

Zabbix常用API

user.login                      #用户登录
host.get(create|delete|update)  #主机操作
hostgroup.get(create|delete|update) #主机组操作
item.get(create|delete|update)  #监控项目操作
history.get                     #历史数据查询
event.get                       #事件查询
trigger.get                     #触发器查询

API 使用案例

API路径和Web服务器相关

#如果是基于Nginx
http://${ZABBIX_SERVER}/api_jsonrpc.php 
#如果是基于Apache
http://${ZABBIX_SERVER}/zabbix/api_jsonrpc.php

获取 Token

在访问Zabbix内部的任何数据之前，需要登录并获得身份验证令牌。这可以使用user.login方法来完成。假设以Zabbix的Admin用户登录。那么JSON请求将是这样的。

[root@zabbix-server ~]#cat zabbix-api-token.sh 
#!/bin/bash
ZABBIX_SERVER=192.168.1.20curl -s -XPOST -H "Content-Type: application/json-rpc" -d '                                           
{
"jsonrpc": "2.0",
"method": "user.login",
"params": {
"username": "Admin",
"password": "zabbix"
},
"id": 1,
"auth": null
}' http://${ZABBIX_SERVER}/zabbix/api_jsonrpc.php
[root@zabbix-server ~]#bash zabbix-api-token.sh |jq
{"jsonrpc": "2.0","result": "aba6b206f6853cdd4400dc8cee3303a2","id": 1
}[root@zabbix-server ~]#bash zabbix-api-token.sh|python3 -m json.tool
{"jsonrpc": "2.0","result": "6b905752f853bec8f507171475f4a102","id": 1
}

使用以上令牌获取所有主机列表

[root@zabbix-server ~]#cat zabbix-api-gethostlist.sh 
#!/bin/bashZABBIX_SERVER=192.168.1.20
TOKEN=$(./zabbix-api-token.sh| awk -F'"' '{print $8}')curl -s -XPOST -H "Content-Type: application/json-rpc" -d '
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {"output": [ "host" ]},
"id": 1,
"auth": "'$TOKEN'"
}' http://${ZABBIX_SERVER}/zabbix/api_jsonrpc.php | python3 -m json.tool
[root@zabbix-server ~]#bash zabbix-api-gethostlist.sh 
{"jsonrpc": "2.0","result": [{"hostid": "10084","host": "Zabbix server"},{"hostid": "10668","host": "192.168.1.70"},{"hostid": "10669","host": "192.168.1.10"},{"hostid": "10670","host": "192.168.1.9"}],"id": 1
}

使用以上令牌获取所有主机信息

[root@zabbix-server ~]#cat zabbix-api-gethostinfo.sh 
#!/bin/bash
ZABBIX_SERVER=192.168.1.20
TOKEN=$(./zabbix-api-token.sh| awk -F'"' '{print $8}')curl -s -XPOST -H "Content-Type: application/json-rpc" -d '
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {"output": [ "hostid", "host" ],"selectInterfaces": [ "interfaceid", "ip" ]},"id": 1,"auth": "'${TOKEN}'"
}' http://${ZABBIX_SERVER}/zabbix/api_jsonrpc.php | python3 -m json.tool
[root@zabbix-server ~]#bash zabbix-api-gethostinfo.sh 
{"jsonrpc": "2.0","result": [{"hostid": "10084","host": "Zabbix server","interfaces": [{"interfaceid": "1","ip": "127.0.0.1"}]},{"hostid": "10668","host": "192.168.1.70","interfaces": [{"interfaceid": "31","ip": "192.168.1.70"}]},{"hostid":