{"id":13581538,"url":"https://github.com/dodopizza/prometheus-shell-exporter","last_synced_at":"2026-01-03T10:04:42.592Z","repository":{"id":40583464,"uuid":"355161767","full_name":"dodopizza/prometheus-shell-exporter","owner":"dodopizza","description":"prometheus-shell-exporter","archived":false,"fork":false,"pushed_at":"2023-05-22T21:00:42.000Z","size":152,"stargazers_count":36,"open_issues_count":1,"forks_count":7,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-05T21:44:44.703Z","etag":null,"topics":["go","golang","infra","prometheus","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":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dodopizza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-04-06T11:20:18.000Z","updated_at":"2024-08-26T16:46:29.000Z","dependencies_parsed_at":"2024-01-16T21:37:19.324Z","dependency_job_id":null,"html_url":"https://github.com/dodopizza/prometheus-shell-exporter","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dodopizza%2Fprometheus-shell-exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dodopizza%2Fprometheus-shell-exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dodopizza%2Fprometheus-shell-exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dodopizza%2Fprometheus-shell-exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dodopizza","download_url":"https://codeload.github.com/dodopizza/prometheus-shell-exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247470360,"owners_count":20944146,"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":["go","golang","infra","prometheus","prometheus-exporter"],"created_at":"2024-08-01T15:02:05.080Z","updated_at":"2026-01-03T10:04:42.586Z","avatar_url":"https://github.com/dodopizza.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Prometheus Shell Exporter\n\nShell Exporter can execute `Powershell` or `Bash` scripts and transform its output to Prometheus metrics.\n\n## Metrics\n\nShell Exporter exposes metrics based on your `Powershell` or `Bash` scripts names. Examples of scripts can be finded at `metrics` folder\n\n| Script name                                      | Metric name                                  |\n| ------------------------------------------------ | -------------------------------------------- |\n| `bash_gauge.sh`                                  | `bash_gauge`                                 |\n| `pse_tcp_connection_metrics.ps1`                 | `pse_tcp_connection_metrics`                 |\n| `pse_tcp_dynamic_port_range_number_of_ports.ps1` | `pse_tcp_dynamic_port_range_number_of_ports` |\n\n## Startup options\n\n| Option    | Default value | Description           |\n| --------- | ------------- | --------------------- |\n| --f       | `./metrics`   | scripts directory     |\n| --port    | 9360          | exporter port         |\n| --help    | -             | show help             |\n| --version | -             | show exporter version |\n\n## Installing as Windows Service\n\n1. Download binary\n2. Install [nssm](https://nssm.cc/) via [Chocolatey](https://community.chocolatey.org/packages/NSSM)\n\n| Action  | Command                                                         |\n| ------- | --------------------------------------------------------------- |\n| install | nssm install shell_exporter C:\\shell-exporter.exe -f C:\\scripts |\n| remove  | nssm remove shell_exporter confirm                              |\n\n## Development\n\n1. Make branch from `master`\n2. Reopen repo at [vscode container](https://code.visualstudio.com/docs/remote/containers)\n3. Make necessary changes\n4. Push it to branch and make pull-request\n\n### Makefile targets\n\n| Target | Action                                                                                  |\n| ------ | --------------------------------------------------------------------------------------- |\n| build  | build binary for `linux` and `windows` platforms                                        |\n| tidy   | remove all dependencies from the go.mod file which are not required in the source files |\n| test   | run unit tests                                                                          |\n| lint   | run linting                                                                             |\n| run    | run exporter locally                                                                    |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdodopizza%2Fprometheus-shell-exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdodopizza%2Fprometheus-shell-exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdodopizza%2Fprometheus-shell-exporter/lists"}