# nihaldalil2/iot-gid-monitoring architecture

> Architecture diagram of the GitHub repository nihaldalil2/iot-gid-monitoring, 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/nihaldalil2/iot-gid-monitoring
- Repository: https://github.com/nihaldalil2/iot-gid-monitoring

## Overview

This repository is a real-time log monitoring pipeline: log files are parsed and checked for anomalies, then events flow through MQTT and Telegraf into InfluxDB for Grafana visualization. The README documents the end-to-end stack; publisher.py shows the parsing, anomaly checks, and publishing calls. Broker, Telegraf, database, dashboard, and Compose internals are represented only at the documented level because their configuration contents were not sampled.

Main entry points: [`publisher.py`](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py) (Log publisher), [`docker-compose.yml`](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/docker-compose.yml) (Compose runtime), [`mosquitto.conf`](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/mosquitto.conf) (Mosquitto MQTT), [`telegraf.conf`](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/telegraf.conf) (Telegraf agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Log ingestion"]
  node_publisher["Log publisher<br/>[publisher.py]"]
  node_access["Apache parser<br/>[publisher.py]"]
  node_server["Server parser<br/>[publisher.py]"]
  node_gid["GID parser<br/>[publisher.py]"]
  node_anomaly["Anomaly detection<br/>[publisher.py]"]
end

subgraph group_messaging["Message transport"]
  node_mqtt["Mosquitto MQTT<br/>[mosquitto.conf]"]
end

subgraph group_monitoring["Metrics and visualization"]
  node_telegraf["Telegraf agent<br/>[telegraf.conf]"]
  node_influx[("InfluxDB")]
  node_grafana["Grafana"]
end

subgraph group_runtime["Runtime configuration"]
  node_compose["Compose runtime<br/>[docker-compose.yml]"]
end

node_logs["Log files"]

node_logs -->|"reads lines"| node_publisher
node_publisher -->|"dispatches"| node_access
node_publisher -->|"dispatches"| node_server
node_publisher -->|"dispatches"| node_gid
node_access -->|"checks event"| node_anomaly
node_server -->|"checks event"| node_anomaly
node_gid -->|"checks event"| node_anomaly
node_publisher -->|"publishes events"| node_mqtt
node_mqtt -->|"forwards events"| node_telegraf
node_telegraf -->|"writes metrics"| node_influx
node_influx -->|"visualizes data"| node_grafana
node_compose -->|"runs stack"| node_publisher
node_compose -->|"runs stack"| node_mqtt
node_compose -->|"runs stack"| node_telegraf
node_compose -->|"runs stack"| node_influx
node_compose -->|"runs stack"| node_grafana

click node_publisher "https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py"
click node_access "https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py"
click node_server "https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py"
click node_gid "https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py"
click node_anomaly "https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py"
click node_mqtt "https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/mosquitto.conf"
click node_telegraf "https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/telegraf.conf"
click node_compose "https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/docker-compose.yml"

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_publisher,node_access,node_server,node_gid,node_anomaly toneBlue
class node_mqtt toneAmber
class node_telegraf,node_influx,node_grafana toneMint
class node_compose toneRose
class node_logs toneIndigo
```

## Components

### Log ingestion

- [Log publisher](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py): `publisher.py`
- [Apache parser](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py): `publisher.py`
- [Server parser](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py): `publisher.py`
- [GID parser](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py): `publisher.py`
- [Anomaly detection](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/publisher.py): `publisher.py`

### Message transport

- [Mosquitto MQTT](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/mosquitto.conf): `mosquitto.conf`

### Metrics and visualization

- [Telegraf agent](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/telegraf.conf): `telegraf.conf`
- **InfluxDB**
- **Grafana**

### Runtime configuration

- [Compose runtime](https://github.com/nihaldalil2/iot-gid-monitoring/blob/main/docker-compose.yml): `docker-compose.yml`

### Other components

- **Log files**

## Connections

- Log files → Log publisher: reads lines (evidence: `publisher.py`)
- Log publisher → Apache parser: dispatches (evidence: `publisher.py`)
- Log publisher → Server parser: dispatches (evidence: `publisher.py`)
- Log publisher → GID parser: dispatches (evidence: `publisher.py`)
- Apache parser → Anomaly detection: checks event (evidence: `publisher.py`)
- Server parser → Anomaly detection: checks event (evidence: `publisher.py`)
- GID parser → Anomaly detection: checks event (evidence: `publisher.py`)
- Log publisher → Mosquitto MQTT: publishes events (evidence: `README.md`)
- Mosquitto MQTT → Telegraf agent: forwards events (evidence: `README.md`)
- Telegraf agent → InfluxDB: writes metrics (evidence: `README.md`)
- InfluxDB → Grafana: visualizes data (evidence: `README.md`)
- Compose runtime → Log publisher: runs stack (evidence: `README.md`)
- Compose runtime → Mosquitto MQTT: runs stack (evidence: `README.md`)
- Compose runtime → Telegraf agent: runs stack (evidence: `README.md`)
- Compose runtime → InfluxDB: runs stack (evidence: `README.md`)
- Compose runtime → Grafana: runs stack (evidence: `README.md`)
