https://github.com/carverauto/serviceradar
simple golang-based distributed network monitoring
https://github.com/carverauto/serviceradar
distributed dusk golang homelab monitoring-tool network-monitoring-tool network-scanning ubiquiti
Last synced: 9 months ago
JSON representation
simple golang-based distributed network monitoring
- Host: GitHub
- URL: https://github.com/carverauto/serviceradar
- Owner: carverauto
- License: apache-2.0
- Created: 2025-01-13T18:33:55.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-04-01T22:56:50.000Z (9 months ago)
- Last Synced: 2025-04-01T23:29:40.260Z (9 months ago)
- Topics: distributed, dusk, golang, homelab, monitoring-tool, network-monitoring-tool, network-scanning, ubiquiti
- Language: Go
- Homepage: http://docs.serviceradar.cloud/
- Size: 25.1 MB
- Stars: 99
- Watchers: 2
- Forks: 3
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-repositories - carverauto/serviceradar - opensource network management and observability platform (Go)
README
# ServiceRadar
[](https://github.com/carverauto/serviceradar/actions/workflows/release.yml)
[](https://github.com/carverauto/serviceradar/actions/workflows/golangci-lint.yml)
[](https://github.com/carverauto/serviceradar/actions/workflows/tests-golang.yml)
[](https://github.com/carverauto/serviceradar/actions/workflows/tests-rust.yml)
[](https://github.com/carverauto/serviceradar/actions/workflows/go-coverage.yml)
ServiceRadar is a distributed network monitoring system designed for infrastructure and services in hard to reach places or constrained environments.
It provides real-time monitoring of internal services, with cloud-based alerting capabilities to ensure you stay informed even during network or power outages.
## Features
- **Real-time Monitoring**: Monitor services and infrastructure in hard-to-reach places
- **Distributed Architecture**: Components can be installed across different hosts to suit your needs
- **SNMP Integration**: Collect and visualize network metrics
- **Security**: Support for mTLS to secure communications between components and API key authentication for web UI
- **Alerting**: Webhook-based alerts (Discord, etc.) to notify you of issues
- **Specialized Monitoring**: Support for specific node types like Dusk Network nodes
## Quick Installation
ServiceRadar can be installed via direct downloads from GitHub releases:
```bash
# Download and install core components
curl -LO https://github.com/carverauto/serviceradar/releases/download/1.0.29/serviceradar-agent_1.0.29.deb \
-O https://github.com/carverauto/serviceradar/releases/download/1.0.29/serviceradar-poller_1.0.29.deb \
-O https://github.com/carverauto/serviceradar/releases/download/1.0.29/serviceradar-core_1.0.29.deb \
-O https://github.com/carverauto/serviceradar/releases/download/1.0.29/serviceradar-web_1.0.29.deb
# Install components as needed
sudo dpkg -i serviceradar-agent_1.0.29.deb serviceradar-poller_1.0.29.deb serviceradar-core_1.0.29.deb serviceradar-web_1.0.29.deb
```
## Architecture Overview
ServiceRadar uses a distributed architecture with four main components:
1. **Agent** - Runs on monitored hosts, provides service status through gRPC
2. **Poller** - Coordinates monitoring activities, can run anywhere in your network
3. **Core Service** - Receives reports from pollers, provides API, and sends alerts
4. **Web UI** - Provides a modern dashboard interface with Nginx as a reverse proxy
## Documentation
For detailed information on installation, configuration, and usage, please visit our documentation site:
**[https://docs.serviceradar.cloud](https://docs.serviceradar.cloud)**
Documentation topics include:
- Detailed installation instructions
- Configuration guides
- Security setup (mTLS)
- SNMP polling configuration
- Network scanning
- Dusk node monitoring
- And more...
## Try it
Connect to our live-system. This instance is part of our continuous-deployment system and may contain previews of upcoming builds or features, or may not work at all.
**[https://demo.serviceradar.cloud](https://demo.serviceradar.cloud)**
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.