Forge Home

honeytail

pdk
A Puppet module for managing Honeycomb.io's Honeytail

Sean Hood

seanhood

1,095 downloads

1,095 latest version

Version information

  • 0.1.0 (latest)
released Oct 19th 2020
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 7.0.0
  • CentOS
    ,
    RedHat
    ,
    Debian
    ,
    Ubuntu

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'seanhood-honeytail', '0.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add seanhood-honeytail
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install seanhood-honeytail --version 0.1.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

seanhood/honeytail — version 0.1.0 Oct 19th 2020

puppet-honeytail

This module installs and configures Honeycomb's honeytail. honeytail is an open source agent for ingesting data into Honeycomb and making it available for exploration.

Table of Contents

  1. Description
  2. Usage - Configuration options and additional functionality
  3. Limitations - OS compatibility, etc.

Description

This module uses a feature of systemd to trivially run multiple instances of honeytail with different configuration. This allows you to ingest application and web server logs residing on the same machine.

Usage

This example below shows the configuration required to collect logs from MySQL/MariaDB. Note: There is some configuration required inside of MySQL to get the most out of Honeycomb. Refer to the honeytail docs for this information: https://docs.honeycomb.io/getting-data-in/integrations/databases/mysql/logs/

class {'honeytail':
  direct_download => 'https://honeycomb.io/download/honeytail/linux/honeytail-1.762-1.x86_64.rpm'
}

honeytail::instance {'mysql':
  config => {
    'Required Options' => {
      'ParserName' => 'mysql',
      'WriteKey'   => 'REDACTED',
      'LogFiles'   => '/var/lib/mysql/slow-query.log',
      'Dataset'    => 'mysql'
    }
  }
}