105 lines
2.8 KiB
Markdown
105 lines
2.8 KiB
Markdown
|
# Manubulon SNMP Plugins Configuration <a href="manubulon-snmp-plugins-configuration"></a>
|
||
|
|
|
||
|
|
Each plugin requires a command definition which defines the command line parameters
|
||
|
|
and arguments passed from service checks.
|
||
|
|
|
||
|
|
* [Icinga 2](03-Configuration.md#manubulon-snmp-plugins-configuration-icinga-2) integration
|
||
|
|
* [Icinga 1.x/Naemon/Nagios](03-Configuration.md#manubulon-snmp-plugins-configuration-icinga-1) integration
|
||
|
|
|
||
|
|
## Icinga 2 <a href="manubulon-snmp-plugins-configuration-icinga-2"></a>
|
||
|
|
|
||
|
|
The Icinga 2 Template Library (ITL) already provides many [CheckCommand definitions](https://www.icinga.com/docs/icinga2/latest/doc/10-icinga-template-library/#plugin-check-commands-for-manubulon-snmp)
|
||
|
|
out of the box. This enables you to just use the CheckCommand object and focus
|
||
|
|
on your service apply rules.
|
||
|
|
|
||
|
|
### Icinga 2: Best Practices <a href="manubulon-snmp-plugins-configuration-icinga-2-best-practices"></a>
|
||
|
|
|
||
|
|
Best practice is to store the credentials in a separate constant:
|
||
|
|
|
||
|
|
```
|
||
|
|
vim /etc/icinga2/constants.conf
|
||
|
|
|
||
|
|
const ManubulonSnmpCommunity = "icingasnmpro"
|
||
|
|
```
|
||
|
|
|
||
|
|
Define a generic SNMP service template and set common attributes.
|
||
|
|
|
||
|
|
```
|
||
|
|
template Service "snmp-template" {
|
||
|
|
vars.snmp_community = ManubulonSnmpCommunity
|
||
|
|
}
|
||
|
|
```
|
||
|
|
### Icinga 2: Apply Rules <a href="manubulon-snmp-plugins-configuration-icinga-2-apply"></a>
|
||
|
|
|
||
|
|
|
||
|
|
Define service apply rules like this:
|
||
|
|
|
||
|
|
```
|
||
|
|
apply Service "snmp-memory" {
|
||
|
|
import "snmp-template"
|
||
|
|
check_command = "snmp-memory"
|
||
|
|
|
||
|
|
vars.snmp_warn = "50,0"
|
||
|
|
vars.snmp_crit = "80,0"
|
||
|
|
|
||
|
|
assign where "snmp" in host.groups
|
||
|
|
}
|
||
|
|
|
||
|
|
apply Service "snmp-storage /var" {
|
||
|
|
import "snmp-template"
|
||
|
|
check_command = "snmp-storage"
|
||
|
|
|
||
|
|
vars.snmp_warn = "50"
|
||
|
|
vars.snmp_crit = "80"
|
||
|
|
vars.snmp_storage_name = "/var"
|
||
|
|
|
||
|
|
assign where "snmp" in host.groups
|
||
|
|
}
|
||
|
|
|
||
|
|
apply Service "snmp-storage" {
|
||
|
|
import "snmp-template"
|
||
|
|
check_command = "snmp-storage"
|
||
|
|
|
||
|
|
vars.snmp_warn = "50"
|
||
|
|
vars.snmp_crit = "80"
|
||
|
|
|
||
|
|
assign where "snmp" in host.groups
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### Icinga 2: Apply For Rules <a href="manubulon-snmp-plugins-configuration-icinga-2-apply-for"></a>
|
||
|
|
|
||
|
|
A more complex example using apply for rules is to store the
|
||
|
|
monitored storage disks on the host. This allows to generate
|
||
|
|
service objects in a more efficient way.
|
||
|
|
|
||
|
|
```
|
||
|
|
object Host "snmp-host" {
|
||
|
|
check_command = "hostalive"
|
||
|
|
|
||
|
|
vars.snmp_storage["/"] = {
|
||
|
|
snmp_warn = "80"
|
||
|
|
snmp_crit = "90"
|
||
|
|
}
|
||
|
|
vars.snmp_storage["/var"] = {
|
||
|
|
snmp_warn = "60"
|
||
|
|
snmp_crit = "90"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
apply Service "snmp-storage-" for (storage_name => config in host.vars.snmp_storage) {
|
||
|
|
import "snmp-template"
|
||
|
|
|
||
|
|
display_name = "Storage: " + storage_name
|
||
|
|
|
||
|
|
vars += config
|
||
|
|
vars.snmp_storage_name = storage_name
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Icinga 1.x/Naemon/Nagios <a href="manubulon-snmp-plugins-configuration-icinga-1"></a>
|
||
|
|
|
||
|
|
You need to write a check command definition and use that in your service definitions.
|
||
|
|
Please refer to [this documentation](http://nagios.manubulon.com/index_commands.html).
|