Skip to content

Latest commit

 

History

History
90 lines (63 loc) · 3.16 KB

README.md

File metadata and controls

90 lines (63 loc) · 3.16 KB

Installation of Sumo Logic Distribution for OpenTelemetry Collector with Puppet

This Puppet manifest along with module will install Sumo Logic Distro of OpenTelemetry Collector.

Using the module

  • Get an install token from Sumo Logic

  • Prepare configuration file for Sumo Logic Distribution for OpenTelemetry Collector and put the file in a directory of your choice. You can put multiple configuration files in this directory, and all of them will be used.

    NOTE: The playbook will prepare a base configuration for you, and configure the extension as well.

  • Modify properties in manifests/install_otel_collector.pp:

    class install_otel_collector {
   $install_token => "<your_token>"
   $collector_tags => {"key" => "value"}
   src_config_path => <your_config_path>
}

  • Apply the changes to your environment. In local mode, run:

    puppet apply

Properties

  • install_token: Sumo Logic install token, rel: install_token
  • collector_tags: Collector tags, these are applied to all processed data
  • api_url: Sumo Logic API url. You shouldn't need to set this in most normal circumstances.
  • version: version of Sumo Logic Distribution for OpenTelemetry Collector
  • systemd_service: enables creation of Systemd Service for Sumo Logic Distribution for OpenTelemetry Collector. Enabled by default. Note that this recipe will not start the collector if you disable this.
  • src_config_path: path to configuration directory for Sumo Logic Distribution for OpenTelemetry Collector

Test on Vagrant

Puppet server and Puppet agent are installed on single host in Vagrant environment.

Example Puppet manifest and module are mounted to Vagrant virtual machine:

  • modules/ is mounted to /etc/puppetlabs/code/environments/production/modules/
  • manifests/ is mounted to /etc/puppetlabs/code/environments/production/manifests/

To install Sumo Logic Distribution for OpenTelemetry Collector with Puppet on Vagrant virtual machine:

  • Prepare configuration as outlined in Using the module

  • From main directory of this repository start virtual machine:

    vagrant up

  • Connect to virtual machine:

    vagrant ssh

  • Pull configuration for Puppet agent:

    sudo puppet agent --test --waitforcert 60

  • In another terminal window for Vagrant virtual machine, sign the certificate:

    sudo puppetserver ca sign --certname agent

  • See that Puppet agent pulls configuration from Puppet server.

  • Verify installation:

    sudo ps aux | grep otelcol-sumo

  • Verify logs:

    sudo journalctl -u otelcol-sumo