hekad cookbook

A Chef cookbook for installing & configuring Mozilla Heka.

Recipes

hekad::default

Includes the install, configure, and service recipes.

hekad::install

Downloads the configured release, and installs it.

hekad::configure

Creates the configuration template directory, and installs the heka_config[hekad] resource, with hekas global configuration.

See attributes documentation about how to set global configuration.

hekad::service

Installs and configures the hekad service.

Attributes

Attributes are namespaced under default['heka'].

<table> <thead> <tr> <th>Attribute</th> <th>Description</th> <th>Default Value</th> </tr> </thead> <tbody> <tr> <td>release_url</td> <td> base url for download path </td> <td><code>https://github.com/mozilla-services/heka/releases/download</code></td> </tr> <tr> <td>version</td> <td> heka release version </td> <td><code>0.8.3</code></td> </tr> <tr> <td>tag</td> <td> heka release tag </td> <td><code>v0.8.3</code></td> </tr> <tr> <td>package</td> <td> heka release package </td> <td><code>heka-0_8_3-linux-amd64.rpm or heka_0.8.3_amd64.deb</code></td> </tr> <tr> <td>config</td> <td> heka global configuration (Hash) </td> <td><code>{'maxprocs' => 2}</code></td> </tr> </tbody> </table>

Resources

heka_config

Heka configuration template.

Templates are placed at /etc/heka/$name.toml, are pulled from the cookbook defining the resource, and are expected to be located in the cookbook at a default of templates/default/heka/$name.toml.erb.

<table> <thead> <tr> <th>Attribute</th> <th>Description</th> <th>Default Value</th> </tr> </thead> <tbody> <tr> <td>cookbook</td> <td> String naming the cookbook containing the template. </td> <td><code>nil</code></td> </tr> <tr> <td>path</td> <td> Filesystem location for the rendered config template. </td> <td><code>/etc/heka/$name.toml</code></td> </tr> <tr> <td>source</td> <td> template source </td> <td><code>heka/$name.toml.erb</code></td> </tr> <tr> <td>variables</td> <td> variables Hash to pass to the source template </td> <td><code>{}</code></td> </tr> </tbody> </table>