No description
Find a file
Graham McIntire fcc1fbbe73
Refactor MonitorWorker to use ping adapter and eliminate real network traffic from tests
Changes:
- Updated MonitorWorker to use configured ping_module adapter instead of System.cmd
- Removed direct ping command execution and regex parsing
- Simplified ping_device/1 to use adapter.ping/2 (mockable in tests)
- Added PingMock expectations to all MonitorWorker tests
- Removed @tag :integration from unreachable host test (now mocked)
- All ping calls now use mocked responses in tests

Benefits:
- MonitorWorker tests now run in 0.2s instead of 5+ seconds
- No real ICMP network traffic during test runs
- Tests are deterministic and don't depend on network conditions
- Follows same adapter pattern as SNMP (testable, configurable)

All 1041 tests passing with no real network operations.
2026-01-20 12:29:12 -06:00
.gitlab/agents Add aprs.me project to home-cluster-agent configuration 2026-01-14 13:31:23 -06:00
assets fix: adjust graph x-axis range based on selected time period 2026-01-18 12:56:44 -06:00
config Auto-expand MIB directories to include subdirectories 2026-01-19 14:06:51 -06:00
docs Update infrastructure documentation with Valkey restart fix 2026-01-19 15:41:11 -06:00
k8s Add init container to Valkey to wait for Flannel CNI readiness 2026-01-20 11:41:21 -06:00
lib Refactor MonitorWorker to use ping adapter and eliminate real network traffic from tests 2026-01-20 12:29:12 -06:00
mibs handle mib uploading 2026-01-18 16:29:24 -06:00
priv Include MIB files in Docker image instead of using PVC 2026-01-19 14:01:03 -06:00
rel/overlays/bin add release 2026-01-02 14:36:38 -06:00
scripts Improve monitor script to eliminate screen flicker 2026-01-15 13:04:41 -06:00
test Refactor MonitorWorker to use ping adapter and eliminate real network traffic from tests 2026-01-20 12:29:12 -06:00
towerops Add towerops/gitlab-agent-helm-release.yaml via glab file sync 2026-01-02 14:22:22 -06:00
.credo.exs credo tweak 2026-01-17 15:32:33 -06:00
.dockerignore add release 2026-01-02 14:36:38 -06:00
.formatter.exs format 2025-12-21 11:31:08 -06:00
.gitignore Include MIB files in Docker image instead of using PVC 2026-01-19 14:01:03 -06:00
.gitlab-ci.yml dont wait for deploy 2026-01-18 17:17:43 -06:00
.sourceignore Add .sourceignore to exclude non-k8s files from Flux 2026-01-02 14:43:57 -06:00
.test-watch.exs add test watch 2026-01-03 12:35:26 -06:00
.tool-versions test cleanup 2026-01-19 13:29:38 -06:00
AGENT_IMPLEMENTATION.md set up ses 2026-01-09 16:52:11 -06:00
AGENT_PROTOCOL.md agent improvements and agent config 2026-01-16 17:26:51 -06:00
AGENTS.md 1. User Authentication 2025-12-21 13:31:59 -06:00
AWS_SES_SETUP.md set up ses 2026-01-09 16:52:11 -06:00
CLAUDE.md updates 2026-01-17 17:49:53 -06:00
DEPLOYMENT.md more features 2026-01-02 14:06:44 -06:00
Dockerfile add parallel build 2026-01-19 14:17:05 -06:00
IMPLEMENTATION_PLAN.md more features 2026-01-02 14:06:44 -06:00
LIBRENMS_INTEGRATION.md add universoal import 2026-01-18 16:59:34 -06:00
mix.exs add honeybadger and snmp overhaul 2026-01-18 16:16:08 -06:00
mix.lock add honeybadger and snmp overhaul 2026-01-18 16:16:08 -06:00
MOBILE_API.md add api for mobile login 2026-01-15 15:36:14 -06:00
PROFILES.md refactor: use API token auth for profile imports instead of session cookies 2026-01-18 09:30:21 -06:00
PROFILES_README.md add universoal import 2026-01-18 16:59:34 -06:00
README.md timescaledb 2025-12-21 17:17:26 -06:00
tail_logs.sh add logs helper script 2026-01-11 15:45:02 -06:00
TIMESCALEDB.md more features 2026-01-02 14:06:44 -06:00
WEBSOCKET_MIGRATION.md agent improvements and agent config 2026-01-16 17:26:51 -06:00

TowerOps

Network monitoring and alerting platform built with Phoenix LiveView.

Features

  • Multi-tenant architecture - Organizations with role-based permissions
  • Site hierarchy - Organize equipment across multiple sites
  • Automated monitoring - Real-time ping monitoring with configurable intervals
  • Time-series data - Efficient storage with TimescaleDB (optional)
  • Real-time updates - LiveView dashboard with PubSub
  • Equipment tracking - Monitor network devices by IP address

Quick Start

Prerequisites

  • Elixir 1.14+
  • PostgreSQL 14+
  • (Optional) TimescaleDB for production-grade time-series performance

Setup

# Install dependencies
mix setup

# Start the server
mix phx.server

Visit localhost:4000 from your browser.

TimescaleDB (Production Only)

Development: Uses standard PostgreSQL (no TimescaleDB required).

Production: TimescaleDB is automatically enabled for optimal performance with time-series data.

# Production deployment - install TimescaleDB first
brew tap timescale/tap && brew install timescaledb  # macOS
# Then run migrations with MIX_ENV=prod
MIX_ENV=prod mix ecto.migrate

See TIMESCALEDB.md for detailed installation and configuration.

How it works: Migrations detect the environment (MIX_ENV) and only enable TimescaleDB features (hypertables, compression, retention policies, continuous aggregates) in production.

Development

Database

mix ecto.create       # Create database
mix ecto.migrate      # Run migrations
mix ecto.reset        # Drop, create, and migrate

Testing

mix test              # Run all tests
mix test --trace      # Run with detailed output

Code Quality

mix format            # Format code with Styler
mix compile --warnings-as-errors

Learn more