On-call management & Escalations
Uptime & Heartbeat Monitors
Integrations
Kubernetes Integration
With the iLert Kubernetes integration, you can create alerts in iLert based on Kubernetes events and metrics.

In iLert

Create a Kubenetes alert source

  1. 1.
    Go to the "Alert sources" tab and click Create new alert source
  2. 2.
    Enter a name and select your desired escalation policy. Select "Kubernetes" as the Integration Type and click on Save.
  1. 1.
    On the next page, a API Key is generated. You will need it below when setting up the ilert-kube-agent deployment.

In Kubernetes

a. Deploy ilert-kube-agent with helm (recommended)

  1. 1.
    Add helm charts repo and update it
helm repo add ilert https://ilert.github.io/charts/
helm repo update
  1. 1.
    Deploy ilert-kube-agent with the API Key that you generated in iLert
helm upgrade --install --namespace kube-system \
ilert-kube-agent ilert/ilert-kube-agent \
--set config.settings.apiKey="<YOUR KEY HERE>"

b. Deploy ilert-kube-agent with terraform (recommended)

  1. 1.
    Define module and paste the API Key that you generated in iLert
module "ilert-kube-agent" {
source = "iLert/ilert-kube-agent/kubernetes"
version = "0.3.9"
replicas = 2
api_key = "<YOUR KEY HERE>"
}
  1. 1.
    Apply changes
terraform init
terraform apply

c. Deploy ilert-kube-agent with manifest

  1. 1.
    Clone the ilert-kube-agent repository
git clone https://github.com/iLert/ilert-kube-agent.git
  1. 1.
    Paste the API Key that you generated in iLert into ./example/standard/30-deployment.yaml
...
env:
...
- name: ILERT_API_KEY
value: "<YOUR KEY HERE>"
...
  1. 1.
    Apply the deployment manifest to your kubernetes cluster
kubectl apply -f deployment/standard/
  1. 1.
    Verify that the ilert-kube-agent pods are running and ready
kubectl --namespace kube-system get pod -l app=ilert-kube-agent
NAME READY STATUS RESTARTS AGE
ilert-kube-agent-64f7dfd4d-nsnzp 1/1 Running 0 37h
ilert-kube-agent-64f7dfd4d-zx7fb 1/1 Running 0 37h
Finished! Your Kubernetes alerts will now create alerts in iLert.

FAQ

Will alerts in iLert be resolved automatically?
Yes, as soon as an alert has been resolved in ilert-kube-agent, the associated alert in iLert will be resolved automatically.
Can I connect multiple Kuberenetes namespaces with multiple alert sources from iLert?
Yes, simply create multiple deployments per namespace in Kubernetes.
Copy link
Edit on GitHub
Outline
In iLert
Create a Kubenetes alert source
In Kubernetes
a. Deploy ilert-kube-agent with helm (recommended)
b. Deploy ilert-kube-agent with terraform (recommended)
c. Deploy ilert-kube-agent with manifest
FAQ