d5f75692f3
Co-authored-by: blackboxprogramming <118287761+blackboxprogramming@users.noreply.github.com>
58 lines
1.2 KiB
Markdown
58 lines
1.2 KiB
Markdown
# 🗺️ Beacon Maps
|
|
|
|
**Purpose:** Which services/envs/orgs are alive + reachable
|
|
**Updated:** 2025-11-25
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
This directory contains **beacon maps** — append-only records of service and environment reachability.
|
|
|
|
## 🧪 Invariants
|
|
|
|
Every beacon map must have:
|
|
- 🧬 **Stable ID:** `BEACON-YYYYMMDD-XXX`
|
|
- ⏱️ **Timestamp:** Precise with timezone/UTC
|
|
- 🧭 **Context tags:** services tracked, environments
|
|
|
|
## Entry Format
|
|
|
|
```markdown
|
|
# Beacon Map: YYYY-MM-DD HH:MM:SS UTC
|
|
|
|
**ID:** BEACON-YYYYMMDD-XXX
|
|
**Services Tracked:** [count]
|
|
**Environments:** [list]
|
|
**Generated By:** [agent:name | system]
|
|
|
|
---
|
|
|
|
## Service Reachability
|
|
|
|
| Service | Env | Status | Latency | Last Seen |
|
|
|---------|-----|--------|---------|-----------|
|
|
| api | prod | ✅ | 45ms | HH:MM |
|
|
| web | prod | ✅ | 32ms | HH:MM |
|
|
| operator | prod | ⚠️ | 120ms | HH:MM |
|
|
|
|
## Summary
|
|
- **Total Services:** [count]
|
|
- **Healthy:** [count]
|
|
- **Degraded:** [count]
|
|
- **Down:** [count]
|
|
|
|
## Notes
|
|
[Any anomalies or observations]
|
|
```
|
|
|
|
## File Naming
|
|
|
|
Use: `YYYY-MM-DD-beacon-map-XXX.md`
|
|
|
|
Example: `2025-11-25-beacon-map-001.md`
|
|
|
|
---
|
|
|
|
*This is append-only history. Corrections are new entries that reference old ones.* 🗺️
|