Stackstate-Lighttpd Integration

Overview

Bring Lighttpd metrics to StackState to:

  • Visualize your web server performance.
  • Correlate the performance of Ligttpd with the rest of your applications.

Setup

Installation

Make sure that mod_status is installed on your Lighttpd server

Configuration

  1. Configure the Agent to connect to Lighttpd. Edit conf.d/lighttpd.yaml
    init_config:
    
    instances:
        # For every instance, you have an `lighttpd_status_url` and (optionally)
        # a list of tags.
    
        -   lighttpd_status_url: http://example.com/server-status?auto
            tags:
                -   instance:foo
    
  2. Restart the Agent

Validation

Execute the info command and verify that the integration check has passed. The output of the command should contain a section similar to the following:

Checks
======

  [...]

  lighttpd
  --------
      - instance #0 [OK]
      - Collected 8 metrics & 0 events

Data Collected

Metrics

The following metrics are collected for either Lighttpd1 and Lighttpd2:

lighttpd.performance.idle_server
(gauge)
The number of idle connections.
shown as connection
lighttpd.performance.busy_servers
(gauge)
The number of active connections.
shown as connection
lighttpd.performance.uptime
(gauge)
The amount of time the server has been up and running.
shown as second
lighttpd.net.bytes
(gauge)
The number of bytes sent and received since start.
shown as byte
lighttpd.net.hits
(gauge)
The number of hits since start.
shown as hit
lighttpd.performance.memory_usage
(gauge)
The amount of memory used by the server.
shown as byte
lighttpd.net.requests_avg
(gauge)
The average number of requests per second since start.
shown as request
lighttpd.net.bytes_out_avg
(gauge)
The average number of bytes sent per second since start.
shown as byte
lighttpd.net.bytes_in_avg
(gauge)
The average number of bytes received per second since start.
shown as byte
lighttpd.net.connections_avg
(gauge)
The average number of connections per second since start.
shown as connection
lighttpd.connections.state_start
(gauge)
The number of active connections in the state of initializing the read-idle timer.
shown as connection
lighttpd.connections.state_read_header
(gauge)
The number of active connections in the state of reading the http request header.
shown as connection
lighttpd.connections.state_handle_request
(gauge)
The number of active connections in the state of handling the request internally.
shown as connection
lighttpd.connections.state_write_response
(gauge)
The number of active connections in the state of writing the response to the network.
shown as connection
lighttpd.connections.state_keep_alive
(gauge)
The number of idle connections.
shown as connection
lighttpd.net.requests_avg_5sec
(gauge)
The average number of requests per second in the past 5 seconds.
shown as request
lighttpd.net.bytes_out_avg_5sec
(gauge)
The average number of bytes sent per second in the past 5 seconds.
shown as byte
lighttpd.net.bytes_in_avg_5sec
(gauge)
The average number of bytes received per second in the past 5 seconds.
shown as byte
lighttpd.net.connections_avg_5sec
(gauge)
The average number of connections per second in the past 5 seconds.
shown as connection
lighttpd.net.requests_total
(rate)
The number of requests per second.
shown as request
lighttpd.net.bytes_out
(rate)
The number of bytes sent per second.
shown as byte
lighttpd.net.bytes_in
(rate)
The number of bytes received per second.
shown as byte
lighttpd.net.connections_total
(rate)
The total number of connections per second.
shown as connection
lighttpd.response.status_1xx
(rate)
The number of 1xx status codes generated per second.
shown as response
lighttpd.response.status_2xx
(rate)
The number of 2xx status codes generated per second.
shown as response
lighttpd.response.status_3xx
(rate)
The number of 3xx status codes generated per second.
shown as response
lighttpd.response.status_4xx
(rate)
The number of 4xx status codes generated per second.
shown as response
lighttpd.response.status_5xx
(rate)
The number of 5xx status codes generated per second.
shown as response
lighttpd.net.bytes_per_s
(gauge)
The number of bytes sent and received per second.
shown as byte
lighttpd.net.request_per_s
(gauge)
The number of requests per second.
shown as request
Metrics collected for Lighttpd1
lighttpd.net.bytes
lighttpd.net.bytes_per_s
lighttpd.net.hits
lighttpd.net.request_per_s
lighttpd.performance.busy_servers
lighttpd.performance.idle_server
lighttpd.performance.uptime
Metrics collected for Lighttpd2
lighttpd.connections.state_handle_request
lighttpd.connections.state_keep_alive
lighttpd.connections.state_read_header
lighttpd.connections.state_start
lighttpd.connections.state_write_response
lighttpd.net.bytes_in
lighttpd.net.bytes_in_avg
lighttpd.net.bytes_in_avg_5sec
lighttpd.net.bytes_out
lighttpd.net.bytes_out_avg
lighttpd.net.bytes_out_avg_5sec
lighttpd.net.connections_avg
lighttpd.net.connections_avg_5sec
lighttpd.net.connections_total
lighttpd.net.requests_avg
lighttpd.net.requests_avg_5sec
lighttpd.net.requests_total
lighttpd.performance.memory_usage
lighttpd.performance.uptime
lighttpd.response.status_1xx
lighttpd.response.status_2xx
lighttpd.response.status_3xx
lighttpd.response.status_4xx
lighttpd.response.status_5xx