2017-06-22 05:42:48 +02:00
|
|
|
|
{!create-stream.md!}
|
2017-06-05 19:16:22 +02:00
|
|
|
|
|
2017-06-22 05:42:48 +02:00
|
|
|
|
{!download-python-bindings.md!}
|
|
|
|
|
|
|
|
|
|
|
|
Next, on your {{ settings_html|safe }}, create a bot for
|
|
|
|
|
|
{{ integration_display_name }}.
|
2017-06-05 19:16:22 +02:00
|
|
|
|
|
|
|
|
|
|
Next, open `integrations/nagios/zuliprc.example` in your favorite
|
|
|
|
|
|
editor, and change the following lines to specify the email address
|
|
|
|
|
|
and API key for your Nagios bot, saving it to `/etc/nagios3/zuliprc`
|
|
|
|
|
|
on your Nagios server:
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
[api]
|
|
|
|
|
|
email = NAGIOS_BOT_EMAIL_ADDRESS
|
|
|
|
|
|
key = NAGIOS_BOT_API_KEY
|
|
|
|
|
|
{% if api_site_required %}site = {{ external_api_uri_subdomain }}{% endif %}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Copy `integrations/nagios/zulip_nagios.cfg` to `/etc/nagios3/conf.d`
|
|
|
|
|
|
on your Nagios server.
|
|
|
|
|
|
|
|
|
|
|
|
Finally, add `zulip` to the `members` list for one or more of the
|
|
|
|
|
|
contact groups in the `CONTACT GROUPS` section of
|
|
|
|
|
|
`/etc/nagios3/conf.d/contacts.cfg`, doing something like:
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
define contactgroup {
|
|
|
|
|
|
contactgroup_name admins
|
|
|
|
|
|
alias Nagios Administrators
|
|
|
|
|
|
members monitoring, zulip
|
|
|
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Once you’ve done that, reload your Nagios configuration using
|
|
|
|
|
|
`/etc/init.d/nagios3 reload`.
|
|
|
|
|
|
|
|
|
|
|
|
When your Nagios system makes an alert, you’ll see a message like the
|
|
|
|
|
|
following, to the stream `nagios` (to change this, edit the arguments
|
|
|
|
|
|
to `nagios-notify-zulip` in `/etc/nagios3/conf.d/zulip_nagios.cfg`)
|
|
|
|
|
|
with a topic indicating the service with an issue.
|
|
|
|
|
|
|
2017-06-22 05:42:48 +02:00
|
|
|
|
{!congrats.md!}
|
2017-06-05 19:16:22 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**Testing**
|
|
|
|
|
|
|
2017-06-22 05:42:48 +02:00
|
|
|
|
If you have [external commands enabled in Nagios][1],
|
|
|
|
|
|
you can generate a test notice from your Nagios instance by
|
|
|
|
|
|
using the `Send custom service notification` command in the
|
|
|
|
|
|
`Service Commands` section of any individual service’s page
|
|
|
|
|
|
on your Nagios instance.
|
|
|
|
|
|
|
|
|
|
|
|
[1]: http://nagios.sourceforge.net/docs/3_0/extcommands.html
|
2017-06-05 19:16:22 +02:00
|
|
|
|
|
|
|
|
|
|
**Troubleshooting**
|
|
|
|
|
|
|
|
|
|
|
|
You can confirm whether you’ve correctly configured Nagios to run the
|
|
|
|
|
|
Zulip plugin by looking for `SERVICE NOTIFICATION` lines mentioning
|
|
|
|
|
|
zulip in `/var/log/nagios3/nagios.log`. You can confirm whether you’ve
|
|
|
|
|
|
configured the Zulip plugin code correctly by running
|
|
|
|
|
|
`/usr/local/share/zulip/integrations/nagios/nagios-notify-zulip`
|
|
|
|
|
|
directly.
|
