Pleroma/docs/development/API/prometheus.md
Ilja 6284e8f4b2 Add development section
* I cretaed a folder 'development'
* I split up the file dev.md into three parts and moved it to this folder
  * index.md
  * authentication_authorization.md
  * mrf.md
* I also moved ap_extensions.md
* I created a new file setting_up_pleroma_dev.md
2021-01-10 08:25:36 +00:00

1.2 KiB

Prometheus Metrics

Pleroma includes support for exporting metrics via the prometheus_ex library.

Config example:

config :prometheus, Pleroma.Web.Endpoint.MetricsExporter,
  enabled: true,
  auth: {:basic, "myusername", "mypassword"},
  ip_whitelist: ["127.0.0.1"],
  path: "/api/pleroma/app_metrics",
  format: :text
  • enabled (Pleroma extension) enables the endpoint
  • ip_whitelist (Pleroma extension) could be used to restrict access only to specified IPs
  • auth sets the authentication (false for no auth; configurable to HTTP Basic Auth, see prometheus-plugs documentation)
  • format sets the output format (:text or :protobuf)
  • path sets the path to app metrics page

/api/pleroma/app_metrics

Exports Prometheus application metrics

  • Method: GET
  • Authentication: not required by default (see configuration options above)
  • Params: none
  • Response: text

Grafana

Config example

The following is a config example to use with Grafana

  - job_name: 'beam'
    metrics_path: /api/pleroma/app_metrics
    scheme: https
    static_configs:
    - targets: ['pleroma.soykaf.com']