Deploy a sample application to test the AWS Distro for OpenTelemetry Collector

The sample application will generate and send OTLP data to a single OTLP receiver endpoint. You can utilize a self managed ADOT Collector deployment or leverage the otlpIngest preconfigured custom resource that is available through the ADOT EKS Add-on advanced configuration.

The sample application and traffic generator were largely taken from an example in the ADOT Collector repository. A docker-compose.yaml file was translated to Kubernetes resources using the Kompose tool.

To apply the traffic generator and sample application, do the following steps. Make sure that you have satisfied the prerequisites and completed the procedure in Install the AWS Distro for OpenTelemetry (ADOT) Operator.

1. Download the traffic-generator.yaml file to your computer. You can also view the file on GitHub.

   Copy
   curl -O https://raw.githubusercontent.com/aws-observability/aws-otel-community/master/sample-configs/traffic-generator.yaml

2. In traffic-generator.yaml, make sure that the second kind value reflects your mode. For more information, see Deploy the ADOT Collector on GitHub.

   Copy
   kind: Deployment

   traffic-generator.yaml makes http calls to the Kubernetes service sample-app:4567. This allows the traffic generator to interact with the sample application on port 4567. sample-app resolves to the IP address of the sample-app Pod.

3. Apply traffic-generator.yaml to your cluster.

   Copy
   kubectl apply -f traffic-generator.yaml

4. Download the sample-app.yaml file to your computer. You can also view the file on GitHub.

   Copy
   curl -O https://raw.githubusercontent.com/aws-observability/aws-otel-community/master/sample-configs/sample-app.yaml

5. In sample-app.yaml, replace the following with your own AWS Region:

   Copy
   value: "<YOUR_AWS_REGION>"

   The following actions are defined by sample-app.yaml:

   • The Service resource configures port: 4567 to allow HTTP requests for the traffic generator.
   • The Deployment resource configures some environment variables:
     • The LISTEN_ADDRESS is configured to 0.0.0.0:4567 for HTTP requests from the traffic generator.
     • The OTEL_EXPORTER_OTLP_ENDPOINT which controls the destination of OTLP telemetry signals generated by the sample application.

6. In sample-app.yaml, update the value for OTEL_EXPORTER_OTLP_ENDPOINT to direct traffic to the otlp receiver in your ADOT Collector.

   If you are using the otlpIngest preconfigured custom resource change the value to http://adot-col-otlp-ingest-collector:4317.

7. Apply sample-app.yaml to your cluster.

   Copy
   kubectl apply -f sample-app.yaml