Skip to main content

Prometheus Metrics

MyDash exposes application metrics in Prometheus text exposition format for monitoring, alerting, and operational dashboards.

Endpoints

MethodEndpointDescription
GET/api/metricsPrometheus metrics (admin-only, no CSRF)
GET/api/healthHealth check (database connectivity)

Metrics

MetricTypeDescription
mydash_infogaugeApp version, PHP version, Nextcloud version
mydash_upgaugeWhether the application is up
mydash_dashboards_total{type}gaugeDashboard count by type
mydash_widgets_totalgaugeTotal widget placements
mydash_tiles_totalgaugeTotal tiles

Health Check Response

{"status": "ok", "checks": {"database": "ok"}}

Notes

  • Metrics computed on-demand (no persistent storage)
  • Content-Type: text/plain; version=0.0.4; charset=utf-8
  • @NoCSRFRequired for external monitoring tool access

Screenshot

Dashboard Overview