Monitoring Support Runbook
Version 1.6.9-option-3 | Updated: August 07, 2026
Monitoring Exporters and Grafana Installation Guide
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.mdfor capacity planning)
Documentation:
-
Architecture Overview - Diagrams, server types, and port reference
-
Sizing Guide - Capacity planning for Prometheus/Grafana