{"id":18508660,"url":"https://github.com/mercedes-benz/kosmoo","last_synced_at":"2025-10-08T00:31:06.809Z","repository":{"id":37610770,"uuid":"187166955","full_name":"mercedes-benz/kosmoo","owner":"mercedes-benz","description":"A prometheus exporter which exposes metrics about PersistentVolumes and OpenStack","archived":false,"fork":false,"pushed_at":"2024-10-09T11:22:12.000Z","size":633,"stargazers_count":38,"open_issues_count":13,"forks_count":10,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-01-19T16:16:50.351Z","etag":null,"topics":["exporter","go","kubernetes","metrics","monitoring","openstack","prometheus"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mercedes-benz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-17T07:19:41.000Z","updated_at":"2024-10-09T11:22:17.000Z","dependencies_parsed_at":"2024-01-14T01:05:37.113Z","dependency_job_id":"ab4d1308-c978-462d-a3fb-3f03955aa921","html_url":"https://github.com/mercedes-benz/kosmoo","commit_stats":{"total_commits":89,"total_committers":18,"mean_commits":4.944444444444445,"dds":0.7303370786516854,"last_synced_commit":"cd37fccf1c36fefbd1a5246335ad62615ab95c9d"},"previous_names":["daimler/kosmoo"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mercedes-benz%2Fkosmoo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mercedes-benz%2Fkosmoo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mercedes-benz%2Fkosmoo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mercedes-benz%2Fkosmoo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mercedes-benz","download_url":"https://codeload.github.com/mercedes-benz/kosmoo/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235665658,"owners_count":19026236,"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":["exporter","go","kubernetes","metrics","monitoring","openstack","prometheus"],"created_at":"2024-11-06T15:15:01.674Z","updated_at":"2025-10-08T00:31:01.462Z","avatar_url":"https://github.com/mercedes-benz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- SPDX-License-Identifier: MIT --\u003e\n# This project is no longer maintained and is archived.\n\n# Kosmoo\n\n[![Build Status](https://github.com/mercedes-benz/kosmoo/actions/workflows/ci.yml/badge.svg)](https://github.com/mercedes-benz/kosmoo/actions?query=.github%2Fworkflows%2Fci.yml)\n[![Release Status](https://github.com/mercedes-benz/kosmoo/workflows/release/badge.svg)](https://github.com/mercedes-benz/kosmoo/actions?query=workflow%3Arelease)\n\n*Kosmoo* exposes metrics about:\n* [Persistent Volumes](https://kubernetes.io/docs/concepts/storage/persistent-volumes/) by queries to the Kubernetes API\n* [Cinder](https://docs.openstack.org/cinder/latest/) and its Disks by queries to the OpenStack API combined with data from the Kubernetes API\n* [Neutron Floating IPs](https://docs.openstack.org/api-ref/network/v2/index.html#floating-ips-floatingips)\n* [Load balancers](https://docs.openstack.org/api-ref/load-balancer/)\n\n## Installation\n\n### Building from source\n\nTo build the exporter from the source code yourself you need to have a working Go environment with [version 1.12 or greater installed](https://golang.org/doc/install).\n\n```\n$ mkdir -p $GOPATH/src/github.com/mercedes-benz\n$ cd $GOPATH/src/github.com/mercedes-benz\n$ git clone https://github.com/mercedes-benz/kosmoo.git\n$ cd kosmoo\n$ make build\n```\n\nThe Makefile provides several targets:\n\n* *build:*  build the `kosmoo` binary\n* *docker:* build a docker container for the current `HEAD`\n* *fmt:* format the source code\n* *test:* runs the `vet`, `lint` and `fmtcheck` targets\n* *vet:* check the source code for common errors\n* *lint:* does source code linting\n* *fmtcheck:* check the source code for format findings\n* *version:* prints the version tag\n\n## Usage\n\n```\n$ ./kosmoo -h\nUsage of ./kosmoo:\n  -addr string\n        Address to listen on (default \":9183\")\n  -alsologtostderr\n        log to standard error as well as files\n  -cloud-conf string\n        path to the cloud.conf file. If this path is not set the scraper will use the usual OpenStack environment variables.\n  -kubeconfig string\n        Path to the kubeconfig file to use for CLI requests. (uses in-cluster config if empty)\n  -log_backtrace_at value\n        when logging hits line file:N, emit a stack trace\n  -log_dir string\n        If non-empty, write log files in this directory\n  -log_file string\n        If non-empty, use this log file\n  -log_file_max_size uint\n        Defines the maximum size a log file can grow to. Unit is megabytes. If the value is 0, the maximum file size is unlimited. (default 1800)\n  -logtostderr\n        log to standard error instead of files (default true)\n  -refresh-interval int\n        Interval between scrapes to OpenStack API (default 120s) (default 120)\n  -skip_headers\n        If true, avoid header prefixes in the log messages\n  -skip_log_headers\n        If true, avoid headers when openning log files\n  -stderrthreshold value\n        logs at or above this threshold go to stderr (default 2)\n  -v value\n        number for the log level verbosity\n  -vmodule value\n        comma-separated list of pattern=N settings for file-filtered logging\n```\n\n## Deployment to Kubernetes\n\n*kosmoo* can get deployed as a deployment. See the [instructions](kubernetes/) how to get started.\nYou can also use the docker images under [packages](https://github.com/mercedes-benz/kosmoo/packages), \nsee also [authenticating-to-github-package-registry](https://help.github.com/en/articles/configuring-docker-for-use-with-github-package-registry#authenticating-to-github-package-registry).\n\n\n\n## Metrics\n\nMetrics will be made available on port 9183 by default, or you can pass the commandline flag `-addr` to override the port.\nAn overview and example output of the metrics can be found in [metrics.md](docs/metrics.md).\n\n## Alert Rules\n\nIn combination with [Prometheus](https://prometheus.io/) it is possible to create alerts from the metrics exposed by the `kosmoo`.\nAn example for some alerts can be found in [alerts.md](docs/alerts.md).\n\n## Contributing\n\nWe welcome any contributions.\nIf you want to contribute to this project, please read the [contributing guide](CONTRIBUTING.md).\n\n## License\n\nFull information on the license for this software is available in the [LICENSE](LICENSE) file.\n\n# Provider Information\n\nPlease visit https://www.mercedes-benz-techinnovation.com/en/imprint/ for information on the provider.\n\nNotice: Before you use the program in productive use, please take all necessary precautions, e.g. testing and verifying the program with regard to your specific use. The program was tested solely for our own use cases, which might differ from yours.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmercedes-benz%2Fkosmoo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmercedes-benz%2Fkosmoo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmercedes-benz%2Fkosmoo/lists"}