ZABBIX documentation

[Alexei]

We are looking forward to improve ZABBIX documentation.

I would like to ask ZABBIX users what is missing currently? Quick start guide? Basic concepts? Something else? Perhaps current structure of the manual is not intuitive enough? What was the most confusing part when you met ZABBIX for the first time?

Many thanks for any response!

[abi]

hi,

well, a Quick Start Guide might be best. I think most people
are confused by the different components (agent/agend). It may be
good to have some short Description what each of the services does.

[themons]

Some times it very difficulte to find item table, supported item by plateform or triggers function.

So i made a paper version of a quick reference guide. I always have it near me it may be a good idea to make a quicke reference guide with tables and usefull information.

[Jabberwocky]

The description of the services would be most helpful. Also maybe a map/diagram of the components and how they interact, and where they can be found on the users machine.

[befortin]

A FAQ would definitly be nice. For example :"How to monitor Windows logs". Most users will find out how to setup this kind of thing in the forums, but it would be nice if it was in the documentation. Also, "How agent status works (why it isn't 'updated')". "How to use performance monitor". "How multipliers work and when to use them". "How to configure alerts (for example, use "trigger value == ON and trigger name like "blablabla".

Some documentation about how to install the agent on Windows is also missing. I know it's easy to setup the agent on windows, using the .bat file that comes in Zabbix, but still...

Also, I think some information is missing about how to use templates. How they work and how you can use them. Maybe also explain how you can use templates with triggers.

I don't see anything about the Inventory thing in the documentation. When you click on the "?" icon on the Inventory page, it sends you to the following page, which doesn't exist : "http://www.zabbix.com/manual/v1.1/web.host_profile.php".

But most of all, I think we need more informations about items and which OS supports which items.

[dantheman]

I think a good step by step instruction on how to setup a host, how to setup an item(agent, simple check, and SNMP), how to setup a trigger. .. etc.. would be a good thing.

And not just saying "enter the key here".. explain what each setting, parameter does as you go. So not only would the reader find out how to do something, they would be able to understand what the different parts do.

[ericb]

how the windows agent works and what it can do.

i dont mind doing some documentation by the way, im looking to implementing Zabbix in my work place removing Nagios and Cacti so i will be providing documentation to the engineers anyway.

[clubbing80s]

please could you provide pdf's of the manuals..

Thanks

[Alexei]

Thanks for all suggestions! We have started Quick Start Guide:

http://www.zabbix.com/manual/v1.1/qs.login.php

Please let me know what you think. Is it detailed enough and has good format? What other topics you'd like to see covered?

[befortin]

Maybe something about templates? How to use them to create hosts, triggers, actions, macros, etc.

[amcorreia]

please could you provide pdf's of the manuals..

Thanks

I think, pdf format is a poor idea, because you don't can read this in a console (text mode), (okay, have programs to transform this to text. ex pdf2text), but can this a alternative format.

[clubbing80s]

reason for pdf ..

The document type is irrelevant, my isssue is that the doc's on the web site are difficult to print out. I'd be happy with a text file that prints to A4.. I like to make notes as I work ..

Greg

[Fábio Emilio Costa]

Pdf + Html

I believe it's okay to maintain a PDF copy with HTML copy for Zabbix Docs. PDF for printing and HTML for online reading.

Fábio

[nelsonab]

Missing stuff

Not sure if this is the right thread for this but the following came up in the forum which I could not find in the documentation:

http://www.zabbix.com/forum/showpost.php?p=13935&postcount=2

I could not find a discussion anywhere regarding the difference between (300) and (#300) which I'm sure other users may find useful.

If it is there and I'm just plain blind, is it in the right location for a user to find it easilly?

Also is this the correct thread for posting missing stuff for the manual?

[progressivepenguin]

PDF Documentation

I believe it's okay to maintain a PDF copy with HTML copy for Zabbix Docs. PDF for printing and HTML for online reading.

Fábio

I agree that PDF documentation (or something similar) is what I'm missing. I can use the html version, but it is not as convenient for me to use as pdfs.