Apache HTTP Server (HTTPD) Metrics Source

The Vector apache_metrics source collects metrics from Apache HTTP server (HTTPD).

Requirements

Configuration

[sources.my_source_id]
type = "apache_metrics" # required
endpoints = ["http://localhost:8080/server-status/?auto"] # required
scrape_interval_secs = 15 # optional, default, seconds
  • commonrequired[string]

    endpoints

    mod_status endpoints to scrape metrics from.

  • optionalstring

    namespace

    The namespace of the metric. Disabled if empty.

    • Syntax: literal
    • Default: "apache"
  • commonoptionaluint

    scrape_interval_secs

    The interval between scrapes.

    • Default: 15 (seconds)

Output

This component outputs the following metric events:

  • counter

    access_total

    The total number of time the Apache server has been accessed. This metric includes the following tags:

    • endpoint - The absolute path of originating file.

    • host - The hostname of the Apache HTTP server.

  • gauge

    connections

    The total number of time the Apache server has been accessed. This metric includes the following tags:

    • endpoint - The absolute path of originating file.

    • host - The hostname of the Apache HTTP server.

    • state - The state of the connection

  • gauge

    cpu_load

    The current CPU of the Apache server. This metric includes the following tags:

    • endpoint - The absolute path of originating file.

    • host - The hostname of the Apache HTTP server.

  • counter

    cpu_seconds_total

    The CPU time of various Apache processes. This metric includes the following tags:

    • endpoint - The absolute path of originating file.

    • host - The hostname of the Apache HTTP server.

    • state - The state of the connection

  • counter

    duration_seconds_total

    The amount of time the Apache server has been running. This metric includes the following tags:

    • endpoint - The absolute path of originating file.

    • host - The hostname of the Apache HTTP server.

  • gauge

    scoreboard

    The amount of times various Apache server tasks have been run. This metric includes the following tags:

    • endpoint - The absolute path of originating file.

    • host - The hostname of the Apache HTTP server.

    • state - The connect state

  • counter

    sent_bytes_total

    The amount of bytes sent by the Apache server. This metric includes the following tags:

    • endpoint - The absolute path of originating file.

    • host - The hostname of the Apache HTTP server.

  • gauge

    up

    If the Apache server is up or not. This metric includes the following tags:

    • endpoint - The absolute path of originating file.

    • host - The hostname of the Apache HTTP server.

  • counter

    uptime_seconds_total

    The amount of time the Apache server has been running. This metric includes the following tags:

    • endpoint - The absolute path of originating file.

    • host - The hostname of the Apache HTTP server.

  • gauge

    workers

    Apache worker statuses. This metric includes the following tags:

    • endpoint - The absolute path of originating file.

    • host - The hostname of the Apache HTTP server.

    • state - The state of the worker

Telemetry

This component provides the following metrics that can be retrieved through the internal_metrics source. See the metrics section in the monitoring page for more info.

  • counter

    http_error_response_total

    The total number of HTTP error responses for this component. This metric includes the following tags:

    • instance - The Vector instance identified by host and port.

    • job - The name of the job producing Vector metrics.

  • counter

    http_request_errors_total

    The total number of HTTP request errors for this component. This metric includes the following tags:

    • instance - The Vector instance identified by host and port.

    • job - The name of the job producing Vector metrics.

  • counter

    parse_errors_total

    The total number of errors parsing metrics for this component. This metric includes the following tags:

    • instance - The Vector instance identified by host and port.

    • job - The name of the job producing Vector metrics.

  • counter

    processed_bytes_total

    The total number of bytes processed by the component. This metric includes the following tags:

    • component_kind - The Vector component kind.

    • component_name - The Vector component ID.

    • component_type - The Vector component type.

    • instance - The Vector instance identified by host and port.

    • job - The name of the job producing Vector metrics.

  • counter

    processed_events_total

    The total number of events processed by this component. This metric includes the following tags:

    • component_kind - The Vector component kind.

    • component_name - The Vector component ID.

    • component_type - The Vector component type.

    • file - The file that produced the error

    • instance - The Vector instance identified by host and port.

    • job - The name of the job producing Vector metrics.

  • counter

    requests_completed_total

    The total number of requests completed by this component. This metric includes the following tags:

    • component_kind - The Vector component kind.

    • component_name - The Vector component ID.

    • component_type - The Vector component type.

    • instance - The Vector instance identified by host and port.

    • job - The name of the job producing Vector metrics.

  • counter

    events_out_total

    The total number of events emitted by this component. This metric includes the following tags:

    • component_kind - The Vector component kind.

    • component_name - The Vector component ID.

    • component_type - The Vector component type.

    • instance - The Vector instance identified by host and port.

    • job - The name of the job producing Vector metrics.

  • histogram

    request_duration_nanoseconds

    The total request duration in nanoseconds. This metric includes the following tags:

    • instance - The Vector instance identified by host and port.

    • job - The name of the job producing Vector metrics.

How It Works

Context

By default, the apache_metrics source will augment events with helpful context keys as shown in the "Output" section.

State

This component is stateless, meaning its behavior is consistent across each input.