Run ADOTCollector Beta on Debian and Ubuntu

To run ADOTCollector on Debian (or Ubuntu) EC2 host, you can choose to install ADOTCollector on your host by the following steps.

Steps,

  1. Login on Debian EC2 host and download aws-otel-collector installation file.
wget https://aws-otel-collector.s3.amazonaws.com/ubuntu/amd64/latest/aws-otel-collector.deb
  1. (Optional) Verify the package integrity.
wget https://aws-otel-collector.s3.amazonaws.com/aws-otel-collector.gpg
gpg --import aws-otel-collector.gpg
sudo apt install dpkg-sig
dpkg-sig --verify aws-otel-collector.deb

If the package is verified, you should see output similar to this:

GOODSIG _gpgorigin XXXXX...

However, if you see BADSIG or UNKNOWNSIG, you should stop and try download the deb package from the offical source again.

  1. Install aws-otel-collector DEB by the following command on the host
sudo dpkg -i -E ./aws-otel-collector.deb
  1. Once DEB is installed, it will create ADOTCollector in directory /opt/aws/aws-otel-collector/

  2. We provided a control script to manage ADOTCollector. Customer can use it to Start, Stop and Check Status of ADOTCollector.

    • Start ADOTCollector with CTL script. The config.yaml is optional, if it is not provided the default config will be applied.
        sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl -c </path/config.yaml> -a start
    
    • Stop the running ADOTCollector when finish the testing.
        sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl  -a stop
    
    • Check the status of ADOTCollector
        sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl  -a status
    
  3. Test the data with the running ADOTCollector on EC2. you can run the following command on EC2 host. (Docker app has to be pre-installed)

docker run --rm -it --network host -e "OTEL_EXPORTER_OTLP_ENDPOINT=127.0.0.1:4317" -e "otlp_instance_id=test_insance_rpm" -e "OTEL_RESOURCE_ATTRIBUTES=service.namespace=ADOTCollectorRPMDemo,service.name=ADOTCollectorRPMDemoService" -e S3_REGION=us-west-2 aottestbed/aws-otel-collector-sample-app:java-0.1.0

enable debugging log

add a key value pair into /opt/aws/aws-otel-collector/etc/extracfg.txt and restart collector

echo "loggingLevel=DEBUG" | sudo tee -a /opt/aws/aws-otel-collector/etc/extracfg.txt
sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl -a stop
sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl -a start