Skip to content

Helm Chart

The AlertHawk Helm chart deploys all AlertHawk components on Kubernetes as deployments and services.

Components

ComponentDeployment nameDescription
monitoringalerthawk-monitoringRuns monitors (HTTP, TCP, K8s, etc.) and manages alerts
authalerthawk-authAuthentication (Azure AD, JWT, user management)
notificationalerthawk-notificationSends alerts (Slack, Teams, email, webhooks, etc.)
metrics-apialerthawk-metrics-apiMetrics API (ClickHouse + SQL Server)
uialerthawk-uiWeb UI

Charts in the repo

  • Helm repo URL: https://thiagoloureiro.github.io/AlertHawk.Chart/
  • Chart repository: AlertHawk.Chart
  • Artifact Hub: alerthawk
ChartDescription
alerthawkMain chart: monitoring, auth, notification, metrics-api, UI (see Installation, Configuration, Environment variables).
alerthawk-metrics-agentMetrics Agent only: collects Kubernetes metrics and sends them to the Metrics API. See Agents Chart.

Quick start

bash
# Add the Helm repository
helm repo add alerthawk https://thiagoloureiro.github.io/AlertHawk.Chart/
helm repo update

# Create a values file (copy and edit from chart)
helm show values alerthawk/alerthawk > my-values.yaml
# Edit my-values.yaml with your connection strings and secrets

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

See Installation for prerequisites and detailed steps, and Configuration for values.yaml structure. For all per-service environment variables, see Environment variables.

To deploy only the Metrics Agent (e.g. in each cluster you want to monitor), use the separate chart: Metrics Agent chart.

AlertHawk - Self-hosted monitoring solution.