cookbook 'datadog', '= 0.1.3'
datadog
(82) Versions
0.1.3
-
-
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', '= 0.1.3', :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.
Datadog Cookbook
Chef recipes to deploy Datadog's components and configuration automatically.
Requirements
- python >= 2.6
- chef >= 10.12
Platform
- Debian, Ubuntu, RedHat, CentOS
Cookbooks
The following Opscode cookbooks are dependencies:
- apt
- chef_handler
- yum::epel
Attributes
-
node['datadog']['api_key']
= This needs to be retrieved from your Account Settings page. -
node['datadog']['application_key']
= There are none by default. Visit the Account Settings page to create a new Application Key, to be used in conjunction with your API key. -
node['datadog']['url']
= The location of where Datadog is hosted. Should never change. -
node['datadog']['repo']
= Where the Datadog-maintained packages are located. Should never change. -
node['datadog']['debug']
= Will trigger heavy logging to /tmp/dd-agent.log -
node['datadog']['use_ec2_instance_id']
= Whether to use the instance-id in lieu of hostname when running on EC2. No effect on non-EC2 servers. -
node['datadog']['use_mount']
= Whether to use the mount point instead of the device name for all I/O metrics. -
node['datadog']['tags']
= List of Datadog tags you want to apply to this host -
node['datadog']['dogstreams']
= List of Dogstreams (see Guide to Log Parsing for details).
apache
-
node['apache']['status_url']
= Url to Apache's status page. Must have mod_status installed. See http://httpd.apache.org/docs/2.0/mod/mod_status.html for details.
ganglia
-
node['ganglia']['url']
= Ganglia host where gmetad is running -
node['ganglia']['port']
= Ganglia port where gmetad is running
graphite
-
node['datadog']['graphite']
= Turns the agent into a Graphite carbon relay. -
node['datadog']['graphite_port']
= Port that the carbon relay will listen on.
haproxy
-
node['datadog']['haproxy']['stats_url']
= URL for haproxy stats -
node['datadog']['haproxy']['stats_user']
= Optional HTTP Basic Auth user to access haproxy stats -
node['datadog']['haproxy']['stats_password']
= Optional HTTP Basic Auth password to access haproxy stats
mysql
-
node['mysql']['server']
= MySQL host -
node['mysql']['user']
= MySQL user. It only runs "SHOW STATUS" queries, which doesn't require any privileges, so you should consider creating a separate, unprivileged user. -
node['mysql']['pass']
= MySQL user's password
postgres
-
node['postgres']['server']
= PostgreSQL host -
node['postgres']['port']
= 5432 by default -
node['postgres']['user']
= user that the agent will use to connect, "datadog" by default -
node['postgres']['password']
= password to connect the datadog agent
Do not forget to update you pg_hba.conf
and SIGHUP
postgres in case your postgres access control requires it.
nginx
-
node['nginx']['status_url']
= Url to nginx's status page. Must have http_stub_status_module installed. See http://wiki.nginx.org/HttpStubStatusModule for details.
rabbitmq
-
node['rabbitmq']['status_url']
= Url to RabbitMQ's status page. Must have rabbitmq-status plugin installed. See http://www.lshift.net/blog/2009/11/30/introducing-rabbitmq-status-plugin for details. -
node['rabbitmq']['user']
= RabbitMQ user -
node['rabbitmq']['pass']
= RabbitMQ user's password
mongodb
-
node['mongodb']['server']
= MongoDB uri. For example: mongodb://my_user:my_pass@localhost/my_db
couchdb
-
node['couchdb']['server']
= CouchDB host
jenkins
-
node['jenkins']['home_dir']
= Path to Jenkins's home directory
nagios
-
node['nagios']['log_dir']
= Path to Nagios's event log file -
node['nagios']['conf_dir']
= If you use perfdata, dd-agent can import automatically and in real-time performance data collected by nagios. For more information on perfdata configuration, please refer to http://nagios.sourceforge.net/docs/3_0/perfdata.html. Path to Nagios' configuration file where the properties host|service_perfdata_file and host|service_perfdata_file_template are defined.
cassandra
-
node['cassandra']['host']
= Cassandra host -
node['cassandra']['port']
= Cassandra port -
node['cassandra']['nodetool']
= Path to nodetool
java
-
node['jvm_jmx']['server']
= JMX server:port to connect to -
node['jvm_jmx']['user']
= JMX user to log in with, if needed -
node['jvm_jmx']['pass']
= Password for the configured JMX user -
node['jvm_jmx']['name']
= Name to report the statistics for this java VM. This will allow to monitor several JVMs running on the same machine.
tomcat
-
node['tomcat_jmx']['server']
= host:port to connect to. Must be configured in tomcat setenv.sh or similar -
node['tomcat_jmx']['user']
= JMX user to log in with, if needed -
node['tomcat_jmx']['pass']
= Password for the configured JMX user
varnish
-
node['varnish']
= if true, will invokevarnishstat
on the server to gather varnish metrics.
memcached
-
node['memcached']['listen']
= memcached address; if 0.0.0.0 dd-agent will connect via the loopback address. -
node['memcached']['port']
= memcached port
redis
-
node['redis']['server']['addr']
= redis server address -
node['redis']['server']['port']
= redis server port
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
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.
Usage
- Add this cookbook to your Chef Server, either by installing with knife or downloading and uploading to your chef-server with knife.
- Add your API Key, either to
attributes/default.rb
, or by using the inheritance model and placing it on the node/ - Upload the new recipe via:
knife cookbook upload datadog
- Associate the recipes with the desired
roles
, i.e. "role:chef-client" should contain "datadog::dd-handler" and a "role:somethingelse" should start the dd-agent with "datadog::dd-agent". - Wait until chef-client runs on the target node (or trigger chef-client 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 1 API key.
Changes/Roadmap
v0.1.3
- Work-around for COOK-2171
v0.1.2
- Fixed typo in jmx section
v0.1.1
- 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
v0.0.12
- Updated for CentOS dependencies
v0.0.11
- Link to github repository.
v0.0.10
-
dd-handler
- Corrects attribute name.
v0.0.9
-
dd-agent
- Adds an explicit varnish attribute.
v0.0.8
-
dd-agent
- Add varnish support.
v0.0.7
-
dd-agent
- default to using instance IDs as hostnames when running dd-agent on EC2
v0.0.5
-
dd-agent
- Full datadog.conf template using attributes (thanks @drewrothstein)
v0.0.4
-
dd-agent
- Added support for Nagios PerfData and Graphite.
v0.0.3
-
dd-agent
- Added support for RPM installs - Red Hat, CentOS, Scientific, Fedora
v0.0.2
- Initial refactoring, including the
dd-agent
cookbook here - Adding chef-handler-datadog to report to the newsfeed
- Added ruby-dev dependency
License and Author
Author:: Mike Fiedler (miketheman@gmail.com)
Author:: Alexis Le-quoc (alq@datadoghq.com)
Copyright 2012, Datadog, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.