README.md

Installation of Sumo Logic Distribution for OpenTelemetry Collector with Puppet

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

Configuration

• Prepare configuration for Sumo Logic Distribution for OpenTelemetry Collector and save it in files directory for instal_otel_collector module as config.yaml.

• If needed modify variables in modules/install_otel_collector/manifests/init.pp:

  class install_otel_collector {
     $otel_collector_version = "0.50.0-sumo-0" # version of Sumo Logic Distribution for OpenTelemetry Collector
     $systemd_service = false                  # enables creation of Systemd Service for Sumo Logic Distribution for OpenTelemetry Collector
  
  ...
  }

• Adjust settings for Systemd Service in system_service when it needs to be created.

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 using steps described in Configuration

• 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:

  cat /var/log/otelcol.log