serversdown/thor-watcher
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

renamed program to ingest from 'emitter'

Browse Source
This commit is contained in:
serversdwn
2026-02-06 22:26:14 +00:00
parent 896f732bad
commit edeb6a6eba
3 changed files with 24 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
README.md
View File

@@ -1,12 +1,12 @@
# Series 4 Emitter
# Series 4 Ingest Agent
**Version:** 0.1.2
Micromate (Series 4) heartbeat emitter for Seismo Fleet Manager (SFM).
Micromate (Series 4) ingest agent for Seismo Fleet Manager (SFM).
## Overview
Series 4 Emitter is a Python-based monitoring tool that scans for Micromate unit activity logs and reports their status. It monitors MLG (Micromate Log) files in the THORDATA directory structure, determines unit health based on last activity, and optionally transmits heartbeat data to a Seismo Fleet Manager backend.
Series 4 Ingest Agent is a Python-based monitoring tool that scans for Micromate unit activity logs and reports their status. It monitors MLG (Micromate Log) files in the THORDATA directory structure, determines unit health based on last activity, and optionally transmits heartbeat data to a Seismo Fleet Manager backend.
## Features
@@ -30,10 +30,10 @@ Series 4 Emitter is a Python-based monitoring tool that scans for Micromate unit
1. Clone or copy this repository to your THOR PC/VM
2. Ensure Python 3.6+ is installed
3. Configure `config.json` (see Configuration section)
4. Run the emitter:
4. Run the agent:
```bash
python series4_emitter.py
python series4_ingest.py
```
## Configuration
@@ -68,23 +68,23 @@ All configuration is managed through `config.json` in the same directory as the
### Fallback Behavior
If `config.json` is missing or malformed, the emitter will:
If `config.json` is missing or malformed, the agent will:
- Display a warning message
- Use built-in default values
- Continue running normally
## Usage
### Start the Emitter
### Start the Agent
```bash
python series4_emitter.py
python series4_ingest.py
```
### Console Output Example
```
Series 4 Emitter — Micromate Heartbeat (v0.1.2)
Series 4 Ingest Agent — Micromate Heartbeat (v0.1.2)
THORDATA root: C:\THORDATA
Now: 2025-12-08 14:30:00
--------------------------------------------------------------------------------
@@ -96,9 +96,9 @@ Total units: 3
Next scan in 60 seconds...
```
### Stop the Emitter
### Stop the Agent
Press `Ctrl+C` to gracefully stop the emitter.
Press `Ctrl+C` to gracefully stop the agent.
## Status Classification
@@ -110,13 +110,13 @@ Units are classified based on the age of their last MLG file:
## SFM Backend Integration
When `sfm_endpoint` is configured, the emitter sends JSON payloads to the Seismo Fleet Manager:
When `sfm_endpoint` is configured, the agent sends JSON payloads to the Seismo Fleet Manager:
### Payload Structure
```json
{
"source": "series4_emitter",
"source": "series4_ingest",
"generated_at": "2025-12-08T14:30:00",
"units": [
{
@@ -145,7 +145,7 @@ Set `sfm_endpoint` to an empty string in `config.json`:
## MLG File Format
The emitter expects MLG files to follow this naming convention:
The agent expects MLG files to follow this naming convention:
```
UM<unit_number>_YYYYMMDDHHMMSS.MLG
@@ -178,7 +178,7 @@ C:\THORDATA\
## Troubleshooting
### Config file not found
If you see `[WARN] Config file not found`, create `config.json` in the same directory as `series4_emitter.py`.
If you see `[WARN] Config file not found`, create `config.json` in the same directory as `series4_ingest.py`.
### THORDATA path doesn't exist
Verify the `thordata_path` in `config.json` points to the correct directory.