Skip to content

Commit 7818aef

Browse files
committed
docs: add instructions for zabbix-agent
1 parent 4b74ff0 commit 7818aef

File tree

1 file changed

+49
-3
lines changed

1 file changed

+49
-3
lines changed

README.rst

Lines changed: 49 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -93,11 +93,13 @@ Add this template like `PostgresPro-Linux` at your monitoring host, or create ho
9393
9494
$ mamonsu zabbix host create <client name> <hostgroup id> <template id> <ip> --url=http://zabbix/ --user=Admin --password=zabbix
9595
96-
Generate config on monitring host (or use preinstalled):
96+
Generate config on monitring host or use preinstalled:
9797

9898
.. code-block:: bash
9999
100100
$ mamonsu export config /etc/mamonsu/agent.conf --add-plugins /etc/mamonsu/plugins
101+
or get example of config with all avaliable parameters
102+
$ wget https://raw.githubusercontent.com/postgrespro/mamonsu/master/packaging/conf/agent.conf.example
101103
102104
Change previously zabbix server address and client hostname:
103105

@@ -131,13 +133,57 @@ Change previously zabbix server address and client hostname:
131133
file = /var/log/mamonsu/agent.log
132134
level = INFO
133135
136+
These are the main mamonsu settings to get started. You can also fine-tune other mamonsu settings
137+
as explained in the section called “Configuration Parameters” of the intruction avaliable at https://postgrespro.com/docs/postgrespro/10/mamonsu.
138+
134139
Bootstrap DDL for monitoring (if you want to monitoring without superuser rights)
135140

141+
Create non-privileged user (for example 'mamonsu')
142+
136143
.. code-block:: bash
137144
138-
$ createdb mamonsu
139145
$ createuser mamonsu
140-
$ mamonsu bootstrap -U postgres -d mamonsu
146+
147+
Implement bootstrap from non-privileged user
148+
149+
.. code-block:: bash
150+
151+
$ mamonsu bootstrap -M mamonsu
152+
153+
=======================
154+
Work with zabbix-agent
155+
=======================
156+
NOTE: Mamonsu zabbix agent option does not work for Windows
157+
158+
Export template for zabbix-agent:
159+
160+
.. code-block:: bash
161+
162+
$ mamonsu export zabbix-template template_agent.xml
163+
or
164+
$ wget https://raw.githubusercontent.com/postgrespro/mamonsu/master/packaging/conf/template_agent.xml.example
165+
166+
Export configuration file for zabbix-agent:
167+
168+
.. code-block:: bash
169+
170+
$ mamonsu export zabbix-parameters userparameters_pgsql.conf
171+
or
172+
$ wget https://raw.githubusercontent.com/postgrespro/mamonsu/master/packaging/conf/userparameters_pgsql.conf.example
173+
174+
NOTE: Bash scripts for OS parameters monitoring are exported with configuration file in directory /scripts
175+
176+
Or you can download them separatly:
177+
178+
.. code-block:: bash
179+
180+
$ wget https://raw.githubusercontent.com/postgrespro/mamonsu/master/packaging/conf/scripts
181+
182+
Add configuration file to /etc/zabbix/zabbix_agentd.d/userparameters_pgsql.conf
183+
184+
NOTE: Make sure path for bash scripts in zabbix-agent configuration file is valid
185+
186+
Follow standart instructions for zabbix-agent installation (https://www.zabbix.com/documentation/3.4/manual/concepts/agent)
141187

142188
==================
143189
Write your plugin

0 commit comments

Comments
 (0)