Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


serverdensity (25) Versions 3.2.7

Installs/Configures the v2 Server Density monitoring agent

cookbook 'serverdensity', '~> 3.2.7', :supermarket
cookbook 'serverdensity', '~> 3.2.7'
knife supermarket install serverdensity
knife supermarket download serverdensity
Quality 33%


This cookbook installs the v2 Server Density agent on your Linux systems. This also includes support for the following plugins:

  • sd-agent-apache
  • sd-agent-btrfs
  • sd-agent-consul
  • sd-agent-couchbase
  • sd-agent-couchdb
  • sd-agent-directory
  • sd-agent-docker
  • sd-agent-elastic
  • sd-agent-haproxy
  • sd-agent-hdfs
  • sd-agent-kafka-consumer
  • sd-agent-memcache
  • sd-agent-mongo
  • sd-agent-mysql
  • sd-agent-nginx
  • sd-agent-ntp
  • sd-agent-phpfpm
  • sd-agent-postfix
  • sd-agent-postgres
  • sd-agent-rabbitmq
  • sd-agent-redis
  • sd-agent-riak
  • sd-agent-supervisord
  • sd-agent-tcp-check
  • sd-agent-varnish
  • sd-agent-zookeeper



  • apt
  • yum
  • dpkg_autostart


  • rest-client


  • Ubuntu
  • Debian
  • RHEL
  • CentOS
  • Amazon
  • Oracle
  • Scientific

Support for Ubuntu Precise is now deprecated and agent updates are no longer provided after 2.1.6. This cookbook will install agent 2.1.6 for any server detected as Ubuntu Precise


Required Attributes

attribute "serverdensity/account",
  :display_name => "Your Server Density account",
  :description => "Your Server Density subdomain, i.e.",
  :type => "string",
  :required => "required"
attribute "serverdensity/agent_key",
  :display_name => "Your Server Density agent key",
  :description => "Your Server Density agent key",
  :type => "string"


attribute "serverdensity/token",
:display_name => "Your Server Density API Token",
:description => "Your Server Density API Token",
:type => "string"


Check attributes/default.rb for the full list



Just include serverdensity in your node's run_list to have the agent installed without any configuration:

  "run_list": [

To install and configure the agent include serverdensity in your node's run_list and configure the token and sd_account attributes

Including your API token will allow the cookbook to query the API and generate a new agent key for you, or if the device already exists, return the correct agent key.
You can either specify your account and token in attributes/default.rb or you can specify attributes in your run_list too:
"serverdensity": {"token": "b97da80a41c4f61bff05975ee51eb1aa","sd_account":"example"},
"run_list": [ "recipe[serverdensity]" ]

You can also include any of the attributes from attributes/default.rb in your run list to install and configure plugins. Plugin installation is decided by the presence of the first attribute in the list for the specific plugin:
"serverdensity": {"token": "b97da80a41c4f61bff05975ee51eb1aa","sd_account":"example","apache_status_url":"http://localhost/server-status?auto"},
"run_list": [

License and Authors





Dependent cookbooks

apt >= 0.0.0
yum >= 0.0.0
dpkg_autostart >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

ChangeLog for chef-serverdensity

3.2.7 (26-05-2020)

  • Adds support for Ubuntu Eoan and Focal.

3.2.6 (31-07-2019)

  • Adds support for Debian Buster.

3.2.5 (14-02-2019)

  • Fix log_to_syslog option, delete default listen_port value

3.2.4 (10-01-2019)

  • Fixed error when docker group doesn't exist
  • Set plugin_dir to nil to prevent warnings in logs
  • Fixed nginx plugin ssl check

3.2.3 (20-12-2018)

  • Fixed and improved docker daemon plugin configs.
  • Added support for TCP plugin

3.2.2 (15-10-2018)

  • Adds support for Ubuntu Cosmic.

3.2.1 (03-10-2018)

  • Adds support for Ubuntu Bionic.

3.2.0 (09-05-2018)

  • Simplifies device lookup/creation via the Server Density API.
  • Adds support for Chef 13.

3.1.1 (09-05-2018)

  • Adds the option to set min_collection_interval for the currently available plugins.

3.1.0 (22-11-2017)

  • Added support for new deb repositories
  • Added support for el6 python27 dependency
  • Ensured Amazon linux only install el6 packages

3.0.7 (10-01-2017)

  • Added support for Couchbase plugin

3.0.6 (08-12-2016)

  • Added support for HDFS and Zookeeper plugins

3.0.5 (04-10-2016)

  • Added timeout option for Elasticsearch plugin

3.0.4 (29-09-2016)

  • Added Elasticsearch support

3.0.3 (22-09-2016)

  • Fix to prevent empty array from installing the sd-agent-directory plugin

3.0.2 (19-09-2016)

  • Added HAProxy support
  • Improved handling of attributes which use arrays.

3.0.1 (01-09-2016)

  • Improved recipe to ensure that the sd-agent service is only restarted after a configuration change.
  • Small template tweaks
  • Better comments in attributes to describe when to use arrays
  • Small fixes to the recipe to point to correct packages and yaml files
  • Removal/update of deprecated features
  • Foodcritic fixes

3.0.0 (14-04-2016)

  • Rewrote entire recipe to install the Server Density v2 agent. v1 agent support has been removed.

2.1.4 (26-03-2015)

  • Use 1.7.3 rest-client (fix for "Unable to acquire a ServerDensity agent_key")

2.1.3 (12-03-2015)

  • Add matchers library for ChefSpec

2.1.2 (12-03-2015)

  • Allow the device attribute to override a built-in device provider (AWS)
  • Move chef_gem to converge time for Chef 12.1.0

2.1.1 (10-03-2015)

  • Update to use rest-client gem (rest_client depreciated)

2.1.0 (10-10-2014)

  • Added support for managing plugins
  • Move agent config to /etc/sd-agent/conf.d/agent.cfg an updated template
  • Improved support for AWS EC2 linking with Server Density cloud support
  • Added :remove and :purge options for removing the agent
  • Support for AWS OpsWorks
  • Improved docs
  • Various performance improvements
  • Various bug fixes

2.0.0 (20-03-2014)

1.0.1 (17-09-2013)

  • Fixed bug in switching between API versions which may have caused the agent to not be installed and strange output in logs.

1.0.0 (26-07-2013)

  • Initial release with v1 and v2 API support.

Collaborator Number Metric

3.2.7 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

3.2.7 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Foodcritic Metric

3.2.7 passed this metric

No Binaries Metric

3.2.7 passed this metric

Testing File Metric

3.2.7 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

3.2.7 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must include a tag that matches this cookbook version number