API by example
by Andrea Vacche, Patrik Uytterhoeven, Rihards Olups
Zabbix: Enterprise Network Monitoring Made Easy
- Zabbix: Enterprise Network Monitoring Made Easy
- Table of Contents
- Zabbix: Enterprise Network Monitoring Made Easy
- Zabbix: Enterprise Network Monitoring Made Easy
- Credits
- Preface
- I. Module 1
- 1. Getting Started with Zabbix
- The first steps in monitoring
- Zabbix features and architecture
- Installation
- Summary
- 2. Getting Your First Notification
- 3. Monitoring with Zabbix Agents and Basic Protocols
- 4. Monitoring SNMP Devices
- 5. Managing Hosts, Users, and Permissions
- 6. Detecting Problems with Triggers
- 7. Acting upon Monitored Conditions
- 8. Simplifying Complex Configurations with Templates
- 9. Visualizing Data with Graphs and Maps
- 10. Visualizing Data with Screens and Slideshows
- 11. Advanced Item Monitoring
- 12. Automating Configuration
- 13. Monitoring Web Pages
- 14. Monitoring Windows
- 15. High-Level Business Service Monitoring
- 16. Monitoring IPMI Devices
- 17. Monitoring Java Applications
- 18. Monitoring VMware
- 19. Using Proxies to Monitor Remote Locations
- 20. Encrypting Zabbix Traffic
- 21. Working Closely with Data
- 22. Zabbix Maintenance
- A. Troubleshooting
- B. Being Part of the Community
- 1. Getting Started with Zabbix
- II. Module 2
- 1. Zabbix Configuration
- 2. Getting Around in Zabbix
- 3. Groups, Users, and Permissions
- 4. Monitoring with Zabbix
- Introduction
- Active agents
- Passive agents
- Extending agents
- SNMP checks
- Internal checks
- Zabbix trapper
- IPMI checks
- JMX checks
- Aggregate checks
- External checks
- Database monitoring
- Checks with SSH
- Checks with Telnet
- Calculated checks
- Building web scenarios
- Monitoring web scenarios
- Some advanced monitoring tricks
- Autoinventory
- 5. Testing with Triggers in Zabbix
- 6. Working with Templates
- 7. Data Visualization and Reporting in Zabbix
- 8. Monitoring VMware and Proxies
- 9. Autodiscovery
- 10. Zabbix Maintenance and API
- C. Upgrading and Troubleshooting Zabbix
- III. Module 3
- 1. Deploying Zabbix
- 2. Distributed Monitoring
- 3. High Availability and Failover
- Understanding high availability
- Understanding the levels of IT service
- Some considerations about high availability
- Implementing high availability on a web server
- Configuring the Zabbix server for high availability
- Implementing high availability for a database
- Summary
- 4. Collecting Data
- 5. Visualizing Data
- 6. Managing Alerts
- 7. Managing Templates
- 8. Handling External Scripts
- 9. Extending Zabbix
- 10. Integrating Zabbix
- D. Bibliography
- Index
As it's always easier to understand things when you see a working example, I have added a simple example that you can use to create hosts, link them to a template and add them to the correct group.
For this recipe, we only need our Zabbix server with the super administrators account that was created at the installation. We need to install the Zabbix agent on the Zabbix server. There is no need to change any of the parameters just make sure that the Zabbix server is monitored by Zabbix. Once it is working, remove the Zabbix server host from the list of hosts in Zabbix as we will add it again by making use of the API.
- Log into your Zabbix server.
- Install the EPEL repository as we need
pipon our machine installed:yum install http://fedora.cu.be/epel/6/i386/epel-release-6-8.noarch.rpm - Install
pythonandpython-pipon your Zabbix server as follows:yum install python python-pip - Install the third-party tool PyZabbix as follows:
pip install pyzabbix - Now create a file called
zabbix_host_add.pywithvior another editor and copy the following code into this file and save it. - Alter host parameters where needed:
#!/usr/bin/python from pyzabbix import ZabbixAPI # IP of the Zabbix server ZABBIX_SERVER = 'http://127.0.0.1/zabbix' # Host Parameters host_name='Zabbix server' ip='127.0.0.1' group='Zabbix servers' template='Template App Zabbix Server' port=10050 login='Admin' password='zabbix' zapi = ZabbixAPI(ZABBIX_SERVER) # Login to the Zabbix API zapi.login(login, password) group_id = zapi.hostgroup.getobjects(name=group)[0]['groupid'] template_id = zapi.template.getobjects(name=template)[0]['templateid'] print(group_id) print(template_id) zapi.host.create ( { "host": host_name, "interfaces":[{ "type":1, "dns":"", "main":1, "ip": ip, "port": port, "useip": 1, }], "groups": [{ "groupid": group_id }], "templates": [{ "templateid": template_id }], }) print('Host Added') - Now let's run our script with the following command:
python zabbix_host_add.py
When the script has run, you should see some output with the groupid and the templateid parameters and at the last line you will get a message that says: 'Host Added'.
Now let's go to Zabbix to Configuration | Hosts and you should see your Zabbix server back in the list linked with the correct Zabbix template added to the correct group Zabbix servers.
By making use of PyZabbix, we added a host to our Zabbix server in an easy way. First we defined some parameters such as username, password, hostname, hostgroup, and template. Then we told PyZabbix to authenticate us on the Zabbix server through the API. PyZabbix then gathered the correct ID information for the template and the group we had specified. Next we launched zapi.host.create file with all the parameters specified that are necessary to create a new host.
-
No Comment