elli_prometheus

Elli middleware for collecting stats via Prometheus.


Keywords
elli, metrics-gathering, middleware, prometheus, statistics
License
BSD-1-Clause

Documentation

elli_prometheus

Hex.pm Documentation Erlang Travis CI Coveralls BSD-3 License

Elli middleware for collecting stats via Prometheus.

Metrics

How Elli represents timings:

request_start
    headers_start
    ...headers receiving &  parsing...
    headers_end

    body_start
    ...body receiving & parsing...
    body_end

    user_start
    ...callback code...
    user_end

   send_start
   ...sending reply....
   send_end
request_end

How Elli represents sizes:

Each request has resp_headers key and, depending on response type, resp_body or file or chunks key.

  • resp_header is always present and denotes response headers wire size;
  • resp_body set for regular responses;
  • file set for file responses;
  • chunks set for chunked responses, wire size too.

Elli_prometheus exports the following metrics:

  • http_requests_total, counter. Total count of requests;

  • http_request_duration_microseconds, histogram. The difference between request_end and request_start;

  • http_request_headers_microseconds, histogram. The difference between headers_end and headers_start;

  • http_request_body_microseconds, histogram. The difference between body_end and body_start;

  • http_request_user_microseconds, histogram. The difference between user_end and user_start;

  • http_request_send_microseconds, histogram. The difference between send_end and send_start;

  • http_response_size_bytes, summary. Total size of the response, includes headers, body|file|chuncks;

  • http_response_headers_size_bytes, summary. Size of the response headers;

  • http_response_body_size, summary. Size of the response body;

For failed requests:

  • http_requests_failed_total{reason}, Total count of failed requests. Reasons:
    • request_closed - the client closes the connection when Elli is waiting for the next request;
    • request_timeout - the client times out when Elli is waiting for the request;
    • request_parse_error - the request is invalid and cannot be parsed or it contains a path Elli cannot parse or doesn't support;
    • client_closed - the client closes the connection or socket closed unexpectedly;
    • client_timeout - data can't be received within a timeout;
    • bad_request - Elli detects a request isn't well formatted or doesn't conform to the configured limits.
  • http_bad_requests_total{reason} - Total count of bad_request errors. Reasons:
    • too_many_headers;
    • body_size.
  • http_client_closed_total{request_part} - Total count of client_closed errors. Parts:
    • receiving_headers;
    • receiving_body;
    • before_response.
  • http_client_timeout_total{request_part} Total count of client_timeout errors. Parts:
    • receiving_headers;
    • receiving_body.

Exporter metrics:

  • telemetry_scrape_duration_seconds
    Type: summary.
    Labels: registry, content_type.
    Scrape duration.

  • telemetry_scrape_size_bytes
    Type: summary.
    Labels: registry, content_type.
    Scrape size, not encoded.

  • telemetry_scrape_encoded_size_bytes
    Type: summary.
    Labels: registry, content_type, encoding.
    Scrape size, encoded.

Dependencies

elli_prometheus requires Elli and Prometheus, but neither are included in this project. It has been tested and is known to work with {elli, "2.0.1"} and {prometheus, "3.1.1"}.