Skip to content

jpnr79/zabbix-csv-host-import-module

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 

Repository files navigation

IntelliTrend Zabbix CSV Host Importer

This is a Zabbix frontend module that provides a simplified host import via CSV files.

csv-host-importer

License

This software is licensed under the GNU Lesser General Public License v3.0.

Download

You can find the latest versions for the respective Zabbix releases on the Github releases page.

Changelog

Version 6.0.2

  • Fixed "Missing host list in session" error when reading larger CSV files
  • Fixed incorrect host group and template assignment when the respective fields are empty
  • Optional CSV columns now can be omitted entirely from the CSV file instead of leaving them empty

Version 6.0.1

  • Support for Zabbix 6.0

Version 5.4.2

  • Support for Zabbix 5.0, 5.2 and 5.4
  • Non-functional menu entry for non-superadmins is now hidden

Version 5.0.2

  • Added support for templates

Version 5.0.1

  • Improved validation of CSV input

Version 5.0.0

  • Initial public release for Zabbix 5.4

Requirements

  • Zabbix 6.0
  • File write access to the Zabbix frontend server
  • Super admin permissions for the Zabbix users that want to use the frontend module

Installation

For Debian and Ubuntu server, the Zabbix Frontend modules are usually placed in /usr/share/zabbix/modules/.

Copy the folder modules/csv-host-importer to /usr/share/zabbix/modules/csv-host-importer on the Zabbix frontend web server.

Then go to Administration, General, Modules, click Scan directory and enable the new module in the list.

Usage

Once the frontend module is activated, a new menu entry Host CSV Importer should appear under Configuration.

Here's an example of two hosts: the first one with Zabbix agent and another with an SNMPv2 agent:

NAME;VISIBLE_NAME;HOST_GROUPS;TEMPLATES;AGENT_IP;AGENT_DNS;SNMP_IP;SNMP_DNS;SNMP_VERSION;DESCRIPTION
example1;Example Host Agent;First host group, second host group;Linux by Zabbix agent;127.0.0.1;localhost;;;;Example Zabbix Agent host
example2;Example Host SNMP;Third host group;Generic SNMP;;;127.0.0.1;localhost;2;Example SNMPv2 host

The following CSV columns are supported:

Name Purpose Optional
NAME Host name.
VISIBLE_NAME Host visible name.
HOST_GROUPS List of host group names, separated by a comma. Missing host groups are created automatically.
TEMPLATES List of template names to assign to the host, separated by a comma. Templates must exist with the specified name.
AGENT_IP Interface: Zabbix Agent IP address.
AGENT_DNS Interface: Zabbix Agent DNS name.
SNMP_IP Interface: SNMP IP address.
SNMP_DNS Interface: SNMP DNS name.
SNMP_VERSION Interface: SNMP version number (1, 2 or 3).
DESCRIPTION Host description field.

Additional hints:

  • The columns are case-insensitive, so NAME, name and NaMe are all valid.
  • The columns must be in the first line of the CSV file.
  • The separator character must be ";".

The CSV file can then be imported in the same menu entry. You get a chance to preview the host list before the actual import.

About

Zabbix frontend module for importing hosts via CSV files

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%