No description
Find a file
Graham McIntire 4297556700
Implement all quick win improvements for agent UI and functionality
1. Fixed Docker Compose example to include socket mount
   - Added /var/run/docker.sock mount for auto-updates in agent modal

2. Show total equipment count with inheritance
   - Display both direct and inherited equipment counts in agents table
   - Shows breakdown: 'X total' with 'Y direct · Z inherited' details

3. Add visual status indicators with better CSS
   - Added animated pulsing dots for online agents
   - Color-coded status dots (green=online, yellow=warning, red=offline)
   - Improved status badge styling

4. Create agent detail page with metrics
   - New /agents/:id page showing comprehensive agent health
   - 4 metric cards: Status, Equipment count, Last seen, Agent info
   - Displays agent metadata (hostname, version, uptime)
   - Lists all polling targets with assignment source badges
   - Shows direct vs inherited equipment assignments
   - Clickable agent names in table link to detail page

5. Add health endpoint to Rust agent
   - Added /health HTTP endpoint on port 8080
   - Returns JSON with agent status, version, uptime, metrics pending
   - Uses lightweight tiny_http server
   - Non-blocking background thread
   - Ready for monitoring/health checks
2026-01-14 18:46:03 -06:00
.gitlab/agents Add aprs.me project to home-cluster-agent configuration 2026-01-14 13:31:23 -06:00
assets Fix clipboard copy functionality for Docker Compose example 2026-01-14 09:30:09 -06:00
config Fix agent API to accept protobuf content type 2026-01-14 16:58:11 -06:00
k8s Remove secretGenerator from kustomization for GitOps compatibility 2026-01-14 13:09:19 -06:00
lib Implement all quick win improvements for agent UI and functionality 2026-01-14 18:46:03 -06:00
priv Implement hierarchical agent assignment for SNMP polling 2026-01-14 08:38:50 -06:00
rel/overlays/bin add release 2026-01-02 14:36:38 -06:00
test update liveview 2026-01-14 13:54:48 -06:00
towerops Add towerops/gitlab-agent-helm-release.yaml via glab file sync 2026-01-02 14:22:22 -06:00
.credo.exs Add superuser system with user impersonation for admin support 2026-01-06 12:50:10 -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 update gitignore 2026-01-09 13:17:43 -06:00
.gitlab-ci.yml Rename GitLab agent config to match home-cluster-agent 2026-01-11 15:37:49 -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 Streamline login flow and fix test failures 2026-01-13 13:08:24 -06:00
AGENT_IMPLEMENTATION.md set up ses 2026-01-09 16:52:11 -06:00
AGENT_NEXT_STEPS.md Make agent Docker image configurable and update success criteria 2026-01-14 09:16:48 -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 Fix agent API protobuf support and Mix.env runtime error 2026-01-14 16:35:47 -06:00
DEPLOYMENT.md more features 2026-01-02 14:06:44 -06:00
Dockerfile Silence debconf warnings in Docker builds 2026-01-03 16:00:54 -06:00
IMPLEMENTATION_PLAN.md more features 2026-01-02 14:06:44 -06:00
mix.exs Add gen_smtp dependency for Swoosh AmazonSES adapter 2026-01-11 15:41:21 -06:00
mix.lock update liveview 2026-01-14 13:54:48 -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

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