Instana NGINX Tracing Demo
This repository contains a technology preview for Instana's NGINX tracing functionality.
Instana NGINX tracing is currently a technology preview. Any use of this technical preview, especially in production, is not supported!
We reserve ourselves the right to make it better and easier before releasing the functionality for General Availability.
docker-compose installation running on your machine. This demo has been created and tested on Mac OS X with
.env file in the root of the checked-out version of this repository and enter the following text, with the values adjusted as necessary:
agent_key=<TODO FILL UP> agent_endpoint=<local ip or remote host; e.g., saas-us-west-2.instana.io> agent_endpoint_port=<443 already set as default; or 4443 for local> agent_zone=<name of the zone for the agent; default: envoy-tracing-demo>
pushd client-app ./mvnw clean package popd pushd server-app ./mvnw clean package popd docker-compose build
This will build and launch
client-appservice, a simple Spring Boot application that issues a request every second to the ...
nginxservice, which routes all incoming requests to the ...
server-appservice, a simple Spring Boot application that returns
200to any HTTP request.
After the agent is bootstrapped and starts accepting spans from NGINX, the resulting traces in the Analyze view will look like the following:
Naturally, all the other NGINX capabilities of Instana will work out of the box as well ;-)
Setup an Application Perspective for the Demo
The simplest way is just to assign to the agent a unique zone (the
docker-compose.yml file comes with the pre-defined
nginx-tracing-demo zone), and simply create the application to contain all calls with the
agent.zone tag to have the value