AWS Open Distro for OpenTelemetry

Set up AWS Distro for OpenTelemetry Collector On-Premises

Set up AWS Distro for OpenTelemetry Collector On-Premises

In this tutorial, we will demonstrate installing AWS Distro for OpenTelemetry Collector (AWS OTel Collector) binaries for on-premises hosts. For supported platforms, see the AWS OTel Collector README on GitHub.




Install the AWS OTel Collector

  1. Set up the required AWS credential file.
  2. Logon your on-premise host and download AWS OTel Collector source code from AWS Observability GitHub Repository and build RPM file with the following command.
git clone https://github.com/aws-observability/aws-otel-collector.git
make package-rpm
  1. Install the AWS OTel Collector RPM by the following command on the host.
sudo rpm -Uvh ./aws-otel-collector.rpm
  1. After RPM is installed, it will create AWS OTel Collector in directory /opt/aws/aws-otel-collector/ with the following folder layout.

    Diagram
  2. After AWS OTel Collector is installed on the host, the following commands can be used to start, stop, and check the running status. a) Start AWS OTel Collector with CTL script. The config.yaml is optional; if it’s not provided, the default config is applied.

    sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl -c </path/config.yaml> -a start

    b) Stop AWS OTel Collector process

    sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl -a stop

    c) Check the status of AWS OTel Collector

    sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl -a status