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>