Documentation Plugins Datadog data source Installation

Install and upgrade the Datadog data source plugin

This document covers how to install, upgrade, and verify the Datadog data source plugin across different Grafana deployment environments. After you install the plugin, refer to Configure the Datadog data source to set up a connection.

Before you begin

Verify the following requirements before you install:

Install the plugin

Choose the installation method that matches your Grafana deployment.

Grafana Cloud

Enterprise plugins must be enabled for your organization before they appear as installable in the plugin catalog.

1. Go to the Grafana account portal and sign in with your Grafana Cloud account.
2. Select your organization.
3. Navigate to the Plugins tab and verify that the Datadog plugin is enabled. If it isn’t listed, confirm that your Cloud plan includes Enterprise plugins.
4. In your Grafana Cloud instance, navigate to Administration > Plugins and data > Plugins.
5. Search for Datadog and click Install.

Self-managed Grafana (CLI)

Bash Copy

grafana cli plugins install grafana-datadog-datasource

Restart Grafana after installation:

Bash Copy

sudo systemctl restart grafana-server

Docker

Set the GF_INSTALL_PLUGINS environment variable:

YAML Copy

environment:
  - GF_INSTALL_PLUGINS=grafana-datadog-datasource
  - GF_ENTERPRISE_LICENSE_TEXT=<YOUR_LICENSE>

Kubernetes (Helm chart)

Add the plugin to your Helm values:

YAML Copy

plugins:
  - grafana-datadog-datasource

envFromSecret: grafana-license-secret

Or use the GF_INSTALL_PLUGINS environment variable in your deployment spec:

YAML Copy

env:
  - name: GF_INSTALL_PLUGINS
    value: "grafana-datadog-datasource"
  - name: GF_ENTERPRISE_LICENSE_TEXT
    valueFrom:
      secretKeyRef:
        name: grafana-license
        key: license.jwt

Kubernetes (init container)

If you don’t control the Helm chart, for example on a shared platform cluster, use an init container to download the plugin before Grafana starts:

YAML Copy

initContainers:
  - name: install-plugins
    image: curlimages/curl:latest
    command:
      - sh
      - -c
      - |
        curl -sL https://grafana.com/api/plugins/grafana-datadog-datasource/versions/latest/download \
          -o /plugins/grafana-datadog-datasource.zip && \
        unzip /plugins/grafana-datadog-datasource.zip -d /plugins/
    volumeMounts:
      - name: plugins
        mountPath: /plugins

Mount the same volume at /var/lib/grafana/plugins in the Grafana container.

Air-gapped (offline) installation

For environments without internet access:

1. Download the plugin ZIP file from your Grafana account portal on a machine with internet access.

2. Transfer the ZIP file to the Grafana server.

3. Extract it to the plugins directory:

   Bash Copy

   unzip grafana-datadog-datasource-<version>.linux_amd64.zip -d /var/lib/grafana/plugins/

4. Set ownership:

   Bash Copy

   chown -R grafana:grafana /var/lib/grafana/plugins/grafana-datadog-datasource

5. Restart Grafana.

If Grafana reports an “unsigned plugin” error, add the following to grafana.ini:

ini Copy

[plugins]
allow_loading_unsigned_plugins = grafana-datadog-datasource

Verify the installation

After you install the plugin, confirm that it loaded:

1. Navigate to Administration > Plugins and data > Plugins.
2. Search for Datadog and verify that the plugin appears with a status of Installed.
3. Navigate to Connections > Add new connection and search for Datadog to confirm that it’s available as a data source.
4. If the plugin doesn’t appear, check the Grafana server logs for errors and refer to Troubleshoot installation issues.

Upgrade the plugin

Upgrade steps depend on your Grafana deployment environment.

Grafana Cloud

Plugins update automatically on Grafana Cloud, and no manual action is required. If you experience issues after an automatic update, contact Grafana Support.

Self-managed Grafana

1. Update the plugin:

   Bash Copy

   grafana cli plugins update grafana-datadog-datasource

2. Restart Grafana.

3. Verify each data source connection with Save & test.

To install a specific version:

Bash Copy

grafana cli plugins install grafana-datadog-datasource <version>

For Docker or Kubernetes, append the version to the plugin name:

YAML Copy

environment:
  - GF_INSTALL_PLUGINS=grafana-datadog-datasource <version>

Roll back to a previous version

If an upgrade causes issues on a self-managed instance, pin a specific plugin version:

Bash Copy

grafana cli plugins install grafana-datadog-datasource <version>

Restart Grafana after the rollback.

Uninstall the plugin

To remove the Datadog plugin from a self-managed Grafana instance:

Bash Copy

grafana cli plugins remove grafana-datadog-datasource

Restart Grafana after you uninstall the plugin. Existing data source configurations are preserved in the Grafana database but stop working until you reinstall the plugin.

For Docker or Kubernetes, remove grafana-datadog-datasource from the GF_INSTALL_PLUGINS variable and redeploy.

Troubleshoot installation issues

The following sections address common installation problems.

Plugin doesn’t appear in the catalog (Grafana Cloud)

Cause: The Enterprise plugin isn’t enabled for your organization.

Solution:

1. Go to the Grafana account portal.
2. Select your organization and navigate to the Plugins tab.
3. Verify that the Datadog plugin is listed and enabled.
4. Confirm that your Cloud plan includes Enterprise plugins. For details, refer to Grafana Cloud features.

Install button missing or “Plugin not found”

Cause: Your Grafana instance doesn’t have access to the Enterprise plugin repository.

Solution:

• Grafana Cloud: Verify that the plugin is enabled at the Grafana account portal.
• Self-managed: Verify that your Grafana Enterprise license is active. Set the license with the GF_ENTERPRISE_LICENSE_TEXT environment variable or the license path. Refer to Grafana Enterprise license.

License errors (self-managed)

Cause: The GF_ENTERPRISE_LICENSE_TEXT environment variable contains an invalid or malformed license key.

Solution:

1. Verify that the license key doesn’t contain extra whitespace, line breaks, or truncated characters.
2. Confirm that the key is for the correct Grafana instance URL.
3. Check that the license hasn’t expired at the Grafana account portal.
4. For more details about license errors, refer to License issues.

“Unsigned plugin” error (air-gapped installs)

Cause: You installed the plugin from a ZIP file and Grafana can’t verify its signature.

Solution:

1. Make sure you downloaded the ZIP file from the official Grafana account portal. Official downloads are signed.
2. If the error persists, add allow_loading_unsigned_plugins = grafana-datadog-datasource to grafana.ini under [plugins].
3. Restart Grafana.