https://github.com/amirhnajafiz/prometheus-digger
Digging deep into prometheus metrics.
https://github.com/amirhnajafiz/prometheus-digger
go golang metrics prometheus prometheus-exporter prometheus-operator
Last synced: 7 months ago
JSON representation
Digging deep into prometheus metrics.
- Host: GitHub
- URL: https://github.com/amirhnajafiz/prometheus-digger
- Owner: amirhnajafiz
- Created: 2022-09-08T05:17:09.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-08T00:03:35.000Z (7 months ago)
- Last Synced: 2025-03-08T01:18:32.202Z (7 months ago)
- Topics: go, golang, metrics, prometheus, prometheus-exporter, prometheus-operator
- Homepage:
- Size: 2.22 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Prometheus Digger
Prometheus Digger is a tool designed to help you extract and analyze metrics from a Prometheus server. This tool allows you to specify a time range and interval for the metrics you want to retrieve.
## Features
- Extract metrics/queries from a Prometheus server
- Specify custom time ranges
- Define intervals for metric retrieval
- Adaptive pulling method based on the given query
## Usage
To build and run Prometheus Digger, follow these steps:
1. Build the project:
```sh
go build -o pdigger
chmod +x ./pdigger
```
2. Run the executable:
```sh
./pdigger
```
## Parameters
Copy the example config file from `config/config.example.json` into `config.json`. You the following fields:
- `url`: The URL of the Prometheus server. (default is http://localhost:9090)
- `from`: The start time for the metrics in ISO 8601 format. (2025-03-07T00:00:00Z)
- `to`: The end time for the metrics in ISO 8601 format. (2025-03-07T00:00:00Z)
- `queries`: A list of metrics and queries to dig
- `queries.interval`: The interval at which to retrieve metrics. ("1m", "1h", "30s")
- `queries.name`: The output directory of the query, also a label for logs and debugging.
- `queries.metric`: Input PromQL.
## Example
Here is an example command to retrieve power usage metrics from a Prometheus server:
```sh
{
"url": "http://127.0.0.1:9090",
"from": "2025-03-07T00:00:00Z",
"to": "2025-03-08T00:00:00Z",
"queries": [
{
"name": "GPU_POWER_USAGE",
"metric": "DCGM_FI_DEV_GPU_TEMP",
"interval": "1m"
}
]
}
```
This command will retrieve the `DCGM_FI_DEV_POWER_USAGE` metric from the Prometheus server at `http://127.0.0.1:9090` for the time range from March 7, 2025, to March 8, 2025, with a 1-minute interval.