cloud-native-app

The goal of this project is to implement a Spring Boot application, called movies-api, and use Filebeat & ELK Stack (Elasticsearch, Logstash and Kibana) to collect and visualize application's logs and Prometheus & Grafana to monitor application's metrics.

Application

movies-api

Spring Boot Web Java application that exposes a REST API for managing jobs. Its endpoints are displayed in the picture below.

Prerequisites

Start Environment

Open a terminal and inside springboot-elk-prometheus-grafana root folder run
```
docker-compose up -d
```
Wait a bit until containers be Up (healthy) (except filebeat). In order to check it run
```
docker-compose ps
```

Running application

Development Mode

Open a terminal and make sure you are inside springboot-elk-prometheus-grafana folder

Run the following command

./mvnw clean spring-boot:run --projects movies-api

Note: If you want to change to "non-json-logs" (maybe during development it's useful), run
./mvnw clean spring-boot:run --projects movies-api -Dspring-boot.run.jvmArguments="-Dspring.profiles.active=non-json-logs"

Docker in JVM Mode

In a terminal, make sure you are inside springboot-elk-prometheus-grafana root folder

Run the following command to build the image

./mvnw clean compile jib:dockerBuild --projects movies-api

Finally, run the container

docker run -d --rm --name movies-api \
  -p 8080:8080 -e MYSQL_HOST=mysql \
  --network=springboot-elk-prometheus-grafana_default \
  docker.mycompany.com/movies-api:1.0.0

Application & Services URLs

movies-api

movies-api Swagger is http://localhost:8080/swagger-ui.html
Prometheus

Prometheus can be accessed at http://localhost:9090
Grafana

Grafana can be accessed at http://localhost:3000

In order to login, type admin for both username and password
Kibana

Kibana can be accessed at http://localhost:5601

Configuration
- Access Kibana website
- Click on Explore on my own
- In the main page, click on "burger" menu icon and then on Discover
- Click on Create index pattern button
- In the Index pattern field, set filebeat-* and click on > Next Step button
- In the Time field combo-box, select @Timestamp and click on Create index pattern
- Click on "burger" menu icon again and then on Discover to start performing searches

Elasticsearch

Elasticsearch URL is http://localhost:9200

Useful queries

# Check ES is up and running
curl localhost:9200

# Check indexes in ES
curl "localhost:9200/_cat/indices?v"

# Check filebeat index mapping
curl "localhost:9200/filebeat-*/_mapping"

# Simple search
curl "localhost:9200/filebeat-*/_search?pretty"

Shutdown

Stop application
- If the application was started with Maven, go to the terminals where it is running and press Ctrl+C
- If the application was started as a Docker container, run the command below
```
docker stop movies-api
```
To stop and remove docker-compose containers, networks and volumes, make sure you are in springboot-elk-prometheus-grafana root folder and run
```
docker-compose down -v
```

allenphilip93 / cloud-native-app

cloud-native-app

Application

movies-api