This repository demonstrates Instana's Envoy Proxy tracing functionality based on OpenTelemetry.
The OTel traces are sent to the Instana agent OpenTelemetry plugin via gRPC to port 4317. It has to be enabled for this. This is the only supported scenario for now.
Envoy Proxy versions 1.30 until latest are supported by the distributed tracing based on OpenTelemetry.
For Envoy Proxy versions 1.15 until 1.29 use the old demonstration repository envoy-tracing based on OpenTracing.
A docker-compose installation running on your machine.
Create a .env file in the root of the checked-out version of this repository and enter the following content.
The values need to be adjusted to your environment.
agent_key=<agent secret key>
download_key=<download secret key (optional agent key with download privileges)>
agent_zone=<name of the zone for the agent; default: envoy-tracing-demo>
agent_endpoint=<local ip or remote host; e.g. ingress-red-saas.instana.io>
agent_endpoint_port=<443 already set as default; or 4443 for local>
In most scenarios only the field agent_key and agent_endpoint are required.
A template .env.template can be copied to .env for your convenience.
docker-compose down && docker-compose up --buildThis will build and launch the following components:
client-appservice, a simple Spring Boot application that issues a request every second to the ...envoyservice, which routes all incoming requests to the ...server-appservice, a simple Spring Boot application that returns200to any HTTP request.
After the agent is bootstrapped and starts accepting spans from Envoy, the resulting traces in the Analyze view will look like this:
