datadog (82) Versions 2.8.0 Follow62

Installs/Configures datadog components

Policyfile

Berkshelf

Knife

cookbook 'datadog', '= 2.8.0', :supermarket

cookbook 'datadog', '= 2.8.0'

knife supermarket install datadog

knife supermarket download datadog

README

Dependencies

Changelog

Quality 100%

Where to Find the Code

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).

Datadog Cookbook

Chef recipes to deploy Datadog's components and configuration automatically.

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

Requirements

chef >= 10.14

Platforms

Amazon Linux
CentOS
Debian
RedHat
Scientific Linux
Ubuntu
Windows (requires chef >= 12.0)

Cookbooks

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)

Recipes

default

Just a placeholder for now, when we have more shared components they will probably live there.

dd-agent

Installs the Datadog agent on the target system, sets the API key, and start the service to report on the local system metrics

Note 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 the windows 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 the 2.5.0 version of the present cookbook) to uninstall the Agent
prior to any Agent upgrade.

dd-handler

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.

dogstatsd-(python|ruby)

Installs the language-specific libraries to interact with dogstatsd.

other

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.

Usage

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 or role, or
- as a node attribute by declaring it in another cookbook at a higher precedence level, or
- in the node run_state by setting node.run_state['datadog']['api_key'] in another cookbook preceding datadog'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]
)
``5. Wait untilchef-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.

Dependent cookbooks

Contingent cookbooks

Changes

2.8.0 / 2017-01-25

[FEATURE] Add ssl_verify option to RabbitMQ template, #383 @iancward
[FEATURE] Add correct sudo commands to Postfix recipe, #384 @BrentOnRails & @degemer
[FEATURE] Add support for windows_service integration, #387 @mlcooper
[FEATURE] Add attributes for package download retries, #390 @degemer
[FEATURE] Add tags blacklist regex attribute for handler, #397 @ABrehm264 & @degemer
[FEATURE] Defer evaluation of api and app keys and read from run_state, #395 @mfischer-zd

2.7.0 / 2016-11-15

[FEATURE] Add dd-agent user to docker group in docker/docker_daemon recipes, #364 @jvrplmlmn
[FEATURE] Add support for system_swap check, #372 @iancward
[FEATURE] Add ability to pin datadog-agent versions per platform, #368 @mlcooper
[FEATURE] Add support for any config option in datadog.conf, #375 @degemer
[FEATURE] Trust new APT and RPM keys, #365 @olivielpeau
[OPTIMIZE] Simplify postgres.yaml template, #380 @miketheman
[BUGFIX] Allow instances with no tags in postfix template, #374 @nyanshak

2.6.0 / 2016-09-20

[FEATURE] Allow multiple enpoints/api_keys conf on Agent and handler, #317 @degemer
[FEATURE] Add kafka template versioning, #340 @degemer
[FEATURE] Add gunicorn support, #355 @mlcooper
[FEATURE] Add attribute to allow agent downgrade, #359 @olivielpeau
[OPTIMIZE] Fully disable dogstatsd when attribute is set to false/nil, #348 @ccannell67
[OPTIMIZE] Use HTTPS for yumrepo when applicable, #351 @aknarts
[BUGFIX] Fix agent version test when version contains an epoch, #357 @olivielpeau
[BUGFIX] Fix datadog-agent-base removal guard logic on rhellions, #358 @olivielpeau
[BUGFIX] Replace deprecated properties of yum_repository, #361 & #362 @historus & @olivielpeau

2.5.0 / 2016-08-08

[FEATURE] Add support for extra_packages agent checks, #271 @tmichelet
[FEATURE] Add Windows support to remove-dd-agent recipe (Chef >= 12.6 only), #332 @raycrawford
[FEATURE] Make yum repo GPG key an attribute, #326 @iancward
[FEATURE] Add support for provider option in iis check, #324 @clmoreno
[FEATURE] Add support for tags in etcd check, #322 @stensonb
[FEATURE] Add developer_mode option to datadog.conf, #315 @olivielpeau
[FEATURE] Add support for win32_event_log check, #314 @olivielpeau
[FEATURE] Add dogstatsd_target option to datadog.conf, #313 @jcftang-r7
[FEATURE] Add support forcustom_metrics in postgres check, #284 @flah00
[OPTIMIZE] Update windows support with many improvements, #334 @brentm5
[OPTIMIZE] Pass the hostname attribute to the handler, #308 @gmmeyer
[MISC] Allow non-breaking updates of chef_handler, #291 @eherot

NOTE The strict version constraint on chef_handler had been introduced because the 1.2 minor release
of chef_handler broke compatibility with Chef 11. Chef 11 compatibility has been re-introduced in the 1.3
release, we recommend using that version or higher if you use Chef 11.

2.4.0 / 2016-05-04

[FEATURE] Add support for dns_check, #294 @nickmarden
[FEATURE] Add support for directory check, #277 @kindlyseth
[BUGFIX] Template error in postgres.yaml, #300, #304 @miketheman

2.3.0 / 2016-04-25

[FEATURE] Add support for go_expvar check, #298 @hartfordfive
[FEATURE] Allow a String or Hash when configuring Agent tags, #296 @martinisoft
[FEATURE] Allow passing a tag_prefix to the handler, #285 @mstepniowski
[FEATURE] Allow Agent config to control service behavior, #280 @hydrant25 & @miketheman
[FEATURE] Add collect_function_metrics to postgres check, #278 @isaacdd
[FEATURE] Add logging configuration overrides, #273 @SupermanScott & @miketheman
[FEATURE] Add cassandra template versions, #263 @yannmh @sethrosenblum & @miketheman
[FEATURE] Add sites options to iis check, #261, @cobusbernard & @miketheman
[FEATURE] Add missing options to rabbitmq check, #232 @mattrobenolt & @miketheman
[FEATURE] Add Agent config option for histogram_*, #272, @SupermanScott
[FEATURE] Add support for commandstats in redis check, #266 @sethrosenblum
[FEATURE] Add support for ssh_check check, #262 @wk8
[FEATURE] Add support for custom MySQL queries, #259 @wk8
[FEATURE] Add PHP-FPM recipe, #253 @jridgewell
[FEATURE] Allow yum_repository resource to receive proxy options, #251 @RedWhiteMiko
[FEATURE] Add Agent config option for statsd_metric_namespace, #250 @MiguelMoll
[FEATURE] Allow use of Agent web_proxy config for Handler, #208 @datwiz
[OPTIMIZE] Allow tags to be nil during Windows Agent install, #286 @rlaveycal
[OPTIMIZE] Apply sensitive filter to template renders, #274 @martinisoft
[DOCS] Correct redisdb example, #281 @iashwash
[DOCS] Correct docker_daemon example, #276 @dlackty
[MISC] Remove knife.rb file from repo, #299 @miketheman
[MISC] Convert Kitchen Test to ChefSpec test for activemq, #295 @miketheman
[MISC] Add Kitchen tests via CircleCI & kitchen-docker, @miketheman
[MISC] Update Travis lint/spec tests to use ChefDK-supplied packages, @miketheman

2.2.0 / 2015-10-27

This release deserves a specific callout for a feature that has been finally
implemented and deserves a major round of applause to @EasyAsABC123,
@rlaveycal, @olivielpeau for their efforts in making Windows platform
support in this cookbook a reality.
[FEATURE] Add support for docker_daemon check, #249 @kurochan
[FEATURE] Add support for solr check, #246 @miketheman
[FEATURE] Add support for system_core check, #243 @miketheman
[FEATURE] Add support for consul check, #238 @wk8 & @darron
[FEATURE] Add ssl support for postgres check, #237 @uzyexe
[FEATURE] Add support for etcd check, #235 @zshenker & @darron
[FEATURE] Add RPM signature check, #225 @elafarge, #240 @miketheman
[FEATURE] Add missing varnish check options, #224 @hilli
[FEATURE] Add timeout option to elasticsearch check, #223 @dominicchan
[FEATURE] Add per-shard config toggles to elasticsearch check. Agent 5.5.0+, #221 @elafarge
[FEATURE] Add per-check tagging to datadog.conf. Agent 5.5.0+, #220 @elafarge ref
[FEATURE] Add port for mysql check, #217 @NathanielMichael
[FEATURE] Add support for Windows, #210 @EasyAsABC123, @rlaveycal, @olivielpeau
[FEATURE] Add skip_ssl_validation toggle to the datadog config file, #209 @ABrehm264
[FEATURE] Add support for supervisord check, #204 @DorianZaccaria
[FEATURE] Add support for pgbouncer check, #198 @DorianZaccaria
[FEATURE] Update options for redisdb check, #185 @opsline-radek, @miketheman (specs)
[FEATURE] Add support for postfix check, #167 @phlipper
[BUGFIX] Fix kafka template tags, #244 @LeoCavaille
[BUGFIX] Fix updated_by_last_action value of monitor provider, #229 @olivielpeau
[BUGFIX] Make zookeeper check timeout optional, #227 @olivielpeau
[OPTIMIZE] Detect virtual package prior to removal, #247 @dwradcliffe
[OPTIMIZE] Add source & issues URLs for Supermarket, #248 @jeffbyrnes
[OPTIMIZE] Skip dd-handler recipe in why-run mode, #231 @olivielpeau
[OPTIMIZE] Add apt-transport-https for deb-based repo install, #219 @darron
[OPTIMIZE] Change rights on Agent configuration files, #218 @olivielpeau
[OPTIMIZE] Updates to manage LWRP, #212 @jmanero-r7
[DOCS] Correct jmx example, #245 @tejom
[DOCS] Correct kafka example, #205 @elafarge
[DOCS] Correct fluentd example, #203 @inokappa
[MISC] Add Rake task for cleanup, #216 @miketheman
[MISC] Update guard and Guardfile, #215 @miketheman
[MISC] Create ChefSpec matchers for spec testing, @miketheman
[MISC] Update jmx tests for accurate structure, @miketheman
[MISC] Update libraries used in test suite, @miketheman

2.1.0 / 2015-04-20

[FEATURE] Add support for mesos check, #200 @DorianZaccaria
[FEATURE] Add support for docker check, #197 @DorianZaccaria
[OPTIMIZE] Set compile_time when using chef_gem resource, #196 @miketheman
[FEATURE] Add support for ntp check, #182 @chrissnell, @miketheman
[OPTIMIZE] Remove long-dead debug_mode and replace with log_level, #187 @remh
[FEATURE] Add support for http & tcp monitoring check, #177 @mtougeron, #178 @chrissnell, @miketheman
[FEATURE] Add support for fluentd monitoring check, #191 @takus, #192 @miketheman
[FEATURE] Add support for process monitoring check, #190 @jpcallanta
[FEATURE] Add configuration flags to elasticsearch template, #169 @chrissnell
[FEATURE] Add configuration flag to control collection of EC2 tags from Agent, #159 @mirceal
[FEATURE] Add Agent package attribute to control package provider action, #127, #147 @miketheman
[OPTIMIZE] Use hkp keyserver URL on debianoids, #138 @khouse
[BUGFIX] Use correct indentation for kafka recipe, correct values, add tests, #163, @donaldguy & @miketheman
[BUGFIX] Use correct indentation for activemq recipe, correct param, add tests, #171 @SelerityMichael & @miketheman
[FEATURE] Add support for bind_host parameter, #148 @jblancett
[FEATURE] Add support for Fedora platform, #135 @juliandunn
[FEATURE] Add recipe for package removal, #125 @bitmonk
[FEATURE] Add support for custom emitters, #123 @arthurnn & @graemej
[FEATURE] Add support for statsd forwarding in config file, #117 @ctrlok
[BUGFIX] Simplify JMX configuration, #116 @miketheman

NOTE This has been broken for some time, and has had multiple attempts at fixing properly. The correct interface
has never been documented, and the implementation has always been left up to the reader. We have changed this to be
much simpler - instead of trying to account for any possible methods

[BUGFIX] Correct cassandra template render flags, @miketheman
[DOCS] Remove suggestion for python cookbook, as it is no longer needed. @miketheman
[MISC] Updates to test suite for simplicity, deprecation warnings, dependencies @miketheman & @darron

2.0.0 / 2014-08-22

BREAKING CHANGE: Datadog Agent 5.0.0 Release Edition

With the release of Datadog Agent 5.x, all Python dependencies are now bundled, and extensions for monitoring are no
longer needed. Integration-specific recipes no longer install any packages, so if you are using a version older than
5.x, you may have to install these yourself. This greatly simplifies deployment of all components for monitoring.
See commit b77582122f3db774a838f90907b421e544dd099c for the exact package resources that have been removed.
Affected recipes:

hdfs
memcache
mongodb
mysql
postgres
redisdb
- BREAKING CHANGE: Removed chef_gem support for Chef versions pre 0.10.9.

We haven't supported this version of Chef in some time, so it's unlikely that you will be affected at all.
Just in case, please review what versions of Chef you have installed, and use an older version of this cookbook until
you can upgrade them.

[OPTIMIZE] Update repository recipe to choose correct arch, @remh
[OPTIMIZE] Remove conditional python dep for Ubuntu 11.04, @miketheman
[OPTIMIZE] Remove extra apt-get call during Agent recipe run, @miketheman
[FEATURE] Add kafka monitoring recipe & tests, #113 @qqfr2507
[FEATURE] Allow database name to be passed into postgres template, @miketheman
[MISC] Many updates to testing suite. Faster style, better specs. @miketheman

1.2.0 / 2014-03-24

[FEATURE] Add relations parameter to Postgres check config, #97 @miketheman
[FEATURE] Add sock parameter to MySQL check configuration, #105 @thisismana
[FEATURE] Add more parameters to the haproxy templte to collect status metrics, #103 @evan2645 & @miketheman
[FEATURE] datadog::mongo recipe now installs pymongo and prerequisites, #81 @dwradcliffe
[FEATURE] Allow attribute control over whether to allow the local Agent to handle non-local traffic, #100 @coosh
[FEATURE] Allow attribute control over whether the Chef Handler is activated, #95 @jedi4ever, @miketheman
[FEATURE] Allow attribute control over whether Agent should be running, #94 @jedi4ever, @miketheman
[FEATURE] Reintroduce attribute config for dogstatsd daemon, #90 @jedi4ever, @miketheman
[FEATURE] Allow jmx template to accept arbitrary key, value statements, #93 @clofresh
[FEATURE] Allow cassandra/zookeeper templates to accept arbitrary key, value statements, @miketheman
[FEATURE] Add name param to varnish recipe, #86 @clofresh
[FEATURE] Allow attribute-driven settings for web proxy, #82 @antonio-osorio
[FEATURE] Allow override of Agent config for hostname via attribute, #76 @ryandjurovich
[FEATURE] Allow for non-conf.d integrations to be set via attributes, #66 @babbottscott
[FEATURE] added hdfs recipe and template, #77 @phlipper
[FEATURE] added zookeeper recipe and template, #74 @phlipper
[BUGFIX] Warn user when more than one network instance is defined, #98 @miketheman
[BUGFIX] Properly indent jmx template, #88 @flah00
[BUGFIX] Handle unrecognized Python version strings in a better fashion, #79 #80 #84, @jtimberman, @schisamo, @miketheman
[BUGFIX] Set gpgcheck to false for yum repo if it exists, #89 @alexism, #101 @nkts
[MISC] Inline doc for postgres recipe, #83 @timusg

1.1.1 / 2013-10-17

[FEATURE] added rabbitmq recipe and template, @miketheman
[BUGFIX] memcache dependencies and template, #67 @elijahandrews
[BUGFIX] redis python client check was not properly checking the default version, @remh
[MISC] tailor 1.3.1 caught some cosmetic issue, @alq

1.1.0 / 2013-08-20

[FEATURE] Parameterize chef-handler-datadog Gem version, #60 @mfischer-zd
[FEATURE] Allow control of network.yaml via attributes, #63 @JoeDeVries
[FEATURE] Use Python version from Ohai to determine packages to install, #65 @elijahandrews
[BUGFIX] redisdb default port in template should be 6379, #59 @miketheman
[BUGFIX] templates creating empty tags in config when unspecified for multiple integrations #61 @alq
[MISC] updated tests @elijahandrews, @miketheman
[MISC] correct the riak integration example, @miketheman
[MISC] updated CHANGELOG.md style, @miketheman

Dependency Note

One of the dependencies of this cookbook is the apt cookbook.
A change introduced in the apt cookbook 2.0.0 release was a Chef 11-specific feature that would break on any Chef 10 system, so we considered adding a restriction in our metadata.rb to anything below 2.0.0.

A fix has gone in to apt 2.1.0 that relaxes this condition, and plays well with both Chef 10 and 11. We recommend using this version, or higher.

1.0.1 / 2013-05-14

Fixed iis and rabbitmq template syntax - #58 @gregf
Updated style/spacing in ActiveMQ template
Updated test suite to validate cookbook & templates
Updated chefignore to clean the built cookbook from containing cruft

1.0.0 / 2013-05-06

BREAKING CHANGE: Moved all attributes into datadog namespace - #46 (#23, #26)

Reasoning behind this was that originally we attempted to auto-detect many common attributes and deploy automatic monitoring for them.
We found that since inclusion of the datadog cookbook early in the run list caused the compile phase to be populated with our defaults (mostly nil), instead of the desired target, and namespacing of the attributes became necessary.

NEW PROVIDER: Added a new datadog_monitor provider for integration use

The new provider is used in many pre-provided integration recipes, such as datadog::apache.
This enables a run list to include this recipe, as well as populate a node attribute with the needed instance details to monitor the given service

Updated dependencies in Gemfile, simplifies travis build - #34, #55
Much improved test system (chefspec, test-kitchen) - #35 & others
Tests against multiple versions of Chef - #18
Added language-specific recipes for installing dogstatsd - (#28)
Added ability to control dogstatsd from agent config via attribute - #27
Placed the dogstatsd log file in /var/log/ instead of /tmp
Added attribute to configure dogstreams in datadog.conf - #37
Updated for platform_family semantics
Added node['datadog']['agent_version'] attribute
(Handler Recipe) Better handling of EC2 instance ID for Handler - #44
Updated for agent 3.6.x logging syntax
Generated config file removes some whitespace - #56
Removed dependency on yum::epel, only uses yum for the repository recipe

0.1.4 / 2013-04-25

Quick fix for backporting test code to support upload in ruby 1.8.7

0.1.3 / 2013-01-27

Work-around for COOK-2171

0.1.2 / 2012-10-15

Fixed typo in jmx section

0.1.1 / 2012-09-18

Added support for postgres, redis & memcached
dd-agent - updated to include more platforms
dd-handler - updated to leverage chef_gem resource if available
Updated syntax for node attribute accessors
Some syntax styling fixes
Added agent logging configuration
Removed extraneous dependencies
Added automated testing suite

0.0.12

Updated for CentOS dependencies

0.0.11

Link to github repository.

0.0.10

dd-handler - Corrects attribute name.

0.0.9

dd-agent - Adds an explicit varnish attribute.

0.0.8

dd-agent - Add varnish support.

0.0.7

dd-agent - default to using instance IDs as hostnames when running dd-agent on EC2

0.0.5

dd-agent - Full datadog.conf template using attributes (thanks @drewrothstein)

0.0.4

dd-agent - Added support for Nagios PerfData and Graphite.

0.0.3

dd-agent - Added support for RPM installs - Red Hat, CentOS, Scientific, Fedora

0.0.2

Initial refactoring, including the dd-agent cookbook here
Adding chef-handler-datadog to report to the newsfeed
Added ruby-dev dependency

Collaborator Number Metric

2.8.0 passed this metric

Foodcritic Metric

2.8.0 passed this metric

License Metric

2.8.0 passed this metric

Adoptable Cookbooks List

Supermarket Belongs to the Community

View our collection of guides, documentation, and articles

Select Badges

Select Supported Platforms

Select Status

Where to Find the Code

Datadog Cookbook

Requirements

Platforms

Cookbooks

Recipes

default

dd-agent

dd-handler

dogstatsd-(python|ruby)

other

Usage

Dependent cookbooks

Contingent cookbooks

Changes

2.8.0 / 2017-01-25

2.7.0 / 2016-11-15

2.6.0 / 2016-09-20

2.5.0 / 2016-08-08

2.4.0 / 2016-05-04

2.3.0 / 2016-04-25

2.2.0 / 2015-10-27

2.1.0 / 2015-04-20

2.0.0 / 2014-08-22

1.2.0 / 2014-03-24

1.1.1 / 2013-10-17

1.1.0 / 2013-08-20

Dependency Note

1.0.1 / 2013-05-14

1.0.0 / 2013-05-06

0.1.4 / 2013-04-25

0.1.3 / 2013-01-27

0.1.2 / 2012-10-15

0.1.1 / 2012-09-18

0.0.12

0.0.11

0.0.10

0.0.9

0.0.8

0.0.7

0.0.5

0.0.4

0.0.3

0.0.2

Collaborator Number Metric 2.8.0 passed this metric

Foodcritic Metric 2.8.0 passed this metric

License Metric 2.8.0 passed this metric

Details

Updated January 25, 2017 Created on November 19, 2011

Supported Platforms

Badges

License

Collaborator Number Metric

2.8.0 passed this metric

Foodcritic Metric

2.8.0 passed this metric

License Metric

2.8.0 passed this metric