{"id":26057659,"url":"https://github.com/wavefronthq/wavefront-kubernetes-adapter","last_synced_at":"2025-07-28T19:36:11.255Z","repository":{"id":43138111,"uuid":"146363996","full_name":"wavefrontHQ/wavefront-kubernetes-adapter","owner":"wavefrontHQ","description":"Wavefront HPA Adapter for Kubernetes","archived":false,"fork":false,"pushed_at":"2024-12-13T21:17:46.000Z","size":293,"stargazers_count":11,"open_issues_count":5,"forks_count":10,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-04-09T18:17:57.519Z","etag":null,"topics":["hpa","kubernetes","wavefront"],"latest_commit_sha":null,"homepage":"https://www.wavefront.com/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wavefrontHQ.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-27T23:06:20.000Z","updated_at":"2024-12-13T21:17:50.000Z","dependencies_parsed_at":"2023-01-24T23:01:04.598Z","dependency_job_id":"cca04108-1332-48bf-a8bf-b9ace50dbe6c","html_url":"https://github.com/wavefrontHQ/wavefront-kubernetes-adapter","commit_stats":{"total_commits":67,"total_committers":15,"mean_commits":4.466666666666667,"dds":0.3880597014925373,"last_synced_commit":"165ccc0c2fc66aa6b2c87ea1a87ed7167db37372"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavefrontHQ%2Fwavefront-kubernetes-adapter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavefrontHQ%2Fwavefront-kubernetes-adapter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavefrontHQ%2Fwavefront-kubernetes-adapter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavefrontHQ%2Fwavefront-kubernetes-adapter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wavefrontHQ","download_url":"https://codeload.github.com/wavefrontHQ/wavefront-kubernetes-adapter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248085326,"owners_count":21045139,"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":["hpa","kubernetes","wavefront"],"created_at":"2025-03-08T11:58:14.864Z","updated_at":"2025-04-09T18:18:06.027Z","avatar_url":"https://github.com/wavefrontHQ.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Operations for Applications HPA Adapter for Kubernetes\n[![build status][ci-img]][ci] [![Go Report Card][go-report-img]][go-report] [![Docker Pulls][docker-pull-img]][docker-img]\n\n[VMware Aria Operations for Applications](https://docs.wavefront.com) is a high-performance streaming analytics platform for monitoring and optimizing your environment and applications.\n\nThe Operations for Applications HPA (Horizontal Pod Autoscaler) adapter for Kubernetes implements the Kubernetes `k8s.io/api/autoscaling/v2` APIs allowing you to autoscale pods based on metrics available within Operations for Applications.\n\n## Prerequisites\n\n- Kubernetes 1.9+\n- The [aggregation layer](https://kubernetes.io/docs/tasks/access-kubernetes-api/configure-aggregation-layer/) needs to be enabled in your Kubernetes cluster prior to deploying the Operations for Applications HPA adapter.\n\n## Getting Started\nRefer to the [Getting Started](/docs/introduction.md) guide for an overview of the functionality provided by this adapter.\n\n## Configuration\n\nRefer to the [Configuration](/docs/configuration.md) documentation for detailed configuration options.\n\n## Installation\n\n### Helm install\nRefer to the [helm chart](https://github.com/wavefrontHQ/helm#installation) to install the adapter using Helm.\n\n### Manual install\n1. Clone this repo.\n2. Edit the `wavefront-url` and `wavefront-token` properties in `deploy/manifests/05-custom-metrics-apiserver-deployment.yaml`.\n3. Optionally, edit the `deploy/manifests/04-custom-metrics-config-map.yaml` and modify the external metrics you wish to export.\n4. Finally run `kubectl apply -f deploy/manifests` to deploy the adapter in your Kubernetes cluster.\n\n## Debugging\n\nTo verify the installation, run `kubectl get --raw \"/apis/custom.metrics.k8s.io/v1beta1\" | jq .`. You should get the list of supported metrics similar to:\n\n```json\n{\n  \"kind\": \"APIResourceList\",\n  \"apiVersion\": \"v1\",\n  \"groupVersion\": \"custom.metrics.k8s.io/v1beta1\",\n  \"resources\": [\n    {\n      \"name\": \"nodes/cpu.node_reservation\",\n      \"singularName\": \"\",\n      \"namespaced\": false,\n      \"kind\": \"MetricValueList\",\n      \"verbs\": [\n        \"get\"\n      ]\n    },\n    {\n      \"name\": \"pods/network.rx_errors_rate\",\n      \"singularName\": \"\",\n      \"namespaced\": true,\n      \"kind\": \"MetricValueList\",\n      \"verbs\": [\n        \"get\"\n      ]\n    },\n    {\n      \"name\": \"pods/network.tx_rate\",\n      \"singularName\": \"\",\n      \"namespaced\": true,\n      \"kind\": \"MetricValueList\",\n      \"verbs\": [\n        \"get\"\n      ]\n    },\n    {\n      \"name\": \"pods/cpu.request\",\n      \"singularName\": \"\",\n      \"namespaced\": true,\n      \"kind\": \"MetricValueList\",\n      \"verbs\": [\n        \"get\"\n      ]\n    }\n  ]\n}    \n```\n\nYou can similarly run `kubectl get --raw \"/apis/external.metrics.k8s.io/v1beta1\" | jq .` to verify the external metrics API.\n\n## HPA Autoscaling\n\nSee the sample configurations under [hpa-examples](/deploy/hpa-examples/) on how to autoscale deployments based on metrics under the custom or external metrics APIs.\n\nRun `kubectl describe hpa example-hpa-custom-metrics` to verify the autoscaling works.\n\n[ci-img]: https://github.com/wavefrontHQ/wavefront-kubernetes-adapter/actions/workflows/go.yml/badge.svg\n[ci]: https://github.com/wavefrontHQ/wavefront-kubernetes-adapter/actions/workflows/go.yml\n[go-report-img]: https://goreportcard.com/badge/github.com/wavefronthq/wavefront-kubernetes-adapter\n[go-report]: https://goreportcard.com/report/github.com/wavefronthq/wavefront-kubernetes-adapter\n[docker-pull-img]: https://img.shields.io/docker/pulls/wavefronthq/wavefront-hpa-adapter.svg?logo=docker\n[docker-img]: https://hub.docker.com/r/wavefronthq/wavefront-hpa-adapter/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwavefronthq%2Fwavefront-kubernetes-adapter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwavefronthq%2Fwavefront-kubernetes-adapter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwavefronthq%2Fwavefront-kubernetes-adapter/lists"}