README.rst 1.78 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69
============================
Zabbix Agent Software Release
=============================

This Software Release allows to deploy a Zabbix Agent that will connect
to an existing Zabbix Server.

Please see http://www.zabbix.com/ for more informations.


Mandatory parameters
====================

hostname
--------
Name of the machine probed by the agent.

server
------
list of Zabbix servers to connect to, comma-seperated.

Optional parameters
===================

custom-user-parameter
---------------------
Add custom UserParameter(s) lines to the Zabbix Agent configuration file.


Examples of instance parameters XML
===================================

Example 1
~~~~~~~~~

Simple request: just request a new instance of it, with the following parameters::

  <?xml version="1.0" encoding="utf-8"?>
    <instance>
    <parameter id="server">REPLACE BY IP(v6) OF ZABBIX SERVER</parameter>
    <parameter id="hostname">REPLACE BY DESIRED HOSTNAME OF MACHINE</parameter>
  </instance>

Example 2
~~~~~~~~~

Deploy a Zabbix Agent instance for machine named "mymachine" connecting to a Zabbix server accessible from 2001:41d0:1:9b1a::1::

  <?xml version="1.0" encoding="utf-8"?>
    <instance>
    <parameter id="server">2001:41d0:1:9b1a::1</parameter>
    <parameter id="hostname">mymachine</parameter>
  </instance>

Example 3
~~~~~~~~~

Deploy a Zabbix Agent instance for machine named "mymachine" connecting to a Zabbix server accessible from 2001:41d0:1:9b1a::1, with several custom parameters::

  <?xml version="1.0" encoding="utf-8"?>
  <instance>
    <parameter id="server">2001:41d0:1:9b1a::1</parameter>
    <parameter id="hostname">mymachine</parameter>
    <parameter id="custom-user-parameter">
    UserParameter=custom_random,echo $RANDOM
    UserParameter=custom_date,date
    </parameter>
  </instance>