# sathishkumarbalasubramani/sniffermonitor architecture

> Architecture diagram of the GitHub repository sathishkumarbalasubramani/sniffermonitor, 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/sathishkumarbalasubramani/sniffermonitor
- Repository: https://github.com/sathishkumarbalasubramani/sniffermonitor

## Overview

SnifferMonitor periodically fetches lab monitoring pages, parses channel tables, evaluates channel health and missing-channel conditions, then coordinates alert-state handling and alert-file/archive/SFTP outputs. The sampled service and parser show the fetch-to-detection path; the README is empty and several coordinator, persistence, and integration implementations were not excerpted, so their links are marked unverified rather than inferred as confirmed calls.

Main entry points: [`src/com/sniffer/service/MonitorService.java`](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/service/MonitorService.java) (Monitor service), [`src/com/sniffer/service/MonitoringCoordinator.java`](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/service/MonitoringCoordinator.java) (Monitoring coordinator), [`src/com/sniffer/model/AlertInfo.java`](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/model/AlertInfo.java) (Alert records), [`src/com/sniffer/main/MonitorJob.java`](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/main/MonitorJob.java) (Monitor job)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Monitor runtime"]
  node_scheduler["Scheduled runtime<br/>[Main.java]"]
  node_job["Monitor job<br/>[MonitorJob.java]"]
  node_coordinator["Monitoring coordinator"]
  node_service["Monitor service"]
  node_config["Configuration<br/>[ConfigReader.java]"]
  node_http["HTTP fetch<br/>[HttpUtil.java]"]
end

subgraph group_detection["Channel detection"]
  node_parser["HTML parser<br/>[SnifferParser.java]"]
  node_channel["Channel records<br/>[ChannelInfo.java]"]
  node_rules["Health rules<br/>[RuleEngine.java]"]
  node_missing["Missing-channel detector"]
  node_alert["Alert records<br/>[AlertInfo.java]"]
  node_alerttypes["Alert types<br/>[AlertType.java]"]
end

subgraph group_state["State and recovery"]
  node_alertstate["Alert state processor"]
  node_state[("Alert state store<br/>[StateManager.java]")]
  node_baseline[("Channel baseline")]
end

subgraph group_outputs["Alert delivery"]
  node_writer["Alert file writer"]
  node_archive["Alert archive"]
  node_sftp["SFTP uploader<br/>[SftpUploader.java]"]
end

node_operator(("Operator"))
node_labsite(("Lab monitoring page"))
node_remote(("SFTP destination"))

node_operator -->|"starts"| node_scheduler
node_scheduler -->|"schedules"| node_job
node_job -.->|"invokes"| node_coordinator
node_job -.->|"monitors labs"| node_service
node_service -->|"downloads page"| node_http
node_http -->|"GET request"| node_labsite
node_service -->|"parses HTML"| node_parser
node_parser -->|"creates records"| node_channel
node_service -->|"evaluates channels"| node_rules
node_rules -->|"creates alerts"| node_alert
node_service -->|"detects absences"| node_missing
node_missing -.->|"creates alerts"| node_alert
node_service -->|"returns alerts"| node_alert
node_rules -->|"reads threshold"| node_config
node_alertstate -.->|"updates state"| node_state
node_missing -.->|"checks baseline"| node_baseline
node_coordinator -.->|"processes states"| node_alertstate
node_coordinator -.->|"writes alerts"| node_writer
node_coordinator -.->|"archives alerts"| node_archive
node_coordinator -.->|"uploads alerts"| node_sftp
node_sftp -.->|"transfers files"| node_remote
node_writer -->|"serializes"| node_alert
node_alertstate -.->|"processes alerts"| node_alert

click node_scheduler "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/main/Main.java"
click node_job "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/main/MonitorJob.java"
click node_coordinator "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/service/MonitoringCoordinator.java"
click node_service "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/service/MonitorService.java"
click node_config "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/config/ConfigReader.java"
click node_http "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/util/HttpUtil.java"
click node_parser "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/parser/SnifferParser.java"
click node_channel "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/model/ChannelInfo.java"
click node_rules "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/monitor/RuleEngine.java"
click node_missing "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/monitor/ChannelMissingDetector.java"
click node_alert "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/model/AlertInfo.java"
click node_alerttypes "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/constants/AlertType.java"
click node_alertstate "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/monitor/AlertStateProcessor.java"
click node_state "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/state/StateManager.java"
click node_baseline "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/state/ChannelBaselineManager.java"
click node_writer "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/alert/AlertFileWriter.java"
click node_archive "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/file/ArchiveManager.java"
click node_sftp "https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/sftp/SftpUploader.java"

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_scheduler,node_job,node_coordinator,node_service,node_config,node_http toneBlue
class node_parser,node_channel,node_rules,node_missing,node_alert,node_alerttypes toneAmber
class node_alertstate,node_state,node_baseline toneMint
class node_writer,node_archive,node_sftp toneRose
class node_operator,node_labsite,node_remote toneIndigo
```

## Components

### Monitor runtime

- [Scheduled runtime](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/main/Main.java): `src/com/sniffer/main/Main.java`
- [Monitor job](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/main/MonitorJob.java): `src/com/sniffer/main/MonitorJob.java`
- [Monitoring coordinator](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/service/MonitoringCoordinator.java): `src/com/sniffer/service/MonitoringCoordinator.java`
- [Monitor service](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/service/MonitorService.java): `src/com/sniffer/service/MonitorService.java`
- [Configuration](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/config/ConfigReader.java): `src/com/sniffer/config/ConfigReader.java`
- [HTTP fetch](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/util/HttpUtil.java): `src/com/sniffer/util/HttpUtil.java`

### Channel detection

- [HTML parser](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/parser/SnifferParser.java): `src/com/sniffer/parser/SnifferParser.java`
- [Channel records](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/model/ChannelInfo.java): `src/com/sniffer/model/ChannelInfo.java`
- [Health rules](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/monitor/RuleEngine.java): `src/com/sniffer/monitor/RuleEngine.java`
- [Missing-channel detector](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/monitor/ChannelMissingDetector.java): `src/com/sniffer/monitor/ChannelMissingDetector.java`
- [Alert records](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/model/AlertInfo.java): `src/com/sniffer/model/AlertInfo.java`
- [Alert types](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/constants/AlertType.java): `src/com/sniffer/constants/AlertType.java`

### State and recovery

- [Alert state processor](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/monitor/AlertStateProcessor.java): `src/com/sniffer/monitor/AlertStateProcessor.java`
- [Alert state store](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/state/StateManager.java): `src/com/sniffer/state/StateManager.java`
- [Channel baseline](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/state/ChannelBaselineManager.java): `src/com/sniffer/state/ChannelBaselineManager.java`

### Alert delivery

- [Alert file writer](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/alert/AlertFileWriter.java): `src/com/sniffer/alert/AlertFileWriter.java`
- [Alert archive](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/file/ArchiveManager.java): `src/com/sniffer/file/ArchiveManager.java`
- [SFTP uploader](https://github.com/sathishkumarbalasubramani/sniffermonitor/blob/main/src/com/sniffer/sftp/SftpUploader.java): `src/com/sniffer/sftp/SftpUploader.java`

### Other components

- **Operator**
- **Lab monitoring page**
- **SFTP destination**

## Connections

- Operator → Scheduled runtime: starts (evidence: `src/com/sniffer/main/Main.java`)
- Scheduled runtime → Monitor job: schedules (evidence: `src/com/sniffer/main/Main.java`)
- Monitor job → Monitoring coordinator: invokes (evidence: `src/com/sniffer/main/MonitorJob.java`)
- Monitor job → Monitor service: monitors labs (evidence: `src/com/sniffer/main/MonitorJob.java`)
- Monitor service → HTTP fetch: downloads page (evidence: `src/com/sniffer/service/MonitorService.java`)
- HTTP fetch → Lab monitoring page: GET request (evidence: `src/com/sniffer/util/HttpUtil.java`)
- Monitor service → HTML parser: parses HTML (evidence: `src/com/sniffer/service/MonitorService.java`)
- HTML parser → Channel records: creates records (evidence: `src/com/sniffer/parser/SnifferParser.java`)
- Monitor service → Health rules: evaluates channels (evidence: `src/com/sniffer/service/MonitorService.java`)
- Health rules → Alert records: creates alerts (evidence: `src/com/sniffer/monitor/RuleEngine.java`)
- Monitor service → Missing-channel detector: detects absences (evidence: `src/com/sniffer/service/MonitorService.java`)
- Missing-channel detector → Alert records: creates alerts (evidence: `src/com/sniffer/monitor/ChannelMissingDetector.java`)
- Monitor service → Alert records: returns alerts (evidence: `src/com/sniffer/service/MonitorService.java`)
- Health rules → Configuration: reads threshold (evidence: `src/com/sniffer/monitor/RuleEngine.java`)
- Alert state processor → Alert state store: updates state (evidence: `src/com/sniffer/monitor/AlertStateProcessor.java`)
- Missing-channel detector → Channel baseline: checks baseline (evidence: `src/com/sniffer/monitor/ChannelMissingDetector.java`)
- Monitoring coordinator → Alert state processor: processes states (evidence: `src/com/sniffer/service/MonitoringCoordinator.java`)
- Monitoring coordinator → Alert file writer: writes alerts (evidence: `src/com/sniffer/service/MonitoringCoordinator.java`)
- Monitoring coordinator → Alert archive: archives alerts (evidence: `src/com/sniffer/service/MonitoringCoordinator.java`)
- Monitoring coordinator → SFTP uploader: uploads alerts (evidence: `src/com/sniffer/service/MonitoringCoordinator.java`)
- SFTP uploader → SFTP destination: transfers files
- Alert file writer → Alert records: serializes (evidence: `src/com/sniffer/alert/AlertFileWriter.java`)
- Alert state processor → Alert records: processes alerts (evidence: `src/com/sniffer/monitor/AlertStateProcessor.java`)
