Description

Installs and configures the Tracelytics daemon. Optionally, will install and configure other instrumentation (e.g. Apache, Python, etc.).

Requirements

Tracelytics

Go to Tracelytics and create an account. An access key, which is provided by Tracelytics, will be required.

Platform

• Debian, Ubuntu

Tested on Ubuntu 10.04.3 LTS (Lucid) and 12.04.1 LTS (Precise).

• CentOS, RHEL, and Fedora

Tested on CentOS 6. RHEL and Fedora are not currently tested but should work with the same components as CentOS.

Cookbooks

• apt is only required if you are on a Debian-like system.
• apache2 is only required if you are using the tracelytics::apache recipe.
• python is only required if you are using the tracelytics::python recipe.
• yum is only required if you are on a Red Hat-like system.

Attributes

default

• node['tracelytics']['access_key'] required Your Tracelytics access key.

apache

• node['tracelytics']['apache']['appname'] optional Tracelytics Apache layer application name
• node['tracelytics']['apache']['trace_mode'] optional Sets when traces should be initiated. Valid values are always, through, and never. Defaults to always. More
• node['tracelytics']['apache']['sampling_rate'] optional The number of requests out of every million that will be traced. Defaults to 300000. More

php

• node['tracelytics']['php']['appname'] optional Tracelytics PHP layer application name
• node['tracelytics']['php']['tracing'] optional Sets when traces should be initiated. Valid values are always, through, and never. Defaults to through. More
• node['tracelytics']['php']['sample_rate'] optional The number of requests out of every million that will be traced. Defaults to 300000. More
• node['tracelytics']['php']['enable_sanitize_sql'] optional Enable or disable sanitizing SQL query traces. Disabled by default. More
• node['tracelytics']['php']['enable_wrap_error_log'] optional By setting this value to 0, you will prevent error_log messages from showing up on our Errors page, improving the signal-to-noise ratio. Default is 1 (ie. enabled). More

Recipes

default

Includes the tracelytics::apt recipe, configures your /etc/tracelytics.conf, and installs the liboboe0, liboboe-dev, tracelyzer packages.

apache

Installs libapache2-mod-oboe and configures your /etc/apache2/mods-available/oboe.conf.

Requires the apache2 cookbook (not a dependency of this cookbook).

php

Installs php-oboe and configures /etc/php5/conf.d/oboe.ini.

apt

Configures the Tracelytics repository and installs their packaging key for apt based systems.

python

Uses pip to install the oboe Python package.

Requires the python cookbook (not a dependency of this cookbook).

mysql

NOTE: This recipe is currently not working. It is recommended you build the package manually and add it to your own apt repository. Downloads the MySQL client library patch from Tracelytics and builds a Debian package with the modified source. Installs the package after a successful build, but will not run again after the initial build.

yum

Configures the tracelytics repository and installs the packaging key for yum based systems.