Skip to content

Latest commit

 

History

History
59 lines (48 loc) · 2.52 KB

debian-deb-demo.md

File metadata and controls

59 lines (48 loc) · 2.52 KB
Raw

Run AWSOTelCollector Beta on Debian and Ubuntu

To run AWSOTelCollector on Debian (or Ubuntu) EC2 host, you can choose to install AWSOTelCollector 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 AWSOTelCollector in directory /opt/aws/aws-otel-collector/

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

    • Start AWSOTelCollector 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 AWSOTelCollector when finish the testing.
        sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl  -a stop
    • Check the status of AWSOTelCollector
        sudo /opt/aws/aws-otel-collector/bin/aws-otel-collector-ctl  -a status

  3. Test the data with the running AWSOTelCollector 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=AWSOTelCollectorRPMDemo,service.name=AWSOTelCollectorRPMDemoService" -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