AlertHawk

Self-hosted monitoring for APIs, websites, servers, Kubernetes, and more

Live demo · Docs · Helm charts · Chart repo

---

Overview

AlertHawk is a self-hosted monitoring platform that gives you real-time visibility into the health and performance of your stack. Monitor WebAPIs, websites, TCP endpoints, Kubernetes clusters, and more — with alerts delivered through the channels you already use.

Try it now: https://alerthawk.net — create an account or sign in with a personal Microsoft account.

Features

• Versatile monitoring — HTTP/HTTPS, TCP, Kubernetes nodes/pods, and more
• Microservices architecture — modular services for availability and scale
• Cloud & on-prem ready — run anywhere you can host containers
• Rich notifications — email, Slack, Teams, Telegram, webhooks, and more
• Metrics & FinOps — cluster metrics plus Azure cost and resource insights
• Kubernetes-native — Helm charts on Artifact Hub

Architecture

Component	Description
Authentication	Identity and access (e.g. Microsoft Account / Azure AD)
Monitoring	Runs monitors (HTTP, TCP, K8s, etc.) and manages alerts
Notification	Delivers alerts to configured channels
Metrics Agent	Collects metrics from your environments
Metrics API	Stores and queries metrics data
FinOps	Azure cost/resource analysis with optional AI recommendations
UI	Web dashboard

Architecture diagram: Diagrams/AlertHawk.drawio

Screenshots

Quick start (Helm)

helm repo add alerthawk https://thiagoloureiro.github.io/AlertHawk.Chart/
helm repo update

helm show values alerthawk/alerthawk > my-values.yaml
# Edit my-values.yaml with your connection strings and secrets

helm install alerthawk alerthawk/alerthawk -f my-values.yaml

More details: Helm docs · AlertHawk.Chart

Docker images & CI

Images are published to Docker Hub under thiagoguaru.

GitHub Actions tests, builds, and pushes an image when that project changes on main. Those builds are tagged latest and sha-<commit>. To publish a numbered tag (the versions pinned in the Helm charts), run the workflow from the Actions tab and set version, for example 3.3.16. That push also opens a GitHub Release named <image>-<version>.

Notification

Authentication

Monitoring

Metrics

FinOps

Documentation

Topic	Link
Introduction	AlertHawk.Docs/intro.md
Monitoring	AlertHawk.Docs/monitoring
Notification	AlertHawk.Docs/notification
Authentication	AlertHawk.Docs/authentication
Metrics API / Agent	AlertHawk.Docs/metrics-api · metrics-agent
FinOps	AlertHawk.Docs/finops
Helm	AlertHawk.Docs/helm

Contributors

Thanks to everyone who has contributed:

BulandaK	altughan09	guilhermedclima	pvinicius

Full list: contributors

License

This project is licensed under the MIT License.

Support the project on Ko-fi.