Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/status-im/geth_exporter
geth metrics exporter for Prometheus
https://github.com/status-im/geth_exporter
blockchain ethereum geth go golang metrics prometheus prometheus-exporter
Last synced: 8 days ago
JSON representation
geth metrics exporter for Prometheus
- Host: GitHub
- URL: https://github.com/status-im/geth_exporter
- Owner: status-im
- License: mpl-2.0
- Created: 2018-05-18T08:57:30.000Z (over 6 years ago)
- Default Branch: develop
- Last Pushed: 2019-12-07T11:36:59.000Z (almost 5 years ago)
- Last Synced: 2023-04-11T01:06:02.404Z (over 1 year ago)
- Topics: blockchain, ethereum, geth, go, golang, metrics, prometheus, prometheus-exporter
- Language: Go
- Size: 1.3 MB
- Stars: 14
- Watchers: 8
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# WARNING: This software is deprecated since Geth `1.9.0` which introduced its own [Prometheus endpoint](https://blog.ethereum.org/2019/07/10/geth-v1-9-0/#metrics-collection).
# geth_exporter
`geth_exporter` is a metrics exporter for [Prometheus](https://github.com/prometheus/prometheus).
## Usage
```
go build && \
./geth_exporter -ipc node/data/path/geth.ipc -filter="whisper_*" -filter="les_*"
```
## Docker example
```
cd docker-example
docker-compose up
```
At `http://localhost:9200/metrics` you will have the `geth_exporter`, it should send a response similar to this:
```
discv5_inboundTraffic_avgRate01Min 2981
discv5_inboundTraffic_avgRate05Min 2981
discv5_inboundTraffic_avgRate15Min 2981
discv5_inboundTraffic_meanRate 3591.687045952474
discv5_inboundTraffic_overall 18213
discv5_outboundTraffic_avgRate01Min 1733.4
discv5_outboundTraffic_avgRate05Min 1733.4
discv5_outboundTraffic_avgRate15Min 1733.4
discv5_outboundTraffic_meanRate 2356.6951261606164
....
```
At `http://localhost:9090/graph` you can use Prometheus to query the exporter.
At `http://localhost:3000/` you can log in to grafana with username `admin` and password `admin`.
## Continous Deployment
To make possible deploying the new version of the page from the `develop` branch a Jenkins job is configured at:
https://jenkins.status.im/job/misc/job/geth_exporter/
This job is ran according to the [`Jenkinsfile`](Jenkinsfile) configuration.
In order for this to work there are two requirements:
* The `status-im-auto` user which API token is used needs to have at least write access.
* The repo has to have the https://jenkins.status.im/github-webhook/ webhook configured.
In order to push a new docker image the `statusteamauto` user on DokerHub needs to have access to:
https://hub.docker.com/r/statusteam/geth_exporter/