Community developed integrations for the Datadog Agent are stored in the Datadog integrations-extra Github repository. They are not packaged with the Agent, but can be installed as add-ons.
For new users, download and install the latest version of the Datadog Agent.
Choose your version of the Agent:
For Agent v7.21+ / v6.21+:
Run the following command to install the Agent integration:
datadog-agent integration install -t datadog-<INTEGRATION_NAME>==<INTEGRATION_VERSION>
Configure your integration similar to core integrations.
Note: If necessary, prepend
sudo -u dd-agent to the install command.
The recommended way to use a community integration with the Docker Agent is to build the Agent with the integration installed. Use the following Dockerfile to build an updated version of the Agent that includes the
<INTEGRATION_NAME> from integrations-extras.
FROM gcr.io/datadoghq/agent:latest RUN agent integration install -r -t datadog-<INTEGRATION_NAME>==<INTEGRATION_VERSION>
agent integration install command run inside Docker issues the following harmless warning:
Error loading config: Config File "datadog" Not Found in "[/etc/datadog-agent]": warn. This warning can be ignored.
Use this new Agent image in combination with Autodiscovery to enable the
For Agent < v7.21 / v6.21:
<INTEGRATION_NAME>/datadog_checks/<INTEGRATION_NAME>/folder from the integrations-extra repository.
<INTEGRATION_NAME>.pyand any other Python files in the Agent’s
<INTEGRATION_NAME>.d/folder in your Agent configuration directory.
conf.yaml.examplefile from the
<INTEGRATION_NAME>/datadog_checks/<INTEGRATION_NAME>/data/folder in the created directory.