logo

pleroma

My custom branche(s) on git.pleroma.social/pleroma/pleroma git clone https://hacktivis.me/git/pleroma.git

prometheus.md (1683B)

    

  1. # Prometheus / OpenTelemetry Metrics
  3. Pleroma includes support for exporting metrics via the [prom_ex](https://github.com/akoutmos/prom_ex) library.
  4. The metrics are exposed by a dedicated webserver/port to improve privacy and security.
  6. Config example:
  8. ```
  9. config :pleroma, Pleroma.PromEx,
  10.   disabled: false,
  11.   manual_metrics_start_delay: :no_delay,
  12.   drop_metrics_groups: [],
  13.   grafana: [
  14.     host: System.get_env("GRAFANA_HOST", "http://localhost:3000"),
  15.     auth_token: System.get_env("GRAFANA_TOKEN"),
  16.     upload_dashboards_on_start: false,
  17.     folder_name: "BEAM",
  18.     annotate_app_lifecycle: true
  19.   ],
  20.   metrics_server: [
  21.     port: 4021,
  22.     path: "/metrics",
  23.     protocol: :http,
  24.     pool_size: 5,
  25.     cowboy_opts: [],
  26.     auth_strategy: :none
  27.   ],
  28.   datasource: "Prometheus"
  30. ```
  32. PromEx supports the ability to automatically publish dashboards to your Grafana server as well as register Annotations. If you do not wish to configure this capability you must generate the dashboard JSON files and import them directly. You can find the mix commands in the upstream [documentation](https://hexdocs.pm/prom_ex/Mix.Tasks.PromEx.Dashboard.Export.html). You can find the list of modules enabled in Pleroma for which you should generate dashboards for by examining the contents of the `lib/pleroma/prom_ex.ex` module.
  34. ## prometheus.yml
  36. The following is a bare minimum config example to use with [Prometheus](https://prometheus.io) or Prometheus-compatible software like [VictoriaMetrics](https://victoriametrics.com).
  38. ```
  39. global:
  40.   scrape_interval: 15s
  42. scrape_configs:
  43.   - job_name: 'pleroma'
  44.     scheme: http
  45.     static_configs:
  46.     - targets: ['pleroma.soykaf.com:4021']
  47. ```