[ixpmanager] Nagios Birdseye Daemon Monitoring Template Problem

[Kyle Spencer]

Working through your feedback. Note that these configurations *are*
being automatically generated by IXP Manager. Apologies; I mentioned
manual generation in my post but that was wrong/misleading.

Here's the seemingly relevant bits from the automatically generated
Nagios configuration file. Note that _apiurl is not missing. The error
seems to be related to the check_command line.

define service {
    name                    ixp-manager-service-birdseye-daemon
    service_description     Bird BGP Service
    check_command           check_birdseye_daemon!$_HOSTAPIURL$
    check_period            24x7
    max_check_attempts      10
    check_interval          5
    retry_check_interval    1
    contact_groups          admins
    notification_interval   120
    notification_period     24x7
    notification_options    w,u,c,r
    register                0
}

define host     {
        use                     ixp-manager-host-birdseye-daemon
        host_name               bird-rs1-ddc-ipv4
        alias                   Route Server #1 - DDC - V4
        address                 10.0.0.202
        _apiurl                 http://rs1-ddc-ipv4.djix.dj/api
}

define service     {
    use                     ixp-manager-service-birdseye-daemon
    host_name               bird-rs1-ddc-ipv4
}







On Wed, Jan 24, 2018 at 1:46 PM, Kyle Spencer <kyle at stormzero.com> wrote:
> Noted. Have started making edits to the docs when I can.
>
> Thanks :)
>
> On Wed, Jan 24, 2018 at 1:35 PM, Barry O'Donovan <barry.odonovan at inex.ie> wrote:
>> Hi Kyle,
>>
>> Kyle Spencer wrote:
>>> I've downloaded the appropriate template via the API, created the
>>> host and service definitions as instructed by the template header,
>>> and installed a configuration. When I try to switch on Nagios, I get
>>> the following error:
>>>
>>> nagios[15732]: Error: Service check command
>>> 'check_birdseye_daemon!$_HOSTAPIURL$' specified in service 'Bird BGP
>>>  Service' for host 'bird-rs1-ddc-ipv4' not defined anywhere!
>>>
>>> It seems that the relevant Nagios check command needs to be
>>> established, but there's no indication in the documentation (that I
>>> see) about what the nature of that check command should be and
>>> whether or not it requires any plugins.
>>
>> It's all there in the appropriate section:
>>
>> http://docs.ixpmanager.org/features/nagios/#birdseye-daemon-monitoring
>>
>> There is a sample host definition at the top of this section (with
>> "host_name               bird-rc1q-cork-ipv4").
>>
>> That contains the dynamic param:
>>
>>         _apiurl                 http://rc1q-ipv4.cork.inex.ie/api
>>
>> This is missing and this is what Nagios seems to be complaining about.
>> You do not generate these host definitions yourself - as per the docs:
>>
>>> You can use the IXP Manager API to get the Nagios configuration for
>>> all or a given VLAN using the following endpoint format:
>>>
>>> https://ixp.example.com/api/v4/nagios/birdseye-daemons
>>> ...
>>
>>
>>> I also note that the plugins directory
>>> (referenced in the docs) does not include anything related to
>>> Birdseye: https://github.com/barryo/nagios-plugins
>>
>> That reference is from another section and the full context is:
>>
>>> Hint: over the years, we at INEX have written a number of switch
>>> chassis check scripts and these can be found on Github at
>>> barryo/nagios-plugins.
>>
>> i.e. not related to and no mention of Birdseye.
>>
>> However, in the appropriate section re Birdseye, we state:
>>
>>> The Nagios script we use is bundled with inex/birdseye and can
>>> be found here.
>>
>> where 'here' links to:
>>
>> https://github.com/inex/birdseye/tree/master/bin
>>
>>
>>
>> I don't pretend the documentation is perfect. My own deep knowledge of
>> IXP Manager often makes it difficult for me to strike the right level
>> between 'teaching to suck eggs' and being too vague.
>>
>> While all the info necessary for the above is in the docs, if they can
>> be made better PLEASE contribute:
>>
>> http://docs.ixpmanager.org/dev/docs/
>>
>>  - Barry
>>
>>
>> --
>>
>> Kind regards,
>> Barry O'Donovan
>> INEX Operations
>>
>> https://www.inex.ie/support/
>> +353 1 531 3339
>>
>>
>> _______________________________________________
>> INEX IXP Manager mailing list
>> ixpmanager at inex.ie
>> https://www.inex.ie/mailman/listinfo/ixpmanager
>
>
>
> --
> Cell/WhatsApp/Signal: +256790884905



-- 
Cell/WhatsApp/Signal: +256790884905