jpnr79 / zabbix-csv-host-import-module

Zabbix frontend module for importing hosts via CSV files

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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

License:GNU Lesser General Public License v3.0


Languages

Language:PHP 100.0%