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 a hekad service.

hekad::journald

configures heka to listen for journald syslog forwarding.

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, 'pid_file' => '/var/run/hekad.pid'}</code></td>
</tr>
</tbody>
</table>

Resources

heka_config

Heka configuration, maps to a file under /etc/heka.

<table>
<thead>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default Value</th>
</tr>
</thead>
<tbody>
<tr>
<td>path</td>
<td>
Filesystem location for the rendered config template.
</td>
<td><code>/etc/heka/$name.toml</code></td>
</tr>
<tr>
<td>config</td>
<td>
ruby Hash that will be toml-encoded and written to /etc/heka/$name.toml
</td>
<td><code>{}</code></td>
</tr>
</tbody>
</table>