aternity/apm-collector repository overview

⁠APM Collector

Collect and analyze OpenTelemetry, Jaeger, and Zipkin trace data in Aternity APM.

⁠What is Aternity APM?

Aternity Application Performance Monitoring (APM) is a highly-scalable SaaS product for collecting and analyzing OpenTelemetry tracing data. Aternity APM delivers a ready-built SaaS analysis backend that allows you to collect, store, and analyze every single span without sampling. With simple, flexible rules for aggregating span data, Aternity APM allows you to find and resolve performance bottlenecks and errors in your application across the billions of user requests that your application is handling every day.

⁠Getting Started

To deploy the APM collector, you will need to follow these steps:

1. If you do not already have an Aternity APM SaaS account, sign up for a free trial

2. In the Aternity APM UI, go to the Agents > Install Agents screen and copy the customer id (e.g., 1-2-3-4) and SaaS agent URL (e.g., agents.apm.my.aternity.com)

3. Use the following command (substituting in your SaaS environment and company ID in the places indicated by < >) to download and run the collector:

The APM collector is now running and ready to accept spans from OpenTelemetry, Jaeger, and Zipkin.

⁠Usage

⁠Environment Variables

• SERVER_URL - The full url for the SaaS environment and company ID to send span data. (E.g., -e SERVER_URL=wss://agents.apm.my.aternity.com/?RPM_AGENT_CUSTOMER_ID=1-2-3-4)

• MGR_DEBUG - Write debug log info to stdout/logs (e.g., -e MGR_DEBUG=true)

• SECURE_TOKEN - token to use if Secure Agent Mode is enabled (eg -e SECURE_TOKEN=cafebabe-2395-4982-99ea-d807deadbeef )

⁠Ports

• 6831/udp - Jaeger Thrift compact
• 6832/udp - Jaeger Thrift Binary
• 9411/tcp - Zipkin v2 json/protobuf and v1 json/thrift
• 14268/tcp - Jaeger Thrift Binary over HTTP
• 5775/udp - Jaeger's Thrift support for Zipkin v1
• 55681/tcp - OpenTelemetry OTLP JSON/Protobuf over HTTP
• 4318/tcp - OpenTelemetry OTLP JSON/Protobuf over HTTP
• 4317/tcp - OpenTelemetry OTLP over gRPC

⁠License Data

• /3rdPartyLicenses/* - Licenses for 3rd party libraries included in the APM collector

⁠Find Us

• Aternity⁠