Skip to content

kobybr/puppet-apmserver

Repository files navigation

Elastic APM server

Build Status Puppet Forge Puppet Forge Downloads Puppet Forge Score Puppet Forge Endorsement GitHub last commit

Usage

To install and manage the apm-server with all default settings:

include '::apmserver'

To install and manage the apm-server with custom settings:

$apmserver_config_custom = {
  'apm-server' => { 'host' => "${::ipaddress}:8200" },
  'output.elasticsearch' => {
    'hosts' => [ '192.168.1.1:9200', '192.168.1.2:9200' ],
    'enabled' => true,
  },
}

class {'::apmserver':
  apmserver_config_custom => $apmserver_config_custom,
}

Example hiera YAML file:

---
apmserver::custom_config:
  apm-server:
    host: 10.1.1.1:8200
  output.elasticsearch:
    hosts:
    - 192.168.1.1:9200
    - 192.168.1.2:9200
    enabled: true
class {'::apmserver':
  apmserver_config_custom => hiera_hash('apmserver::custom_config', {}),
}

Module Parameters

manage_repo Enable repo management by enabling official Elastic repositories.

repo_version The version to be used with elastic_stack for setting repository version.

merge_default_config Merge config settings from the apm-server.yml file provided in the rpm. Default: true

package_ensure Control if the managed package shall be present or absent

package_version To set the specific version you want to install (ex. 6.5.4). Default: latest

package_name Name of the package to install. Default: apm-server

package_config_path Path to the directory in which to install configuration files. Default: '/etc/apm-server'

service_ensure Whether the service should be running. Default: running

service_enable Whether the service should be enabled to start at boot. Default: true

service_name Name of service to manage. Default: apm-server

apmserver_config_custom Custom configuration settings. Default: {}

apmserver_default_config_file Full path to the packages default configuration file. Default: undef

config_owner Parameter to set the owner of the configuration file. Default: undef

config_group Parameter to set the group of the configuration file. Default: undef