Integrating DataDog with CloudBolt CMP

Overview

In the CloudBolt Content Library there is an item to integrate DataDog to be able to view metrics on your servers within CloudBolt CMP. Here we will walk through configuring the User Interface Extension to accomplish this integration.

Pre-requisites: Have an active Datadog account

Note: This integration currently only supports one Datadog account being linked at a time.

Installation

1. Navigate to the CloudBolt Content Library in your CMP Environment by Clicking on “Library” on the main Navigation Header. Remember, you will need to be logged in as a CloudBolt Administrator to see this tab.

   

2. Search for DataDog, and click on the Icon for the UI Extension provided.

   

3. On the next page, click Download, and follow the prompt to Import the extension.

4. You are then brought to the Extensions Management page, where you can remove or download locally any UI Extension in CloudBolt. Note the data_dog extension now on this page.

   1. You can see that there are 2 hooks as part of this package, and Admin hook and a Server Tab hook.

5. SSH into the CloudBolt appliance.

   1. Once authenticated at the root level in the CB appliance run the following command to restart the web service and recognize the updated code from the extension. While it should only take a few seconds, this will cause an interruption in service to the web server while it restarts, so be sure you’re in a valid maintenance window.

      1. service httpd restart

Configuring Datadog’s Admin tab

1. Navigate to the Datadog Admin tab in CloudBolt from Admin > Admin Extensions > Datadog Integration

2. To configure and link your Datadog account, click “Add Credentials” and provide the information requested. You will need:

   1. Datadog API Key:

      1. To get your Datadog API key, go into your Datadog console and Navigate to Integrations > APIs

         

      2. Click to expand the API Keys section of the page and create a new API Key for CloudBolt by following the prompt.

      3. Once created, Hover over the hidden “Key” field and copy that field into the json for the api_key second of the header field in CloudBolt.

   2. Datadog Application Key

      1. To get your Datadog Application Key, you can click the link from the APIs page within Datadog

         

      2. Click on the button to create a new key for the CloudBolt Integration.

      3. Once your key is created, copy that into the json for the app_key section of the header field in CloudBolt.

      4. With your header completely filled out, make sure that there are no trailing spaces or commas, as this field needs to be valid JSON.

3. Once you have established your connection to Datadog, any servers that are currently managed by CloudBolt with Datadog Agents running will show up on the “Servers” tab of the Datadog Admin Page.

Datadog Server Tab

There are a few states that are available in the Datadog Server Tab. This tab will be visible on any server managed by CloudBolt.

1. Servers with Datadog agents running

   

   1. Currently, with an agent running on a server, you will be provided graphs about usage metrics and the ability to remove the installed agent from the server.

   2. In addition to the current Disk Used, Free Disk, and Free Ram shown, the Graphs available to you on the server tab are:

      1. CPU Idle

      2. CPU IO Wait

      3. Paged Memory

      4. Memory Usage

      5. Disk Write Time

      6. Disk Used

   3. The action available will remove the installed agent from the host VM.

2. Servers without Datadog agents currently running

   1. As long as you have credentials set in the Configuration portion of the server details page, you can use the Server Tab to install the Datadog agent to the server