如何使用Zabbix API批量修正主机名称

先说为什么要修正？

这其实源自于Ansible安装zabbix agent的一个小Bug。有小伙伴发现，利用ansible批量安装zabbix agent后，zabbix系统上显示的主机名出错了，主机显示的名称都变成了操作系统的IP（如下图），这在一定程度增加了维护难度。

如果一台一台去修改和校正主机名将会非常耗费时间，这时候就可以利用zabbix API批量修正主机名称。如下：

 

1 环境准备

1.1 基础环境：python3

具体安装步骤参考网上教程。

1.2 python3第三方库安装：

pip install openpyxl requests

 

2 获取主机清单

2.1 示例代码

import requests

import json

import openpyxl


# Zabbix服务器的URL和认证信息

zabbix_url = "http://zabbix_web访问IP电子地址/zabbix/api_jsonrpc.php" #Zabbix web 访问地址

zabbix_username = "zabbix用户名称"

zabbix_password = "zabbix用户密码"


# 获取认证令牌

def get_auth_token():

    payload = {

        "jsonrpc": "2.0",

        "method": "user.login",

        "params": {

            "user": zabbix_username,

            "password": zabbix_password

        },

        "id": 1,

        "auth": None

    }

    headers = {

        'Content-Type': 'application/json-rpc',

    }

    response = requests.post(zabbix_url, headers=headers, data=json.dumps(payload))

    result = response.json()

    if 'result' in result:

        return result['result']

    else:

        raise Exception(f"Error obtaining auth token: {result}")

# 获取所有手动添加的主机对象（排除自动发现的主机）

def get_manual_hosts(auth_token):

    payload = {

        "jsonrpc": "2.0",

        "method": "host.get",

        "params": {

            "output": ["hostid", "host", "name"],  # 只获取所需字段

            "filter": {

                "flags": "0"  # 只获取手动添加的主机

            }

 

2.2 代码参数修改

填写zabbix API地址，用户以及密码

# Zabbix服务器的URL和认证信息

zabbix_url = "http://zabbix_web访问IP电子地址/zabbix/api_jsonrpc.php" #Zabbix web 访问地址，如：http://192.168.1.1/zabbix/api_jsonrpc.php

zabbix_username = "zabbix用户名称"

zabbix_password = "zabbix用户密码"

注：API地址为zabbix web访问地址，如采用分布式部署（即zabbix web与 zabbix server不在同一台服务器），请勿填写zabbix server服务器地址。

2.3代码执行

python3 zabbixApi_hosts.py

#脚本执行完毕后会在同级目录生成一份excel表zabbix_hosts.xlsx

 

3 更新主机可见的名称

3.1 修改excel表中的可见的名称

3.2 提交API更新数据

修改脚本参数

if __name__ == "__main__":

    #main1() #注释执行main1

    main2()  #mian2为从 zabbix_hosts.xlsx 文件读取更新后的信息并提交到 Zabbix API 进行更新。

修改前：

修改后：

这样我们就实现了利用Zabbix API 批量修改主机显示的名称。