Community integration installation

Community integration installation

Community developed integrations for the Datadog Agent are stored in the Integrations-extra Github repository. They are not packaged and built into the Datadog Agent, but can be installed as add-ons by following these instructions:

To install the <INTEGRATION_NAME> check on your host:

  1. Download and launch the Datadog Agent.

  2. Run the following command to install the integrations with the Agent:

    datadog-agent integration install -t datadog-<INTEGRATION_NAME>==<INTEGRATION_VERSION>
    
  3. Configure your integration like any other packaged integration.

  4. Restart the Agent.

The best way to use an integration from integrations-extra with the Docker Agent is to build the Agent with this integration installed. Use the following Dockerfile to build an updated version of the Agent that includes the <INTEGRATION_NAME> integration from integrations-extras.

FROM gcr.io/datadoghq/agent:latest
RUN agent integration install -r -t datadog-<INTEGRATION_NAME>==<INTEGRATION_VERSION>

The agent integration install command run inside docker will issue the following harmless warning: Error loading config: Config File "datadog" Not Found in "[/etc/datadog-agent]": warn. This warning can be ignored.

Then use this new Agent image in combination with Autodiscovery in order to enable the <INTEGRATION_NAME> check.

To install the <INTEGRATION_NAME> check on your host:

  1. Download the Datadog Agent on your host.
  2. Download the <INTEGRATION_NAME>.py file in the <INTEGRATION_NAME>/datadog_checks/<INTEGRATION_NAME>/ folder from the integrations-extra repository
  3. Place it in the Agent’s checks.d directory.
  4. Download the conf.yaml.example file in the <INTEGRATION_NAME>/datadog_checks/<INTEGRATION_NAME>/data/ folder from the integrations-extra repository
  5. Rename this file into conf.yaml.
  6. Create a new <INTEGRATION_NAME>.d/ folder in your Agent configuration directory.
  7. Place the conf.yaml file in the directory created in step 6.
  8. Configure your integration like any other packaged integration.
  9. Restart the Agent.

Further Reading