{"id":13820893,"url":"https://github.com/galexrt/dellhw_exporter","last_synced_at":"2025-05-07T15:46:58.887Z","repository":{"id":23870174,"uuid":"101161429","full_name":"galexrt/dellhw_exporter","owner":"galexrt","description":"Prometheus exporter for Dell Hardware components using Dell OMSA.","archived":false,"fork":false,"pushed_at":"2024-04-12T15:03:03.000Z","size":7928,"stargazers_count":106,"open_issues_count":4,"forks_count":41,"subscribers_count":12,"default_branch":"main","last_synced_at":"2024-04-14T12:08:00.364Z","etag":null,"topics":["dell","dell-omsa","exporter","hacktoberfest","metrics","monitoring","omsa","prometheus"],"latest_commit_sha":null,"homepage":"https://dellhw-exporter.galexrt.moe","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/galexrt.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2017-08-23T09:14:10.000Z","updated_at":"2024-04-15T15:44:12.720Z","dependencies_parsed_at":"2023-12-29T13:26:10.270Z","dependency_job_id":"dc71e15a-1f5f-4340-8ddb-14faa992dec0","html_url":"https://github.com/galexrt/dellhw_exporter","commit_stats":{"total_commits":258,"total_committers":13,"mean_commits":"19.846153846153847","dds":"0.19767441860465118","last_synced_commit":"64cb5e04521728b8b028a75a29c4d64597b66d64"},"previous_names":[],"tags_count":75,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galexrt%2Fdellhw_exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galexrt%2Fdellhw_exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galexrt%2Fdellhw_exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galexrt%2Fdellhw_exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/galexrt","download_url":"https://codeload.github.com/galexrt/dellhw_exporter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231449663,"owners_count":18378430,"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":["dell","dell-omsa","exporter","hacktoberfest","metrics","monitoring","omsa","prometheus"],"created_at":"2024-08-04T08:01:11.159Z","updated_at":"2024-12-27T07:09:00.258Z","avatar_url":"https://github.com/galexrt.png","language":"Go","funding_links":[],"categories":["monitoring"],"sub_categories":[],"readme":"# dellhw_exporter\n\n![build_release](https://github.com/galexrt/dellhw_exporter/workflows/build_release/badge.svg)\n\nPrometheus exporter for Dell Hardware components using OMSA.\n\nThe exporter was originally made by [PrFalken](https://github.com/PrFalken). Due to some issues in the code, I rewrote the whole exporter using the [\"node_exporter\"](https://github.com/prometheus/node_exporter) pattern and therefore moved it from being a fork out, to a standalone repository.\n\nOmreport parsing functions were borrowed from the [Bosun project](https://github.com/bosun-monitor/bosun/blob/master/cmd/scollector/collectors/dell_hw.go), thank you very much for that, they are the most tedious part of the job.\n\nThis exporter wraps the `omreport` command from Dell OMSA. If you can't run or get any output from `omreport` on your system, then the exporter probably won't export any metrics.\n\n## Compatibility\n\n### Tested Dell OMSA Compatibility\n\nThe dellhw_exporter has been tested with the following OMSA versions:\n\n* `7.4`\n* `8.4`\n* `9.1`\n\n### Kernel Compatibility\n\n**Please note that only kernel versions that are supported by DELL DSU / OMSA tools are working!**\n\n**State 07.06.2019**: Dell OMSA `DSU_19.05.00` is not compatible with 5.x kernel it seems (e.g., Fedora uses that kernel).\n\nShould you run into issues when using the Container image, please follow the [Troubleshooting - No metrics being exported](#no-metrics-being-exported).\n\n## Collectors\n\nFor a list of the available collectors, see [Collectors doc page](docs/collectors.md).\n\n## Configuration\n\nFor flags and environment variables, see [Configuration doc page](docs/configuration.md).\n\n## Caching\n\nOptional caching can be enabled to prevent performance issues caused by this exporter, see [Caching doc page](caching.md).\n\n## Running in Container\n\nContainer Image available from:\n\n* [Quay.io](https://quay.io/repository/galexrt/dellhw_exporter)\n* [GHCR.io](https://github.com/users/galexrt/packages/container/package/dellhw_exporter)\n\n(Docker Hub is not receiving new images begining from release `v1.10.0`)\n\n### Pull the Container Image\n\nEach Git tag is built and published as a release and container image.\n\n#### Quay.io\n\n```console\ndocker pull quay.io/galexrt/dellhw_exporter\n```\n\n#### GHCR.IO\n\n```console\ndocker pull ghcr.io/galexrt/dellhw_exporter\n```\n\n### Run the Container Image\n\n\u003e **NOTE** The `--privileged` flag is required as the OMSA needs to access the host's devices and other components.\n\n```console\ndocker run -d --name dellhw_exporter --privileged -p 9137:9137 quay.io/galexrt/dellhw_exporter\n```\n\n## Running without Docker / Podman\n\nTo run without Docker / Podman either download a [release binary](https://github.com/galexrt/dellhw_exporter/releases) or build it (using `make build` command):\n\n```console\n./dellhw_exporter\n./dellhw_exporter --help\n./dellhw_exporter [YOUR_FLAGS]\n```\n\n**The DELL OMSA services must already be running for the exporter to be able to collect metrics!**\n\nE.g., run `/opt/dell/srvadmin/sbin/srvadmin-services.sh start` or `systemctl start SERVICE_NAME` (to enable autostart on use `systemctl enable SERVICE_NAME`; where `SERVICE_NAME` [are the DELL OMSA service(s) you installed](http://linux.dell.com/repo/hardware/omsa.html)).\n\n## Prometheus\n\nThe exporter by default runs on port `9137` TCP.\n\nExample static Prometheus Job config:\n\n```yaml\n[...]\n  - job_name: 'dellhw_exporter'\n    # Override the global default and scrape targets from this job every 60 seconds.\n    scrape_interval: 60s\n    static_configs:\n      - targets:\n        - 'YOUR_EXPORTER_SERVER_HERE:9137'\n[...]\n```\n\n## Monitoring\n\nCheckout the files in the [`contrib/monitoring/`](contrib/monitoring/) directory.\n\n## Installation\n\nSee [Installation doc page](docs/installation.md).\n\n## Troubleshooting\n\nSee [Troubleshooting doc page](docs/troubleshooting.md).\n\n## Development\n\nGolang version `1.23` is used for testing and building the dellhw_exporter.\n\n`go mod` is used for \"vendoring\" of the dependencies.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgalexrt%2Fdellhw_exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgalexrt%2Fdellhw_exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgalexrt%2Fdellhw_exporter/lists"}