shared

README

ilert-kube-agent

ilert-kube-agent is a service that listens to the Kubernetes API server and generates incidents about the health state of the pods and the nodes. (See examples in the Alerts section below.)

Usage

Simply build and run ilert-kube-agent inside a Kubernetes pod which has a service account token that has read-only access to the Kubernetes cluster.

Kubernetes Deployment

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

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 Deployment

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>"

Terraform Deployment

• Define module:

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

• Apply changes

terraform init
terraform apply

Getting help

We are happy to respond to GitHub issues as well.

License

^{Licensed under Apache License, Version 2.0}
_{Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in ilert-kube-agent by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.}

Documentation

Index

• Constants

Constants

const App = "ilert-kube-agent"

App name

const Version = "v1.4.3"

Version current version