Monitoring Support Runbook

Version 1.6.9 | Updated: September 04, 2026

Monitoring Exporters and Grafana Installation Guide

Table of Contents

Introduction

This guide provides step-by-step instructions for setting up monitoring exporters and Grafana for observability across various servers. The setup includes Node Exporter, Process Exporter, cAdvisor, MySQL Exporter, Oracle DB Exporter, ClickHouse (native Prometheus endpoint), PostgreSQL Exporter, Nginx Exporter, Windows Exporter, JMX Exporter for WildFly/ACS, and a Prometheus-Grafana-Alertmanager stack deployment. Hazelcast is covered two ways: embedded-in-ACS via its native Prometheus endpoint (:9101, full MBean set), standalone/docker via the bundled jmx-hazelcast exporter (JMX :9110 → :9101), because the native endpoint of a standalone Hazelcast omits isClusterSafe and the Metrics_* MBeans the dashboard needs. FT UI Services (Angular UI backend, AI Agent, Device Network Service, APIs) expose native Spring Boot Actuator or FastAPI metrics endpoints. Alertmanager handles alert notifications via Email, Telegram, Slack, MS Teams, Webhooks, SMS, and SNMP. Following this guide will ensure proper monitoring, alerting, and visualization of system metrics, database performance, application health, and web service performance.

Recent Updates (DEV-524 - FT UI Services Monitoring):

  • ✅ Nginx Exporter for Angular UI (portals container)

  • ✅ ClickHouse metrics via native Prometheus endpoint (port 9363)

  • ✅ PostgreSQL Exporter for AI agent database

  • ✅ Native metrics from: ft-device-network, ai-agent, ui-backend

  • ✅ Native metrics from APIs: provision-api, northbound-api, service-api

  • ✅ New Grafana dashboard: FT UI Services (comprehensive monitoring for all components)

System Requirements

Minimum per exporter node:

  • OS: Ubuntu 20.04+, Debian 11+, CentOS 7+, Rocky Linux 8+

  • RAM: 2GB (4GB recommended)

  • Disk: 10GB free space

  • Network: Outbound internet access (for Docker image downloads)

Prometheus/Grafana server:

  • CPU: 4 vCPU

  • RAM: 16GB

  • Disk: 100GB+ (see sizing.md for capacity planning)

Documentation:

  • Architecture Overview — diagrams, server types, and port reference

  • Sizing Guide — capacity planning, with series counts measured on both deployments

  • Metrics Mapping — which exporter emits which name, and the canonical ft: names that let one dashboard read all three producers

  • SNMP Notifier Guide — NMS integration, OID tables, SNMPv3

  • Alertmanager API — querying alerts and managing silences

  • Docker + UFW — why Docker bypasses UFW and what to do about it. A Russian translation lives in the repository at docs/ufw-docker-firewall-guide-ru.md; the portal carries the English one.

  • Release Workflow — the agreed trunk-based model. The tooling still does version branches; see Development & Releases below for what actually happens today

tag 1.6.9 · commit a4c0a5e133c2cba0a8b461039e9634af33e3dd9b · page generated September 04, 2026