Skip to content

README.md

Latest commit

 

History

History
86 lines (55 loc) · 3.92 KB

README.md

File metadata and controls

86 lines (55 loc) · 3.92 KB

Native Quarkus telemetry on Azure

This project contains 2 services implemented with Quarkus using que Quarkiverse OpenTelemetry Exporter for Azure, for demonstration purposes. quarkus-telemetry-vegetableand quarkus-telemetry-superhero.

The quarkus-telemetry-vegetable is a CRUD application for Vegetables and each time you create a veggie in there, a REST request is dispatched to quarkus-telemetry-superhero where a veggie is transformed in a vegetable superhero :) .

This allows us to show tracing across multiple services.

Running the application in dev mode

You can run your application in dev mode that enables live coding using:

mvn compile quarkus:dev

In these projects it will automatically download and start a PostgreSQL DB.

NOTE: Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.

Using CodeSpaces, please make sure to add the Port 8080 for the vegetables or 8081 for superheros application in the PORTS section. Open the included Simple Browser by clicking on the Preview in Editor icon.

Screenshot Add Port and Open in Simple Browser

Packaging and running the application

The application can be packaged using:

mvn package

It produces the quarkus-run.jar file in the target/quarkus-app/ directory. Be aware that it’s not an über-jar as the dependencies are copied into the target/quarkus-app/lib/ directory.

The application is now runnable using java -jar target/quarkus-app/quarkus-run.jar.

If you want to build an über-jar, execute the following command:

mvn package -Dquarkus.package.type=uber-jar

The application, packaged as an über-jar, is now runnable using java -jar target/*-runner.jar.

Creating a native executable

You can create a native executable using:

mvn package -Dnative

Or, if you don't have GraalVM installed, you can run the native executable build in a container using:

mvn package -Dnative -Dquarkus.native.container-build=true

You can then execute your native executable with: ./target/<app name>-1.0.0-SNAPSHOT-runner

If you want to learn more about building native executables, please consult https://quarkus.io/guides/maven-tooling.

Enable the telemetry for GraalVM native

To configure the telemetry for GraalVM native, look at this page.

You can follow these instructions to create an Application Insights resource and get the connection string in the Azure portal.

Docker

You have docker files to deploy each of the Quarkus projects at /src/main/docker/:

A Dockerfile.multistage file is available build a docker image from a multistage dockerfile.

These commands can be executed to build and run the quarkus-telemetry-superhero service: Build on project root: docker build -f src/main/docker/Dockerfile.multistage --ulimit nofile=5000:5000 -t quarkus-telemetry-superhero . Run: docker run -i --rm -p 8081:8080 quarkus-telemetry-superhero

Docker compose

Each project has a docker compose allowing to start a PostgreSQL DB allong with a container using the previouslu built docker image:

Related Guides

  • OpenTelemetry (guide): Use OpenTelemetry to trace services
  • Quarkus Opentelemetry Exporter for Microsoft Azure (guide).