Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trpc-ecosystem/go-metrics-prometheus
tRPC-Go prometheus metrics plugin
https://github.com/trpc-ecosystem/go-metrics-prometheus
Last synced: 23 days ago
JSON representation
tRPC-Go prometheus metrics plugin
- Host: GitHub
- URL: https://github.com/trpc-ecosystem/go-metrics-prometheus
- Owner: trpc-ecosystem
- License: other
- Created: 2023-08-29T08:31:47.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-10-24T12:06:48.000Z (about 1 year ago)
- Last Synced: 2024-11-29T07:51:12.536Z (about 2 months ago)
- Language: Go
- Size: 58.6 KB
- Stars: 0
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE-OF-CONDUCT.md
Awesome Lists containing this project
README
English | [中文](README.zh_CN.md)
# tRPC-Go prometheus metrics plugin
[](https://pkg.go.dev/github.com/trpc-ecosystem/go-metrics-prometheus)
[](https://goreportcard.com/report/trpc.group/trpc-go/trpc-metrics-prometheus)
[](https://github.com/trpc-ecosystem/go-metrics-prometheus/blob/main/LICENSE)
[](https://github.com/trpc-ecosystem/go-metrics-prometheus/releases)
[](https://github.com/trpc-ecosystem/go-metrics-prometheus/actions/workflows/prc.yml)
[](https://app.codecov.io/gh/trpc-ecosystem/go-metrics-prometheus/tree/main)
## Config
```yaml
plugins: #Plugin configuration.
metrics: #Reference metrics.
prometheus: #Start prometheus.
ip: 0.0.0.0 #Prometheus bind address.
port: 8090 #Prometheus bind port.
path: /metrics #Metrics path.
namespace: Development #Namespace.
subsystem: trpc #Subsystem.
rawmode: false #Raw mode, no conversion of special characters for metrics.
enablepush: true #Enable push mode, not enabled by default.
gateway: http://localhost:9091 #Prometheus gateway address.
password: username:MyPassword #Set the account password, username and MyPassword are split by a colon.
job: job #Job name.
pushinterval: 1 #Push data every 1 second by default
```
## Tutorial
### Reference prometheus
Reference it in main.go and configure the parameters in yaml.
```golang
import _ "trpc.group/trpc-go/trpc-metrics-prometheus"
```
### Report data
trpc metrics usage guidelines [trpc metrics](https://github.com/trpc-group/trpc-go/blob/main/metrics/README.md)
## Query reported data
Query the metrics locally via curl to see if the metrics were generated successfully.
```bash
curl ${ip}:${port}/$path |grep ${namespace}_${subsystem}
```
## Report call data
Add configuration
```yaml
filter:
- prometheus #Add prometheus filter
```
The call data currently supports both Histogram for request time and SUM for request volume.
The metric names are prefixed with ClientFilter and ServerFilter.
## Notice
1. Prometheus currently only supports PolicySUM/PolicySET/PolicyHistogram type reporting, other types of support please submit pr.
2. Prometheus metric does not support Chinese and special characters, illegal characters will be automatically converted to '_' in the acsii table, Chinese and other utf8 characters are converted to the corresponding data, such as "trpc.Chinese metric" -> "trpc_20013_25991_25351_26631_", close this function can be used to set rawmode is true, exception reporting will fail directly.
3. The plugin only provides exporter, not Pushgateway and Prometheus server.
4. Multi-dimension reporting uses the metrics.NewMultiDimensionMetricsX interface to set multi-dimension names, otherwise conflicts may occur.
5. If you need to push custom data, you can call the GetDefaultPusher method after the plugin is initialized, otherwise the returned pusher is empty.