Skip to main content

Prometheus operations

v0.1.12

Server status, target health, alertmanager linkage, instant + range queries, rule listing, TSDB stats, plus admin-API actions for remediation: reload config, take snapshot, clean tombstones, delete series. Admin endpoints require --web.enable-admin-api + --web.enable-lifecycle.

11 allowed by default 3 need approval by default
Pack ID
prometheus
Vendor
emisar
OS
linux
Actions
14
Required binaries. Install these on the host before relying on the pack — an action that calls a missing one fails at run time.
curl

Install

emisar pack install fetches this pack, re-validates it, and verifies its content hash against the --hash below — the exact bytes this page was rendered against, so a tampered copy is rejected — before copying it into the runner's packs dir. The command reloads a running daemon itself; no manual restart.

on the runner host
sudo emisar pack install prometheus --hash sha256:8c5731030c10582d928e32883d5d5a50cf723cf13e501f49208abefe13428f9d

Actions 14 total

View on GitHub
  • prom.alertmanagers exec low

    GET /api/v1/alertmanagers

    List configured Alertmanager endpoints + their reachability.

    View source on GitHub
  • prom.alerts exec low

    GET /api/v1/alerts

    List currently active alerts (pending or firing).

    View source on GitHub
  • prom.build_info exec low

    GET /api/v1/status/buildinfo

    Show Prometheus version + build details.

    View source on GitHub
  • prom.clean_tombstones exec high

    POST /api/v1/admin/tsdb/clean_tombstones

    Reclaim disk space after a delete_series call. Tombstones are removed and the data they marked is permanently deleted.

    View source on GitHub
  • prom.delete_series exec high

    POST /api/v1/admin/tsdb/delete_series

    Mark series matching the matcher as deleted (tombstoned). Series no longer return from queries. Run clean_tombstones afterwards to actually reclaim disk. Use to remove cardinality-explosion mistakes or accidentally-recorded secrets. Match pattern is restricted to safe label-selector characters.

    View source on GitHub
  • prom.flags exec low

    GET /api/v1/status/flags

    Show server command-line flags.

    View source on GitHub
  • prom.query_instant exec low

    GET /api/v1/query

    Run an instant PromQL query. Use to answer 'what's X right now?'.

    View source on GitHub
  • prom.query_range exec low

    GET /api/v1/query_range

    Run a range PromQL query (one expr, over a window). Use for trends.

    View source on GitHub
  • prom.reload_config exec high

    POST /-/reload

    Trigger Prometheus to reload its config + rule files in place. Requires --web.enable-lifecycle. If the new config is invalid, reload fails and Prometheus keeps the old one.

    View source on GitHub
  • prom.rules exec low

    GET /api/v1/rules

    List all loaded recording + alerting rules with last evaluation result.

    View source on GitHub
  • prom.runtime_info exec low

    GET /api/v1/status/runtimeinfo

    Show uptime, last config reload, chunk count, WAL corrected/unprocessed.

    View source on GitHub
  • prom.snapshot exec medium

    POST /api/v1/admin/tsdb/snapshot

    Trigger an on-disk snapshot of the TSDB into data/snapshots/. Requires --web.enable-admin-api. Used before risky upgrades or for offline diff. Uses hardlinks initially — no extra disk until blocks rotate.

    View source on GitHub
  • prom.targets exec low

    GET /api/v1/targets

    List all scrape targets with state (up/down) and last error.

    View source on GitHub
  • prom.tsdb_stats exec low

    GET /api/v1/status/tsdb

    Show the top-10 cardinal label/value pairs in the TSDB. Use to spot cardinality explosion.

    View source on GitHub