cookbook 'datadog', '= 2.7.0'
datadog
(82) Versions
2.7.0
-
-
4.21.0
-
4.20.0
-
4.19.0
-
4.18.0
-
4.17.0
-
4.16.0
-
4.15.0
-
4.14.0
-
4.13.0
-
4.12.0
-
4.11.1
-
4.11.0
-
4.10.0
-
4.9.0
-
4.8.0
-
4.7.2
-
4.7.1
-
4.7.0
-
4.6.0
-
4.5.0
-
4.4.0
-
4.3.0
-
4.2.1
-
4.2.0
-
4.1.1
-
4.1.0
-
4.0.1
-
4.0.0
-
3.5.1
-
3.5.0
-
3.4.1
-
3.4.0
-
3.3.0
-
3.2.0
-
3.1.0
-
3.0.0
-
2.20.1
-
2.20.0
-
2.19.0
-
2.18.0
-
2.17.0
-
2.16.1
-
2.16.0
-
2.15.0
-
2.14.1
-
2.14.0
-
2.13.0
-
2.12.0
-
2.11.0
-
2.10.1
-
2.10.0
-
2.9.1
-
2.9.0
-
2.8.1
-
2.8.0
-
2.7.0
-
2.6.0
-
2.5.0
-
2.4.0
-
2.3.0
-
2.2.0
-
2.1.0
-
2.0.0
-
1.2.0
-
1.1.1
-
1.1.0
-
1.0.1
-
1.0.0
-
0.1.4
-
0.1.3
-
0.1.2
-
0.1.1
-
0.1.0
-
0.0.12
-
0.0.11
-
0.0.10
-
0.0.9
-
0.0.8
-
0.0.4
-
0.0.3
-
0.0.2
-
0.0.1
Follow62
- 4.21.0
- 4.20.0
- 4.19.0
- 4.18.0
- 4.17.0
- 4.16.0
- 4.15.0
- 4.14.0
- 4.13.0
- 4.12.0
- 4.11.1
- 4.11.0
- 4.10.0
- 4.9.0
- 4.8.0
- 4.7.2
- 4.7.1
- 4.7.0
- 4.6.0
- 4.5.0
- 4.4.0
- 4.3.0
- 4.2.1
- 4.2.0
- 4.1.1
- 4.1.0
- 4.0.1
- 4.0.0
- 3.5.1
- 3.5.0
- 3.4.1
- 3.4.0
- 3.3.0
- 3.2.0
- 3.1.0
- 3.0.0
- 2.20.1
- 2.20.0
- 2.19.0
- 2.18.0
- 2.17.0
- 2.16.1
- 2.16.0
- 2.15.0
- 2.14.1
- 2.14.0
- 2.13.0
- 2.12.0
- 2.11.0
- 2.10.1
- 2.10.0
- 2.9.1
- 2.9.0
- 2.8.1
- 2.8.0
- 2.7.0
- 2.6.0
- 2.5.0
- 2.4.0
- 2.3.0
- 2.2.0
- 2.1.0
- 2.0.0
- 1.2.0
- 1.1.1
- 1.1.0
- 1.0.1
- 1.0.0
- 0.1.4
- 0.1.3
- 0.1.2
- 0.1.1
- 0.1.0
- 0.0.12
- 0.0.11
- 0.0.10
- 0.0.9
- 0.0.8
- 0.0.4
- 0.0.3
- 0.0.2
- 0.0.1
Installs/Configures datadog components
cookbook 'datadog', '= 2.7.0', :supermarket
knife supermarket install datadog
knife supermarket download datadog
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.
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.1.0'
- Add your API Key as a node attribute via an
environment
orrole
or by declaring it in another cookbook at a higher precedence level. - Create an 'application key' for
chef_handler
here, and add it as a node attribute, as in Step #2. - 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]
)
``
chef-client` runs on the target node (or trigger chef-client manually if you're impatient)
5. Wait until
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
apt >= 0.0.0 |
chef_handler ~> 1.1 |
windows >= 0.0.0 |
yum >= 3.0 |
Contingent cookbooks
Changes
2.7.0 / 2016-11-15
- [FEATURE] Add
dd-agent
user todocker
group indocker
/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
inpostfix
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 iniis
check, #324 @clmoreno - [FEATURE] Add support for tags in
etcd
check, #322 @stensonb - [FEATURE] Add
developer_mode
option todatadog.conf
, #315 @olivielpeau - [FEATURE] Add support for
win32_event_log
check, #314 @olivielpeau - [FEATURE] Add
dogstatsd_target
option todatadog.conf
, #313 @jcftang-r7 - [FEATURE] Add support for
custom_metrics
inpostgres
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
topostgres
check, #278 @isaacdd - [FEATURE] Add logging configuration overrides, #273 @SupermanScott & @miketheman
- [FEATURE] Add
cassandra
template versions, #263 @yannmh @sethrosenblum & @miketheman - [FEATURE] Add
sites
options toiis
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 benil
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
etcd
check, #235 @zshenker & @darron[FEATURE] Add RPM signature check, #225 @elafarge, #240 @miketheman
[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)[BUGFIX] Fix
kafka
templatetags
, #244 @LeoCavaille[BUGFIX] Fix
updated_by_last_action
value ofmonitor
provider, #229 @olivielpeau[BUGFIX] Make
zookeeper
checktimeout
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 inwhy-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[MISC] Add Rake task for cleanup, #216 @miketheman
[MISC] Update
guard
andGuardfile
, #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 withlog_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 installspymongo
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
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 usesyum
for therepository
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 leveragechef_gem
resource if available - Updated copyright for 2012
- 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.7.0 passed this metric
Foodcritic Metric
2.7.0 passed this metric
2.7.0 passed this metric
2.7.0 passed this metric