Configuration

Owned by Martin Jerga (Unlicensed)
Last updated: Oct 28, 2024 by Bohdan Špes
4 min read

 

Before configuring the extension in the Dynatrace UI, please

  1. Create a Nagios user that the extension will use if you don’t want to use nagiosadmin user

 

Extension endpoint configuration provides these options:

  • License - Valid license required (mandatory to fill)

  • HTTP Proxy - Only necessary if ActiveGate cannot connect to the Nagios server URL directly. Proxy to use for the connection from ActiveGate to the Nagios server.

    • Proxy user name - User name to connect to the proxy server.

    • Proxy password - Password to connect to the proxy server.

  • Nagios URL - Nagios Server web URL (mandatory to fill)

  • Nagios Username - User name to connect to Nagios API (mandatory to fill)

  • Nagios Password- Password to connect to Nagios API (mandatory to fill)

  • Nagios host groups to include - At least one Nagios HostGroup should be defined for synchronization (mandatory to fill)

Advanced configuration

  • Nagios timeout - Timeout in seconds for Nagios API response

  • Problems title prefix - The Nagios problem title will have a defined prefix if we want to distinguish problems from Nagios from problems generated from Dynatrace. We recommend the prefix [Nagios] with one space at the end.

  • Problems not older than - Synchronize problems not older than specified days. 0 means no limit for problem age.

  • Refresh Hosts list from Nagios - Interval (in minutes) for querying Nagios API for hosts and inventory data and building internal cache. Default value 20 minutes.

  • Refresh Nagios Host entities in Dynatrace - Interval in minutes between refresh of Nagios Host entities in Dynatrace. If the interval is greater than 5 minutes, you will only see Nagios hosts with problems and other Nagios hosts will be displayed as "Inactive" or not displayed at all. Each Nagios host refreshed in Dynatrace consumes 0.001 DDU. Formula (0.001 DDU x number of Nagios hosts in Dynatrace x number of links to Nagios host groups per host) / Refresh Nagios Host entities in Dynatrace

  • Dynatrace problem resend time - Interval in minutes for resending events to Dynatrace to keep the problem opened in Dynatrace (otherwise, it expires after 15 minutes). Each problem event sent consumes 0.001 DDU

  • Notification enabled - Catch only Nagios problems with enabled notification. If enabled and the Nagios host has disabled notifications then all Nagios services from that host are ignored for problem synchronization.

  • Nagios host DOWN - Nagios severity to Dynatrace severity mapping

  • Nagios host UNREACHABLE - Nagios severity to Dynatrace severity mapping

  • Nagios service CRITICAL - Nagios severity to Dynatrace severity mapping

  • Nagios service WARNING - Nagios severity to Dynatrace severity mapping

  • Nagios service UNKNOWN - Nagios severity to Dynatrace severity mapping

  • Allow Davis merge - Allow Davis AI to merge events into existing problems (true) or force creating a new problem (false)

  • Nagios service names filter - List of Nagios service names specified as regular expressions or name substrings. Services that meet the filter will be monitored. If the list is empty, all services are monitored.

  • Performance metrics - If there is no definition then no Nagios service performance data are transferred. Define the list of Nagios service names specified as regular expressions or name substrings. Performance data for the matching services list will be transferred into Dynatrace.

  • Problem metric - Send problem metric (count of problems for each monitored Nagios host). If a problem doesn’t exist on the host, metric data are not sent. Consumes 0.001DDU/minute per entity with problems.

  • Verify Nagios SSL certificate - Verify Dynatrace SSL certificate

  • SSL Trust store - SSL CA certificate in PEM format for Nagios web server

  • Nagios host metadata configuration - List of Nagios host attribute keys to be synchronized from Nagios host to Dynatrace entity

  • Nagios problem metadata configuration - List of Nagios problem attribute keys to be synchronized from Nagios problem to Dynatrace event/problem

  • Debug - Set to on to enable DEBUG logging on each extension query run