Prometheus

hitspec exposes a Prometheus-compatible metrics endpoint during stress tests, allowing you to scrape metrics into Prometheus and visualize them in Grafana.

Setup

hitspec run api.http --stress -d 5m -r 100 \
  --metrics prometheus \
  --metrics-port 9090

Metrics are available at http://localhost:9090/metrics while the stress test runs. The endpoint listens on 127.0.0.1 only. To let a Prometheus server on another machine scrape it, bind another interface with --metrics-host 0.0.0.0 (env: HITSPEC_METRICS_HOST); the metrics are not authenticated, so expose them only on a trusted network. The numbers are updated every second during the run, so a scrape in the middle of a test sees the current totals, not zeros.

Prometheus Configuration

Add hitspec as a scrape target in your prometheus.yml:

scrape_configs:
  - job_name: 'hitspec'
    scrape_interval: 5s
    static_configs:
      - targets: ['localhost:9090']

Available Metrics

Metric	Type	Description
`hitspec_requests_total`	Counter	Total number of requests
`hitspec_requests_success_total`	Counter	Successful requests
`hitspec_requests_failed_total`	Counter	Failed requests
`hitspec_request_duration_ms{quantile="..."}`	Gauge	Request duration in milliseconds: `min`, `max`, `avg`, and the `0.50`, `0.95` and `0.99` quantiles
`hitspec_requests_by_status_total{status="..."}`	Counter	Requests by HTTP status code
`hitspec_test_requests_total{test="..."}`	Counter	Requests per named test
`hitspec_test_duration_avg_ms{test="..."}`	Gauge	Average request duration per named test

Custom Port

hitspec run api.http --stress -d 5m -r 100 \
  --metrics prometheus \
  --metrics-port 9100

Environment variables: HITSPEC_METRICS_PORT, HITSPEC_METRICS_HOST

Last modified on October 19, 2026

Getting Started

Core Concepts

Features

Guides

Examples

CLI Reference

Configuration

Assertions Reference

Built-in Functions

Authentication

Output Formats

Integrations

Setup

Prometheus Configuration

Available Metrics

Custom Port