Takipi puppet module
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
manifests
spec
tests
.gitignore
CHANGELOG.md
README.md
Rakefile
metadata.json

README.md

takipi

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with takipi
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module
  8. Changelog

Overview

This module handles installation of JVM and Takipi agent.

Currently supports RPM and DEB-based Linux distributions.

Module Description

Takipi installs a daemon process and a JVM agent library on your servers. These two components work in tandem to log and send data to Takipi's analysis servers. Together they detect events (such as exceptions or logged errors) happening within your app and automatically create the code needed to log and collect the data you'll need to debug these errors in production.

Setup

What takipi affects

  • Installs Java on the node that Takipi is to be installed, handled by puppetlabs-java module. (optional)
  • Installs Takipi base package.
  • Adds the Takipi secret key (found under /opt/takipi/work/secret.key) and completes package installation.

Setup Requirements

Requires;

  • puppetlabs-stdlib (puppet module install puppetlabs-stdlib)
  • puppetlabs-java <= 1.3.0 (puppet module install puppetlabs-java --version 1.3.0)

Beginning with takipi

Create your account at https://app.takipi.com/account.html and get your secret key.

Usage

Basic usage:

copy the takipi module to the puppet modules path (for example /etc/puppet/modules/takipi)


include takipi
class {'::takipi':
  secret_key => 'YOUR_SECRET_KEY',
}

Takipi with specific Java version:

distribution, will define the type of environment JRE or JDK package, will represent the full packge name

class {'java':
  distribution          => 'jdk',
  package               => undef,
}

Takipi without external Java installation:

include takipi
class {'::takipi':
  manage_java => false,
  secret_key  => 'YOUR_SECRET_KEY',
}

Reference

Limitations

Does not handle extra functionality apart from installing Takipi.

Development

Pull requests are greatly appreciated, please keep proper indentation.

Beaker tests are awesome, feel free to throw some in.

Testing

Under tests/ there is a Vagrantfile that can be used to test Takipi module. Currently two boxes are added for tests, Centos 6.5 and Ubuntu 13.10 provided by Puppetlabs.

Make sure to add a valid secret key in tests/manifests/takipi.pp.

Usage:

vagrant up takipi_centos

vagrant up takipi_ubuntu

Changelog

0.4.0 @pmoust - Initial Release

0.5.0 - 2017-07-04

Added

  • Java Class variables
  • Config scripts to Vagrant folder
  • Testing the module against CentOS 7, Ubuntu Trusty, Ubuntu Xenial

Fixed

  • Java Class declaration
  • Support in verity of Distros
  • takipi configuration