This repository contains the Agent Integrations that Datadog officially develops and supports. To add a new integration, please see the Integrations Extras repository and the accompanying documentation.
To get started developing with the integrations-core repo you will need: gem and python.
We’ve written a gem and a set of scripts to help you get set up, ease development, and provide testing. To begin:
- Run
gem install bundler - Run
bundle install
Once the required Ruby gems have been installed by Bundler, you can easily create a Python environment:
- Run
rake setup_env. This will install a Python virtual environment along with all the components necessary for integration development (including the core agent used by the integrations). Some basic software might be needed to install the python dependencies likegccandlibssl-dev. - Run
source venv/bin/activateto activate the installed Python virtual environment. To exit the virtual environment, rundeactivate. You can learn more about the Python virtual environment on the Virtualenv documentation.
This is a quick setup but from that point you should be able to run the default test suit rake ci:run.
To go beyond we advise you to read the full documentation here.
The Datadog Agent contains all core integrations from this repository, so to get started using them, simply install the datadog-agent package for your operating system.
Additionally, you may install any individual core integration via its own dd-check-<integration_name> package, e.g. dd-check-nginx. We build these packages from this repository and release them more often than datadog-agent. This allows us to distribute integration updates - and brand new integrations - in between releases of datadog-agent.
In other words: on the day of a new datadog-agent release, you'll likely get the same version of the nginx check from the agent package as you would from dd-check-nginx. But if we haven't released a new agent in 6 weeks and this repository contains a bugfix for the nginx check, install the latest dd-check-nginx to override the buggy check packaged with datadog-agent.
For a check with underscores in its name, its package name replaces underscores with dashes. For example, the powerdns_recursor check is packaged as dd-check-powerdns-recursor.
For more information on integrations, please reference our documentation and knowledge base. You can also visit our help page to connect with us.