# nobio/nobmon architecture

> Architecture diagram of the GitHub repository nobio/nobmon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nobio/nobmon
- Repository: https://github.com/nobio/nobmon

## Overview

nobmon is a private, environment-configured monitoring service. Its entry point creates enabled output handlers, starts selected periodic monitors, and passes each monitor a handler list; monitors gather metrics and send data points to those handlers. The repository covers host, network, router, weather, smart-plug, and fuel-price monitoring, with InfluxDB, MQTT, and console outputs. Edges reflect the shown entry-point wiring and sampled calls; unsampled monitor implementations are included, but their collection and reporting links are not inferred.

Main entry points: [`index.js`](https://github.com/nobio/nobmon/blob/main/index.js) (Service entry), [`lib/handler/influxdb-handler.js`](https://github.com/nobio/nobmon/blob/main/lib/handler/influxdb-handler.js) (InfluxDB output), [`lib/handler/mqtt-handler.js`](https://github.com/nobio/nobmon/blob/main/lib/handler/mqtt-handler.js) (MQTT output), [`lib/handler/consolelog-handler.js`](https://github.com/nobio/nobmon/blob/main/lib/handler/consolelog-handler.js) (Console output)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime"]
  node_entry["Service entry<br/>[index.js]"]
end

subgraph group_monitors["Monitoring"]
  node_cpu["CPU monitor<br/>[cpu-monitor.js]"]
  node_memory["Memory monitor<br/>[mem-monitor.js]"]
  node_network["Network scan<br/>[nmap-monitor.js]"]
  node_ping["Ping monitor<br/>[ping-monitor.js]"]
  node_router["FRITZ!Box monitor<br/>[fritz-monitor.js]"]
  node_weather["Weather monitor<br/>[weather-monitor.js]"]
  node_raspi["Raspberry Pi temperature"]
  node_fuel["Fuel price monitor"]
end

subgraph group_devices["Device integrations"]
  node_plugmon["Plug power monitor"]
  node_plugclient["Meross plug client<br/>[smart-plug.js]"]
end

subgraph group_outputs["Data outputs"]
  node_influx["InfluxDB output"]
  node_influx2["InfluxDB2 output"]
  node_mqtt["MQTT output<br/>[mqtt-handler.js]"]
  node_console["Console output"]
  node_nop["No-op handler<br/>[nop-handler.js]"]
end

node_operator(("Operator"))
node_hostos(("Host OS"))
node_fritzdevice(("FRITZ!Box"))
node_weatherapi(("Weather service"))
node_meross(("Meross smart plug"))
node_influxservice[("InfluxDB service")]
node_mqttbroker(("MQTT broker"))

node_operator -->|"starts"| node_entry
node_entry -->|"starts enabled"| node_cpu
node_entry -->|"starts enabled"| node_memory
node_entry -->|"starts enabled"| node_network
node_entry -->|"starts enabled"| node_ping
node_entry -->|"starts enabled"| node_router
node_entry -->|"starts enabled"| node_weather
node_entry -->|"starts enabled"| node_raspi
node_entry -->|"starts enabled"| node_fuel
node_entry -->|"starts enabled"| node_plugmon
node_entry -->|"enables"| node_influx
node_entry -->|"enables"| node_influx2
node_entry -->|"enables"| node_mqtt
node_entry -->|"enables"| node_console
node_cpu -->|"reads metrics"| node_hostos
node_memory -->|"reads metrics"| node_hostos
node_router -->|"queries"| node_fritzdevice
node_weather -->|"requests weather"| node_weatherapi
node_plugmon -->|"uses"| node_plugclient
node_plugclient -->|"sends requests"| node_meross
node_cpu -->|"sends points"| node_influx
node_cpu -->|"sends points"| node_mqtt
node_cpu -->|"sends points"| node_console
node_memory -->|"sends points"| node_influx
node_memory -->|"sends points"| node_mqtt
node_memory -->|"sends points"| node_console
node_router -->|"sends points"| node_influx
node_router -->|"sends points"| node_mqtt
node_router -->|"sends points"| node_console
node_weather -->|"sends points"| node_influx
node_weather -->|"sends points"| node_mqtt
node_weather -->|"sends points"| node_console
node_plugmon -->|"sends points"| node_influx
node_plugmon -->|"sends points"| node_mqtt
node_plugmon -->|"sends points"| node_console
node_influx2 -->|"inherits writes"| node_influx
node_influx -->|"writes points"| node_influxservice
node_mqtt -->|"publishes"| node_mqttbroker

click node_entry "https://github.com/nobio/nobmon/blob/main/index.js"
click node_cpu "https://github.com/nobio/nobmon/blob/main/lib/monitor/cpu-monitor.js"
click node_memory "https://github.com/nobio/nobmon/blob/main/lib/monitor/mem-monitor.js"
click node_network "https://github.com/nobio/nobmon/blob/main/lib/monitor/nmap-monitor.js"
click node_ping "https://github.com/nobio/nobmon/blob/main/lib/monitor/ping-monitor.js"
click node_router "https://github.com/nobio/nobmon/blob/main/lib/monitor/fritz-monitor.js"
click node_weather "https://github.com/nobio/nobmon/blob/main/lib/monitor/weather-monitor.js"
click node_raspi "https://github.com/nobio/nobmon/blob/main/lib/monitor/raspitemp-monitor.js"
click node_fuel "https://github.com/nobio/nobmon/blob/main/lib/monitor/fuelprice-monitor.js"
click node_plugmon "https://github.com/nobio/nobmon/blob/main/lib/monitor/smartplug-power-monitor.js"
click node_plugclient "https://github.com/nobio/nobmon/blob/main/lib/util/smart-plug.js"
click node_influx "https://github.com/nobio/nobmon/blob/main/lib/handler/influxdb-handler.js"
click node_influx2 "https://github.com/nobio/nobmon/blob/main/lib/handler/influxdb-handler2.js"
click node_mqtt "https://github.com/nobio/nobmon/blob/main/lib/handler/mqtt-handler.js"
click node_console "https://github.com/nobio/nobmon/blob/main/lib/handler/consolelog-handler.js"
click node_nop "https://github.com/nobio/nobmon/blob/main/lib/handler/nop-handler.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry toneBlue
class node_cpu,node_memory,node_network,node_ping,node_router,node_weather,node_raspi,node_fuel,node_influxservice toneAmber
class node_plugmon,node_plugclient toneMint
class node_influx,node_influx2,node_mqtt,node_console,node_nop toneRose
class node_operator,node_hostos,node_fritzdevice,node_weatherapi,node_meross,node_mqttbroker toneIndigo
```

## Components

### Runtime

- [Service entry](https://github.com/nobio/nobmon/blob/main/index.js): `index.js`

### Monitoring

- [CPU monitor](https://github.com/nobio/nobmon/blob/main/lib/monitor/cpu-monitor.js): `lib/monitor/cpu-monitor.js`
- [Memory monitor](https://github.com/nobio/nobmon/blob/main/lib/monitor/mem-monitor.js): `lib/monitor/mem-monitor.js`
- [Network scan](https://github.com/nobio/nobmon/blob/main/lib/monitor/nmap-monitor.js): `lib/monitor/nmap-monitor.js`
- [Ping monitor](https://github.com/nobio/nobmon/blob/main/lib/monitor/ping-monitor.js): `lib/monitor/ping-monitor.js`
- [FRITZ!Box monitor](https://github.com/nobio/nobmon/blob/main/lib/monitor/fritz-monitor.js): `lib/monitor/fritz-monitor.js`
- [Weather monitor](https://github.com/nobio/nobmon/blob/main/lib/monitor/weather-monitor.js): `lib/monitor/weather-monitor.js`
- [Raspberry Pi temperature](https://github.com/nobio/nobmon/blob/main/lib/monitor/raspitemp-monitor.js): `lib/monitor/raspitemp-monitor.js`
- [Fuel price monitor](https://github.com/nobio/nobmon/blob/main/lib/monitor/fuelprice-monitor.js): `lib/monitor/fuelprice-monitor.js`

### Device integrations

- [Plug power monitor](https://github.com/nobio/nobmon/blob/main/lib/monitor/smartplug-power-monitor.js): `lib/monitor/smartplug-power-monitor.js`
- [Meross plug client](https://github.com/nobio/nobmon/blob/main/lib/util/smart-plug.js): `lib/util/smart-plug.js`

### Data outputs

- [InfluxDB output](https://github.com/nobio/nobmon/blob/main/lib/handler/influxdb-handler.js): `lib/handler/influxdb-handler.js`
- [InfluxDB2 output](https://github.com/nobio/nobmon/blob/main/lib/handler/influxdb-handler2.js): `lib/handler/influxdb-handler2.js`
- [MQTT output](https://github.com/nobio/nobmon/blob/main/lib/handler/mqtt-handler.js): `lib/handler/mqtt-handler.js`
- [Console output](https://github.com/nobio/nobmon/blob/main/lib/handler/consolelog-handler.js): `lib/handler/consolelog-handler.js`
- [No-op handler](https://github.com/nobio/nobmon/blob/main/lib/handler/nop-handler.js): `lib/handler/nop-handler.js`

### Other components

- **Operator**
- **Host OS**
- **FRITZ!Box**
- **Weather service**
- **Meross smart plug**
- **InfluxDB service**
- **MQTT broker**

## Connections

- Operator → Service entry: starts
- Service entry → CPU monitor: starts enabled (evidence: `index.js`)
- Service entry → Memory monitor: starts enabled (evidence: `index.js`)
- Service entry → Network scan: starts enabled (evidence: `index.js`)
- Service entry → Ping monitor: starts enabled (evidence: `index.js`)
- Service entry → FRITZ!Box monitor: starts enabled (evidence: `index.js`)
- Service entry → Weather monitor: starts enabled (evidence: `index.js`)
- Service entry → Raspberry Pi temperature: starts enabled (evidence: `index.js`)
- Service entry → Fuel price monitor: starts enabled (evidence: `index.js`)
- Service entry → Plug power monitor: starts enabled (evidence: `index.js`)
- Service entry → InfluxDB output: enables (evidence: `index.js`)
- Service entry → InfluxDB2 output: enables (evidence: `index.js`)
- Service entry → MQTT output: enables (evidence: `index.js`)
- Service entry → Console output: enables (evidence: `index.js`)
- CPU monitor → Host OS: reads metrics (evidence: `lib/monitor/cpu-monitor.js`)
- Memory monitor → Host OS: reads metrics (evidence: `lib/monitor/mem-monitor.js`)
- FRITZ!Box monitor → FRITZ!Box: queries (evidence: `lib/monitor/fritz-monitor.js`)
- Weather monitor → Weather service: requests weather (evidence: `lib/monitor/weather-monitor.js`)
- Plug power monitor → Meross plug client: uses (evidence: `lib/monitor/smartplug-power-monitor.js`)
- Meross plug client → Meross smart plug: sends requests (evidence: `lib/util/smart-plug.js`)
- CPU monitor → InfluxDB output: sends points (evidence: `lib/monitor/cpu-monitor.js`)
- CPU monitor → MQTT output: sends points (evidence: `lib/monitor/cpu-monitor.js`)
- CPU monitor → Console output: sends points (evidence: `lib/monitor/cpu-monitor.js`)
- Memory monitor → InfluxDB output: sends points (evidence: `lib/monitor/mem-monitor.js`)
- Memory monitor → MQTT output: sends points (evidence: `lib/monitor/mem-monitor.js`)
- Memory monitor → Console output: sends points (evidence: `lib/monitor/mem-monitor.js`)
- FRITZ!Box monitor → InfluxDB output: sends points (evidence: `lib/monitor/fritz-monitor.js`)
- FRITZ!Box monitor → MQTT output: sends points (evidence: `lib/monitor/fritz-monitor.js`)
- FRITZ!Box monitor → Console output: sends points (evidence: `lib/monitor/fritz-monitor.js`)
- Weather monitor → InfluxDB output: sends points (evidence: `lib/monitor/weather-monitor.js`)
- Weather monitor → MQTT output: sends points (evidence: `lib/monitor/weather-monitor.js`)
- Weather monitor → Console output: sends points (evidence: `lib/monitor/weather-monitor.js`)
- Plug power monitor → InfluxDB output: sends points (evidence: `lib/monitor/smartplug-power-monitor.js`)
- Plug power monitor → MQTT output: sends points (evidence: `lib/monitor/smartplug-power-monitor.js`)
- Plug power monitor → Console output: sends points (evidence: `lib/monitor/smartplug-power-monitor.js`)
- InfluxDB2 output → InfluxDB output: inherits writes (evidence: `lib/handler/influxdb-handler2.js`)
- InfluxDB output → InfluxDB service: writes points (evidence: `lib/handler/influxdb-handler.js`)
- MQTT output → MQTT broker: publishes (evidence: `lib/handler/mqtt-handler.js`)
