Introduction

This blog provide a configuration overview of how to integrate Nagios with SAP IT Operations Analytics (SAP ITOA). Nagios comes with syslog integration by default. The target is to configure Nagios to forward notifications, alerts and performance information to SAP ITOA using syslog-ng technology.

In SAP ITOA the attribute editor can be used to define attributes out of the streamed content which can then be used to do analytics in stories and charts. Some configuration examples based on streamed content are also provided below. The described solution was tested with the following components and versions:

Component Version
SAP ITOA 2.2.0 (running on SAP HANA 1.0 SPS12)
Nagios 4.1.1 (running on SLES 11.3 and using syslog-ng 2.0.9)

 

 

Configuration Steps

Preconditions

  • SAP IT Operations Analytics is installed and configured (For more details check the Administration Guide)
  • Plugin ITOA Syslog Socket Input and ITOA Attribute Editor are activated
Action

Create Bucket

Login with an user (Admin or Expert role assigned) to SAP ITOA application (http://<Hostname SAP ITOA>:<Port>/sap/dci/core) and create a new bucket:

Bucket Name NAGIOS
Plugin Activated ITOA Syslog Socket Input
ITOA Attribute Editor
Syslog Server Port 1520
Communication Protocol TCP

 

Note: For more details check the Administration Guide

Forward Nagios Messages

Login to the operating system, Nagios instance is running (e.g. using PuTTY) and add the following syslog-ng configuration:

 

/etc/syslog-ng/syslog-ng.conf

source s_nagios_perf {

file(“/usr/local/nagios/var/host-perfdata” follow_freq(1) flags() log_prefix(“nagios: “));

file(“/usr/local/nagios/var/service-perfdata” follow_freq(1) flags() log_prefix(“nagios: “));

};

filter f_nagios { program(“nagios”); };

destination d_itoa_nagios { tcp(“<SAP ITOA Adapter Instance>” port(1520) ); };

log { source(src); filter(f_nagios); destination(d_itoa_nagios); };

log { source(s_nagios_perf); destination(d_itoa_nagios); }; 

 

Configuration Description

Attribute Description
s_nagios_perf Identifier name for Nagios performance data source
/usr/local/nagios Nagios Installation Path
f_nagios Identifier name for filter configuration
d_itoa_nagios Identifier name for SAP ITOA destination
tcp Network protocol of the desired bucket (Communication Protocol)
<SAP ITOA Adapter Instance> SAP ITOA Adapter Hostname / IP Address
1520 Network port of the desired bucket (Syslog Server Port)
src Standard syslog-ng source

 

Save the configuration and restart Syslog service using the following command:

service syslog restart 

Verify Data Streaming

Login with an user (Admin or Expert role assigned) to SAP ITOA application (http://<Hostname SAP ITOA>:<Port>/sap/dci/core) and verify if the bucket (NAGIOS) receives Nagios messages (Streaming Content).

Attribute Parsing

In the bucket (Table View) choose (mark) a desired messages and press the button Edit Attributes (former: GET MORE INSIGHTS) and configure the desired attributes.
In the following section some configuration examples are described.

 

Example Event 1

<13>Apr 21 10:03:36 nagios_server.abc.corp nagios: [SERVICEPERFDATA] 1492769016 nagios_client.abc.corp OS Ping 4.237 0.000 PING OK - Packet loss = 0%, RTA = 228.42 ms rta=228.423996ms;3000.000000;5000.000000;0.000000 pl=0%;80;100;0
Regular Expression 1

: \[{nagios_msg_type}\]\t{unix_time}\t{hostname}\t
Attribute Definition 1

Attribute Name SQL DATA Type Dimension Attribute RegExp
nagios_msg_type NVARCHAR 50 [A-Z ]*
unix_time INTEGER n/a \d{1,13}

 

 

Example Event 2

<14>Apr 21 10:08:37 nagios_server.abc.corp nagios: SERVICE ALERT: nagios_client.abc.corp;CPU Usage;OK;SOFT;3;CPU OK : user=3% system=0% iowait=2% idle=95%
Regular Expression 2

: {nagios_msg_type}: {hostname};
Attribute Definition 2

Attribute Name SQL DATA Type Dimension Attribute RegExp
nagios_msg_type NVARCHAR 50 [A-Z ]*

 

Note:

  • The attribute hostname is a predefined attribute regular expression, which is not required to be defined.
  • The way how Nagios meassages (streaming content) are created depends to the Nagios plugins. In addition it is possible to change the format of the streaming content (e.g. tab separation, semicolon separation, etc…). For further information, please check the Nagios documentation.

 

 

 

Further Information

Content Type Information
Troubleshooting Guide https://launchpad.support.sap.com/#/notes/2435731
Release Note SAP ITOA 2.0 SP03 https://launchpad.support.sap.com/#/notes/2414432
Administrator Guide https://help.sap.com/itoa
Video Feature Demo https://www.sap.com/assetdetail/2017/02/a0596bde-a87c-0010-82c7-eda71af511fa.html

 

To report this post you need to login first.

Be the first to leave a comment

You must be Logged on to comment or reply to a post.

Leave a Reply