products:promonitor:6.8:userguide:integrations:datadog

Datadog integration

Architecture

  • To visualize SAP monitoring data in your Datadog instance, you need to install a Pro.Monitor collector in each data center hosting the systems.
  • Pro.Monitor will act as a proxy between your SAP systems and Datadog.
  • It will connect remotely to each SAP system and will therefore need to be installed in a network area allowing to do so

Skills

  • Those responsible for installing the solution should have the following skills:
    • Basic linux administration for installing software and creating user accounts
    • SAP basis users & authorizations administration
    • Database users administration
    • Network administration to implement network routes

Prerequisites

  • A Pro.Monitor license, requested at support@agentil-software.com.
  • A dedicated Linux VM with appropriate specs
  • Network routes open toward SAP application ports
  • A dedicated user created on each system to monitor (See create SAP users)
  • See AGENTIL's Pro.Monitor Prerequisites Documentation for more details.

Installation

Insalling and configuring Pro.Monitor should not take more than an hour if prerequisites are set correctly

  • Install the JAVA JRE
  • Download the latest Pro.Monitor package.
  • Copy the package into a temporary folder - Not in /opt
  • Execute below commands:
tar -zxvf [PACKAGE FILE NAME]
./install.sh
systemctl start promonitor
  • Pro.Monitor should be up and running.

Configuration

You can configure Pro.Monitor using a web interface:

  • Visit http://[PRO.MONITOR VM HOSTNAME]:8888 in a web browser. The default username/password combination is admin/admin

Install license

  • Click the gear icon on the top right to open a menu. Then, select Licenses.
  • Copy the provided license keys and save

Install drivers

  • Get the latest SAP JCO driver for Linux and unzip the file to extract a tgz archive.
  • Click the gear icon on the top right to open a menu. Then, select Admin configuration and go the Upload/Download section.
  • Click on Install JCO driver and select the driver file (file name similar to sapjco30P_17-10005328_linux.tgz).

Connection to Datadog

To connect Pro.Monitor to Datadog, you need first to create keys in Datadog and then register those keys in Pro.monitor

Datadog: Create API & APP keys

  • You need first to connect to you Datadog instance and create dedicated API and APP keys
  • Navigate to the organization settings and use API & APP keys tab to create the keys:

Pro.Monitor: Register keys in a plugin

  • Now you will register the keys within a Pro.Monitor plugin.
  • Go back to Pro.Monitor web interface and click the top right gear icon and navigate to Plugins.
  • Select the Datadog type in the plugin selector and press create.
  • Hostname must be as such: : https://api.datadoghq.[Region] (Ex. https://api.datadoghq.eu)
  • Set your Datadog API and APP keys and save
  • Pro.Monitor is now connected to your Datadog instance.

Connection to SAP

For connecting Pro.Monitor to a SAP system, you will need first to create a group, a system, a user and a connector.

  • Create your first group

  • Fill the group formular
  • Don't foget to set group shortname and company shortname:

  • You can now create your first system
  • From the group contextual menu, select “Add system”
  • Select the appropriate system
  • Don't forget to set system shortname

  • Now you can create a user
  • From configure menu, select add user

  • User profiles are associated to a group
  • It will be used later when creating a connector

  • Now you can create connector
  • From the system contextual menu, select “Add connector”
  • Select the appropriate connector type

  • Then fill the connector form
  • The connector holds the necessary connection parameters to reach the system
  • Press Save&Test, you should see a green popup indicating a successful connection

Configure monitoring

The monitoring of SAP systems is done via monitoring profiles

  • Create your first profile
  • You can import, create and customize profiles from the profiles section on the left

  • From the profiles menu, select Select default profiles
  • Select the Datadog profile and press Save.
  • The imported profile will appear in the list of profiles
  • Now you can assign your profile via the assign button

  • From the assign menu, just move the available connectors from right to left, then save.
  • Your connectors are now associated with a set of predefined monitors

  • Last step: Activate the monitoring:
  • Select a connector and press “Start monitoring”

Monitoring is now active for all your systems, which you should see in Datadog.

Dashboards

  • Once you activate the integration from the marketplace, predefined dashboards will appear in your Datadog instance.
  • This is a link to the latest dashboards

Support

For support or feature requests, contact AGENTIL Software at support@agentil-software.com

/home/clients/8c48b436badcd3a0bdaaba8c59a54bf1/wiki-web/data/pages/products/promonitor/6.8/userguide/integrations/datadog.txt · Last modified: 2023/05/25 17:26 by rbariou