Skip to main content

Datadog Plugin

The Datadog plugin integrates Datadog dashboards directly into your Venue portal and enables teams to visualize and monitor databases, tools, performance metrics, logs, and dashboards without leaving Venue.sh.

Preconfiguration: Gathering Necessary Data​

To use the Datadog plugin in Venue.sh, you first need to gather the following information from your Datadog account:

  1. Retrieve the URLs of the Datadog dashboards you want to display in Venue.sh.

    1. Login to your Datadog account and navigate to your dashboard list.

    2. Select the dashboard you want to embed from the dashboard list.

    3. Open sharing settings by clicking the Settings cog icon on the right side of the dashboard.

    4. Copy the public URL, which allows public access to your dashboard, from the sharing textbox.

      Example: https://app.datadoghq.com/dashboard/abc-def-ghi

    5. Save the URL for later configuration steps in Venue.sh.

  2. Retrieve your Datadog site region from your Datadog URL.

    tip

    Common region values include:

    • datadoghq.com (US1)
    • datadoghq.eu (EU1)
    • us3.datadoghq.com (US3)
    • us5.datadoghq.com (US5)
    • ap1.datadoghq.com (AP1)

Enabling the Datadog Plugin in Venue.sh​

  1. In the Venue.sh app, click Plugins in the left-side navigation.

  2. Find Datadog, then click Enable Plugin.

Displaying Datadog Dashboards in Venue.sh (New Entities)​

Follow these steps to display your Datadog dashboards in Venue.sh, as you import entities for the first time.

  1. In Venue.sh, click Import on the left-hand navigation panel.
  2. Choose a connection, select the entities you want to track as components in your Catalog, then click Next Step.
  3. Click Configure optional fields, and select Datadog.
  4. Configure your import.
  5. Add the values you gathered in the preconfiguration steps (above) for Datadog Dashboard URL(s) and Datadog Site.
  6. Complete the import process.
  7. Click Catalog in the left-hand navigation panel.
  8. Select your entity.
  9. Click the Datadog tab to view your embedded dashboard(s).

Displaying Datadog Dashboards in Venue.sh (Existing Entities)​

  1. Click Catalog in the left-hand navigation panel.
  2. Locate and select the entity you want to add Datadog dashboards to.
  3. Click Edit.
  4. In the edit form, scroll to the Optional metadata section and click Toggle optional fields.
  5. Select Datadog from the available optional fields, then enter the values you gathered in the preconfiguration steps (above) for Datadog Dashboard URL(s) and Datadog Site..
  6. Click Save changes to apply the changes.
  7. Navigate back to your entity in the Catalog.
  8. Click the Datadog tab to view your embedded dashboard(s).

Viewing Your Datadog Configuration​

  1. Click Catalog in the left-hand navigation panel.

  2. Locate and select the entity you configured.

  3. While on the Overview tab, click the overflow menu (three dots), and select Inspect entity.

    The Entity Inspector window appears.

  4. Scroll down to the Metadata section, and look for the following annotations:

    • datadoghq.com/dashboard-url - Your dashboard URL(s)
    • datadoghq.com/site - Your Datadog site region