Friendly System Metrics

1. Introduction

FT System Metrics is a metrics collection and aggregation service for the Friendly Technologies platform. It connects to the FTACS database in read-only mode, aggregates CPE device, task, and event statistics, and exports metrics in Prometheus format (designated for Business metrics dashboard).

1.1. Business Purpose

The service provides observability for the FTACS platform:

  • Device monitoring — total device count, online/offline status by protocol and tenant

  • Task monitoring — task distribution by status (Pending, Completed, Failed, Rejected, Sent) and by type

  • Event monitoring — CPE event distribution by type for the previous hour

  • Multi-tenancy — all metrics are tagged with the tenant (ISP) name

1.2. Technology Stack

Component Details

Language

Java 25

Framework

Spring Boot 4.0.0

Build Tool

Maven 4.0.0

Metrics

Micrometer + Prometheus Registry

Database

MySQL 8.0+ / Oracle 21c+

Monitoring Stack

Prometheus + Grafana

Container Runtime

Docker / Docker Compose

1.3. Project Goals

  1. Provide a Prometheus-compatible endpoint with FTACS metrics

  2. Support both MySQL and Oracle as data sources

  3. Ensure multi-tenant tagging for all metrics

  4. Minimize resource consumption using Java 25 virtual threads

2. Documentation

Section Description

Installation & Deployment

System requirements, Docker image, environment configuration, deployment, and updates

Architecture Overview

System context, component architecture, request flow, multi-database strategy

Configuration Guide

Application YAML, environment variables, Spring profiles, connection pool, Prometheus configuration

Database

Database schema, repositories, projections, multi-database query strategy

Metrics & Monitoring

Metrics collectors, metrics reference, Prometheus and Grafana integration