{"id":13820612,"url":"https://github.com/rhobs/kube-events-exporter","last_synced_at":"2025-11-01T11:30:34.809Z","repository":{"id":74013419,"uuid":"251351184","full_name":"rhobs/kube-events-exporter","owner":"rhobs","description":"Kubernetes events aggregator and exporter","archived":false,"fork":false,"pushed_at":"2020-09-17T12:49:19.000Z","size":7629,"stargazers_count":27,"open_issues_count":0,"forks_count":6,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-15T00:58:31.924Z","etag":null,"topics":["kubernetes","kubernetes-events","prometheus-exporter"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rhobs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-03-30T15:42:19.000Z","updated_at":"2024-09-18T13:22:28.000Z","dependencies_parsed_at":"2023-03-11T16:14:46.300Z","dependency_job_id":null,"html_url":"https://github.com/rhobs/kube-events-exporter","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhobs%2Fkube-events-exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhobs%2Fkube-events-exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhobs%2Fkube-events-exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhobs%2Fkube-events-exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rhobs","download_url":"https://codeload.github.com/rhobs/kube-events-exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239286282,"owners_count":19613689,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["kubernetes","kubernetes-events","prometheus-exporter"],"created_at":"2024-08-04T08:01:06.016Z","updated_at":"2025-11-01T11:30:34.763Z","avatar_url":"https://github.com/rhobs.png","language":"Go","funding_links":[],"categories":["kubernetes"],"sub_categories":[],"readme":"# kube-events-exporter\n[![Build Status](https://travis-ci.org/rhobs/kube-events-exporter.svg?branch=master)](https://travis-ci.org/rhobs/kube-events-exporter)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\n**⚠️** This project is still under development and has not been proven stable yet.\n\n## Overview\n\nKubernetes Events provide an insight into the cluster, we want to leverage that\nby aggregating and exposing metrics about these events. It will be left to the\nuser to choose which Events should be aggregated and exposed by the exporter.\n\n## Design\n\nPlease refer to the [design document](./docs/design-document.md).\n\n## Metrics\n\nThe exporter exposes metrics over two different HTTP servers. One exposing\nmetrics about Kubernetes Events and another one metrics about the exporter\nhealth.\n\nNote that the listening addresses of the servers can be configured via flags..\n\nFrom the information gathered on the Events, the expoter expose the following\nmetric:\n\n```\nkube_events_total{type=””, involved_object_namespace=””, involved_object_kind=””, reason=””}\n```\n\nThis metric represent the number of Event that were emitted since the exporter\nstarted running in the cluster.\n\nPart of this metric, it is possible to get information about the Event type\n(Normal, Warning, ...), its reason and the object involved.\n\n## Cardinality\n\nThe cardinality of the metrics exposed by the default configuration of the\nexporter is reasonable. After running it for two months in an OpenShift cluster\nwith around 60 namespaces, the exporter only generated around 500 series.\n\nHowever, the cardinality tends to grow exponentially along with the size of the\ncluster. Thus, we added mechanisms to reduce the amount of series generated and\nmake sure that all the labels are bounded.\n\nThe exporter has flags filtering some Events to reduce the number of generated\nseries.\n\n\n- --event-types : List of allowed Event types. Defaults to all types.\n- --involved-object-api-groups : List of allowed Event involved object API groups. Defaults to all API groups.\n- --involved-object-namespaces : List of allowed Event involved object namespaces. Defaults to all namespaces.\n- --reporting-controllers : List of controllers allowed to report Event. Defaults to all controllers.\n\nFor example, if we want to only expose metrics about Warning Events involving\nv1 API group objects reported by the kubelet in the default namespace. We\nwould have the following flags set:\n```\n--event-types=Warning\n--involved-object-api-groups=v1\n--involved-object-namespaces=default\n--reporting-controllers=kubelet\n```\n\nA more concrete example limiting metrics to only native Kubernetes resource can be found under the examples directory with the [limited deployment](./examples/limited/kube-events-exporter-deployment.yaml).\n\n## Prerequisites\n\nThe exporter supports Kubernetes clusters starting from v1.17.0+.\n\n\u003e Note: the exporter might work in previous versions but there is no guarantee.\n\n## Quickstart\n\nTo try the exporter in a Kubernetes cluster, you can run the following command:\n\n```sh\nkubectl create -f examples/basic\n```\n\nThis will create the most basic configuration for the exporter to run in the\ncluster and expose metrics to Prometheus.\n\n## Roadmap\n\n* Expose more labels\n* Expose metrics over HTTPS\n* Provide alerting/recording rules\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhobs%2Fkube-events-exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frhobs%2Fkube-events-exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhobs%2Fkube-events-exporter/lists"}