https://github.com/ololx/spring-boot-metrics-instances
This project presents instances of how to collect and display statistics on the use of micro-services and their logs, as well as distributed request tracing.
https://github.com/ololx/spring-boot-metrics-instances
example-project grafana-example grafana-sample loki-example loki-sample prometheus-example prometheus-sample promtail-example promtail-sample sample-project spring-boot-example spring-boot-metrics-example spring-boot-metrics-sample spring-boot-sample
Last synced: 3 months ago
JSON representation
This project presents instances of how to collect and display statistics on the use of micro-services and their logs, as well as distributed request tracing.
- Host: GitHub
- URL: https://github.com/ololx/spring-boot-metrics-instances
- Owner: ololx
- License: unlicense
- Created: 2021-07-03T05:19:55.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-08-23T17:13:15.000Z (about 4 years ago)
- Last Synced: 2025-06-11T03:35:17.159Z (4 months ago)
- Topics: example-project, grafana-example, grafana-sample, loki-example, loki-sample, prometheus-example, prometheus-sample, promtail-example, promtail-sample, sample-project, spring-boot-example, spring-boot-metrics-example, spring-boot-metrics-sample, spring-boot-sample
- Language: Java
- Homepage:
- Size: 253 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# spring-boot-metrics-instances
This project presents instances of how to collect and display statistics on the use of micro-services and their logs, as well as distributed request tracing.
[](BADGES_GUIDE.md#status) [](BADGES_GUIDE.md#commit-date)
[](LICENSE)
---
[](#built-with) [](#built-with) [](#built-with)
[](#built-with)
[](#built-with)
[](#built-with) [](#built-with) [](#built-with) [](#built-with) [](#built-with)
[](#built-with)
## đ Table of Contents
- [About](#about)
- [Features](#feature)
- [Getting Started](#getting-started)
- [Built With](#built-with)
- [Authors](#authors)
- [Licensing](#licensing)
## đ About
This is a collection of small and focused instances, each of which covers a single and defined approach to Java application development and an required technologies implementation. This project presents instances of how to collect and display statistics on the use of micro-services and their logs, as well as distributed request tracing. A strong focus of these instances is the different cases of the `micro-services distributed tracing`, `micro-services logs collecting` and `analytics and interactive visualization web application` realizations.
## đ Features
The project with instances of:
- the `micro-services distributed tracing` technology implementation via `Jaeger`
- the `micro-services logs collecting` technology implementation via `loki` & `promtail`
- the `analytics and interactive visualization web application` technology implementation via `Graphana` & `Prometheus`
### Changelog
- For more information on a releases, a features and a changes, please read the [changelog](CHANGELOG.md) notes.
## đĻ Getting Started
These instructions allow to get a copy of this project and run it on a local machine.
### Prerequisites
Before using it, make sure that follows software are installed on the local machine:
- **Docker Compose** - tool for defining and running multi-container `Docker` applications.
If any of the listed software is not installed, then it can be installed by instruction as described below.
#### Docker Compose
- Install Docker Compose according to instructions from an [official](https://docs.docker.com/compose/install/) source.
### Installing
In order to install it is quite simple to clone or download this repository.
### Cloning
For the cloning this repository to a local machine, just use the follows link:
```http
https://github.com/ololx/spring-boot-metrics-instances
```
### Using
To run and try out each instance is required to:
1. Launch containers with services
To do the launching some incstance, go to the instance directory and execute the following command:
```bash
docker-compose up --build
```
2. Open sevices GUI
When all services will start, you could open your browser and go to the services endpoints:
- Graphana endpont (user `admin`, password `admin`):
```http
http://localhost:3000/
```
- Jaeger endpont:
```http
http://localhost:16686/
```
- Prometheus endpont:
```http
http://localhost:9090/
```
- PostgreSQL Exporter endpont:
```http
http://localhost:9187/
```
- Some Api Client endpoint (with specs):
```http
http://localhost:8082/swagger-ui.html
```
- Some Api endpoint (with specs):
```http
http://localhost:8081/swagger-ui.html
```
3. [OPTIONAL] Send requests to instance service. Because the `some-api-executing` ervice will do the requests to `some-api-client` automatically every 30 seconds.
### Launching
To do the launching some incstance, go to the instance directory and execute the following command:
```bash
docker-compose up --build
```
## đ Built With
- **JDK** - the java development kit;
- **Maven** - the dependency management;
- **PostgreSQL 10.6** - the database management system;
- **Swagger** - documentation and form generator;
- **Docker Compose** - tool for defining and running multi-container `Docker` applications.
## Šī¸ Authors
* **Alexander A. Kropotin** - *Initial work* - [ololx](https://github.com/ololx).
## đ Licensing
This project is unlicensed - see the [lisence](LICENSE) document for details.