Moving Objects Service

---

---

Technologies used

Please check the TechStack.md file for details.

Introduction

The goal of this mini-project is to introduce you to three important monitoring tools and data stores used in the software landscape. These are prometheus, grafana and influxDB. In this project you will find implementations using micrometer and a store for metrics. These modules have been implemented in a Reactive way with WebFlux and the Front End is implemented with Angular Materials.

This project is also the official support project of my article on medium:

Stable releases

• 1.0.0 - 8af14c9c60c9275cac1814238b9c9b0a73a427f2

Setup

In order to run this project we need to fulfill some requirements:

1. Have an IDE
2. Have JDK17 installed (Details on how to do that in this manual)
3. Have Docker desktop installed or just use a Linux machine with docker-compose.

MAC-OS Installation

brew upgrade gradle
sdk install java 17-open
sdk use java 17-open
sdk install gradle 7.3.3

How to run

Open Version

make dcup-full-action

Secure version

Does not work with Cypress, and it needs to be configured. Check the Okta manual of this project for more details.

export REDIRECT_PORT=8080
make dcup-full-action-secure

Full Demo

These Cypress tests not only perform tests, but they also generate token files necessary to allow Telegraf to access InfluxDB. These are:

1. docker-files/telegraf/.env
2. docker-files/telegraf/token

The full demo Makefile script ensures that:

1. The services start
2. Cypress tests run
3. Telegraf runs on a separate container

It can take anything between 5 and 10 minutes to get all the containers going, but then you'll get:

1. Working InfluxDB scrappers: Pull from prometheus endpoints directly to InfluxDB
2. Working Telegraf scrappers: Pull from prometheus and pushes data to Influx DB

Run Cypress

Against Nginx

make cypress-open-docker

Directly against the service ports

make cypress-open

Endpoint list

Direct

• Actuator

• Actuator Trace Requests

• All Requests

• Ok Requests 200

• Ok Requests 400

• Ok Requests 500

• Grafana Login

• Prometheus

• Influx DB Onboarding

• Objects API Swagger UI - /objects/v3/api-docs

• Prometheus for JWT REST

• Prometheus for Okta REST

• Prometheus for NGINX

• Trace for JWT REST

Via NGINX

• Actuator

• Actuator Trace Requests

• All Requests

• Ok Requests 200

• Ok Requests 400

• Ok Requests 500

• Objects API Swagger UI - /objects/v3/api-docs

• Prometheus for JWT REST

• Prometheus for Okta REST

• Prometheus for NGINX

• Trace for JWT REST

Over Actuator

• Actuator Updates for Spring Boot 2

References

• Micrometer Prometheus
• How to Configure an OAuth2 Authentication With Spring Security (Part 1)
• Grafana Installing using Docker
• Prometheus.IO
• Prometheus parameter examples
• Travel Web Cams
• Airport Finder
• RapidAPI
• Postman OAuth 2.0
• How do you rename a Git tag?
• The 10 Best Software Engineering Books in 2019
• Using Prometheus with InfluxDB for metrics storage
• Data exploration using InfluxQL
• Monitoring nginx with Prometheus and Grafana by Dimitri

About me