This cookbook installs and configures the Zipkin distributed tracing system.

Chef 12+

This cookbook uses Test Kitchen to do cross-platform convergence and post-convergence tests. The tested platforms are considered supported. This cookbook may work on other platforms or platform versions with or without modification.

• Ubuntu 12.04, 14.04

Note that Upstart is the only supported init system currently.

This cookbook does not depend on any other cookbooks but Java is required to to run Zipkin. Therefore, the java cookbook is recommended.

Attributes have default values set in attributes/default.rb. Configuration for the various Zipkin components (collector, storage, etc.) is done entirely via environment variables. In an effort to support a flexible configuration pattern the node['zipkin']['env_vars'] hash is provided. Configuration key-value pairs should be placed in here and they will be exported as environment variables in the startup script. This hash is intended to be one level deep and the keys will be uppercased and exported.

For instance, given the following attribute configuration:

default['zipkin']['env_vars']['query_port'] = 8080
default['zipkin']['env_vars']['storage_type'] = 'mysql'
default['zipkin']['env_vars']['mysql_user'] = 'buster'
default['zipkin']['env_vars']['mysql_pass'] = 'motherboy'
default['zipkin']['env_vars']['mysql_use_ssl'] = true
default['zipkin']['env_vars']['zipkin_ui_environment'] = 'qa'

Will produce the following values in the init script:

export QUERY_PORT="8080"
export STORAGE_TYPE="mysql"
export MYSQL_USER="buster"
export MYSQL_PASS="motherboy"
export MYSQL_USE_SSL="true"
export ZIPKIN_UI_ENVIRONMENT="qa"

General attributes:

• node['zipkin']['version']: Version to install.
• node['zipkin']['maven_base_url']: Maven repository to fetch artifacts from. Defaults to https://repo1.maven.org/maven2
• node['zipkin']['install_dir']: Where to install the application. Defaults to /opt/zipkin.
• node['zipkin']['manage_user']: Should we create the user and group?
• node['zipkin']['user']: User to run the daemon as. Defaults to zipkin.
• node['zipkin']['group']: Group to run the daemon as. Defaults to zipkin.
• node['zipkin']['uid']: User ID for the Zipkin user.
• node['zipkin']['gid']: Group ID for the Zipkin group.

Configures the system, installs the JARs, and generates the Upstart configuration.

Fetches the relevant JARs from Maven Central and drops them into the configured installation directory.

Performs required system configuration such as creating the required user and group with which to run Zipkin.

Simply set your attributes and include the zipkin::default recipe.

Author:: Rich Schumacher

Copyright:: 2016-2017, Curalate, Inc.

Released under the MIT License.