To submit issues and patches please visit https://github.com/DataDog/chef-datadog. The code is licensed under the Apache License 2.0 (see LICENSE for details).
Chef recipes to deploy Datadog's components and configuration automatically.
This cookbook includes experimental support of the beta version of the Datadog Agent 6.0, please refer to the inline docs for more details on the supported platforms and how to use it.
For general information on the Datadog Agent 6, please refer to the datadog-agent repo.
NB: This README may refer to features that are not released yet. Please check the README of the git tag/the gem version you're using for your version's documentation
- chef >= 10.14
- Amazon Linux
- CentOS
- Debian
- RedHat
- Scientific Linux
- Ubuntu
- Windows (requires chef >= 12.0)
The following Opscode cookbooks are dependencies:
apt
chef_handler
windows
yum
Note for Chef 11 users: please use these additional dependency version contraints for compatibility with Chef 11:
cookbook 'apt', '< 4.0'
cookbook 'chef_handler', '< 2.0'
cookbook 'windows', '< 2.0'
cookbook 'yum', '~> 3.0'
(in Berkshelf/Librarian format)
Just a placeholder for now, when we have more shared components they will probably live there.
Installs the Datadog agent on the target system, sets the API key, and start the service to report on the local system metrics
Notes for Windows:
-
With Chef >= 12.6 and the
windows
cookbook >= 1.39.0, Agent upgrades are known to fail. For Chef>=12.6 users on Windows, we recommend pinning thewindows
cookbook to a lower version (~> 1.38.0
for instance).If that's not an option, a known workaround is to use the
remove-dd-agent
recipe (since the2.5.0
version of the present cookbook) to uninstall the Agent prior to any Agent upgrade. -
Because of changes in the Windows Agent packaging and install in version 5.12.0, when upgrading the Agent from versions <= 5.10.1 to versions >= 5.12.0, please set the
windows_agent_use_exe
attribute totrue
.Once the upgrade is complete, you can leave the attribute to its default value (
false
).For more information on these Windows packaging changes, see the related docs on the dd-agent wiki.
Installs the chef-handler-datadog gem and invokes the handler at the end of a Chef run to report the details back to the newsfeed.
Installs the language-specific libraries to interact with dogstatsd
.
Installs the language-specific libraries for application Traces (APM).
There are many other integration-specific recipes, that are meant to assist in deploying the correct agent configuration files and dependencies for a given integration.
- Add this cookbook to your Chef Server, either by installing with knife or by adding it to your Berksfile:
cookbook 'datadog', '~> 2.7.0'
- Add your API Key either:
- as a node attribute via an
environment
orrole
, or - as a node attribute by declaring it in another cookbook at a higher precedence level, or
- in the node
run_state
by settingnode.run_state['datadog']['api_key']
in another cookbook precedingdatadog
's recipes in the run_list. This approach has the benefit of not storing the credential in clear text on the Chef Server.
-
Create an 'application key' for
chef_handler
here, and add it as a node attribute or in the run state, as in Step #2.NB: if you're using the run state to store the api and app keys you need to set them at compile time before
datadog::dd-handler
in the run list. -
Associate the recipes with the desired
roles
, i.e. "role:chef-client" should contain "datadog::dd-handler" and a "role:base" should start the agent with "datadog::dd-agent". Here's an example role with both recipes:
name 'example'
description 'Example role using DataDog'
default_attributes(
'datadog' => {
'api_key' => 'api_key',
'application_key' => 'app_key'
}
)
run_list %w(
recipe[datadog::dd-agent]
recipe[datadog::dd-handler]
)
- Wait until
chef-client
runs on the target node (or trigger chef-client manually if you're impatient)
We are not making use of data_bags in this recipe at this time, as it is unlikely that you will have more than one API key and one application key.
For more deployment details, visit the Datadog Documentation site.