New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Fixes #12734: Add documentation for the Centreon plugin #37
Fixes #12734: Add documentation for the Centreon plugin #37
Conversation
centreon/README.md
Outdated
This project is part of Rudder - IT automation and compliance made easy. | ||
See: http://rudder-project.org for more information. | ||
|
||
This project is also part of iTop - CMDB and ITSM open source software. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
what ?
centreon/README.md
Outdated
|
||
- The Rudder server must have Python installed. | ||
|
||
- Generate the Rudder package : make |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
we are not in the root directory, say where we should run make
centreon/README.md
Outdated
|
||
- The Rudder server must have Python installed. | ||
|
||
- Generate the Rudder package : make |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We should probably add that the rpkg file is available somewhere
centreon/README.md
Outdated
|
||
- Install the package on the Rudder server : /opt/rudder/bin/rudderpkg install-file <plugin>.rpkg | ||
|
||
- Edit the configuration file /opt/rudder/etc/centreon.conf |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
what interesting values in this file what do they mean ?
centreon/README.md
Outdated
- Install the package on the Rudder server : /opt/rudder/bin/rudderpkg install-file <plugin>.rpkg | ||
|
||
- Edit the configuration file /opt/rudder/etc/centreon.conf | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
what happens next ?
what sould i do to check if the plugin is working ?
Commit modified |
646d1db
to
440a72c
Compare
centreon/README.md
Outdated
|
||
- The Rudder server must have Python installed. | ||
|
||
- Generate the Rudder package : cd into the centreon directory, then make. The .rpkg package file |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
if you don't have the binary rpkg file ...
centreon/README.md
Outdated
- Generate the Rudder package : cd into the centreon directory, then make. The .rpkg package file | ||
will be generated in the current directory. | ||
|
||
- Install the package on the Rudder server : /opt/rudder/bin/rudderpkg install-file <plugin>.rpkg |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
isn't there a markdown syntax for commands ?
centreon/README.md
Outdated
- Edit the configuration file /opt/rudder/etc/centreon.conf. This config file has to contain your Centreon | ||
server's webservice API URL, the credentials to access it, and the name of the Centreon poller used to | ||
monitor Rudder nodes (Central by default). You also need to provide the Rudder API URL, and a token to access | ||
it, which you can issue from the Rudder server webapp or CLI. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
" from the Rudder server webapp or CLI" this is too generic, either say how to get it or don't say anything.
The best would be a pointer to a Rudder documentation url that already has the information.
centreon/README.md
Outdated
|
||
Centreon comes with the possiblity to add monitoring templates to its hosts. You can create templates in | ||
Centreon or check for available ones. Once you know the name of a template suitable for a Rudder node/nodegroup, | ||
you can add it using the "Monitoring template" generic method from the technique editor. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How long to i need to wait to make sure the template is applied ?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
a word about the cron/daemon that process those templates and how it works ?
centreon/README.md
Outdated
----- | ||
|
||
Now that the plugin is installed, you can check if it is working by adding new Rudder nodes. They will be added | ||
to you list of Centreon hosts (and removed on deletion of the Rudder node). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Add a sentence to briefly describe how it works : post-hook, api call from rudder server ...
Commit modified |
440a72c
to
086f3ef
Compare
centreon/README.md
Outdated
----- | ||
|
||
Now that the plugin is installed, you can check if it is working by adding new Rudder nodes. They will be added | ||
to you list of Centreon hosts (and removed on deletion of the Rudder node). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
to your list
centreon/README.md
Outdated
Usage | ||
----- | ||
|
||
Now that the plugin is installed, you can check if it is working by adding new Rudder nodes. They will be added |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
automatically added
centreon/README.md
Outdated
options on such events. | ||
|
||
Centreon comes with the possiblity to add monitoring templates to its hosts. You can create templates in | ||
Centreon or check for available ones. Once you know the name of a template suitable for a Rudder node/nodegroup, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
suitable template
hosts. The "Monitoring parameter" generic method achieves this. | ||
|
||
The data will be sent hourly to the Centreon server. This can be changed by editing the /etc/cron.d/centreon-rudder file. | ||
This operation can be manually executed by running |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
running where ?
Commit modified |
086f3ef
to
39ff55e
Compare
OK, merging this PR |
https://www.rudder-project.org/redmine/issues/12734