ilert-kube-agent is a service that listens to the Kubernetes API server and generates alerts about the health state of the pods and the nodes.

_{Node alert example:}

_{Pod alert example:}

The iLert kube agent requires an API key to send alerts to iLert. You can configure a single API key or multiple API keys separated by commas.

Single API Key:

settings:
  apiKey: "your-single-api-key-here"

Multiple API Keys:

settings:
  apiKey: "api-key-1,api-key-2,api-key-3"

When multiple API keys are provided, the agent will send alerts to all configured iLert alert sources. This is useful for:

• Sending alerts to multiple teams or environments
• Redundancy and failover scenarios
• Different alert routing based on API key configuration

Environment Variable: You can also set the API key using the ILERT_API_KEY environment variable:

export ILERT_API_KEY="api-key-1,api-key-2,api-key-3"

Simply build and run ilert-kube-agent to get Kubernetes cluster alarms.

Note: Google Kubernetes Engine (GKE) Users - GKE has strict role permissions that will prevent the kube-state-metrics roles and role bindings from being created. To work around this, you can give your GCP identity the cluster-admin role by running the following one-liner:

kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=$(gcloud info --format='value(config.account)')

helm repo add ilert https://ilert.github.io/charts/
helm repo update

helm upgrade --install --namespace kube-systems \
    ilert-kube-agent ilert/ilert-kube-agent \
    --set config.settings.apiKey="<YOUR KEY HERE>" \
    --set inClusterRoutesEnabled=true \
    --set config.settings.httpAuthorizationKey="<HTTP AUTHORIZATION HERE>"

Note: In-cluster HTTP routes are only functional when both inClusterRoutesEnabled is true and config.settings.httpAuthorizationKey is set. If config.settings.httpAuthorizationKey is not given, a random alphanumeric string with 64 characters will be generated.

Multiple API Keys: To use multiple API keys, separate them with commas:

helm upgrade --install --namespace kube-systems \
    ilert-kube-agent ilert/ilert-kube-agent \
    --set config.settings.apiKey="key1,key2,key3" \
    --set inClusterRoutesEnabled=true \
    --set config.settings.httpAuthorizationKey="<HTTP AUTHORIZATION HERE>"

• Define module:

module "ilert-kube-agent" {
  source  = "iLert/ilert-kube-agent/kubernetes"
  replicas = 2
  api_key = "<YOUR KEY HERE>"
  http_authorization_key = "<HTTP AUTHORIZATION HERE>"
}

Multiple API Keys: To use multiple API keys, separate them with commas:

module "ilert-kube-agent" {
  source  = "iLert/ilert-kube-agent/kubernetes"
  replicas = 2
  api_key = "key1,key2,key3"
  http_authorization_key = "<HTTP AUTHORIZATION HERE>"
}

• Apply changes

terraform init
terraform apply

Note: In-cluster HTTP routes are only functional when the http_authorization_key is set.

Follow this guide please.

To deploy this project, you can simply run kubectl apply -f deployment/standard and a Kubernetes service and deployment will be created.

We are happy to respond to GitHub issues as well.