Skip to content

Latest commit

 

History

History
45 lines (34 loc) · 1.48 KB

README.md

File metadata and controls

45 lines (34 loc) · 1.48 KB
Raw

prometheus-localfile-metrics

Build Status

Docker image: boskiv/prometheus-localfile-metrics

What is PLM

PLM stands for Prometheus Localfile Metrics

How it works

Monitored application periodically writes metric to files, with one metric per file. Files are written to a volume (eg emptyDir) shared between the monitored application and the exporter (eg sidecar pattern). When /metrics is requested, the exporter walks the files and produces metrics, with each metric name derived from the file path and each metric value directly read from the file content.

  • App scan directory in PLM_STATS_PATH recursively
  • find all files and folders
  • make stat name from PLM_PREFIX variable and relative dir path to PLM_STATS_PATH and filename
  • get metric value from file content (eg 100)
  • listen 9102 port and endpoint /metric for prometheus request
  • response with string, separated with \n
➜  ~ curl localhost:9102/metrics
myapp_ccu 100
myapp_cps 200
myapp_rps 300

Kubernetes usage

Prerequisite

kubernetes + helm

helm repo add coreos https://s3-eu-west-1.amazonaws.com/coreos-charts/stable/
helm install coreos/prometheus-operator --name prometheus-operator --namespace monitoring
helm install coreos/kube-prometheus --name kube-prometheus --namespace monitoring

Example

Look at example/README.md