honeytail

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

Sean Hood

seanhood

464 downloads

464 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

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'
    }
  }
}