Logging is here!

Lighttpd

Agent Check Agent Check

Supported OS: Linux Mac OS Windows

Lighttpd Dashboard

Overview

The Agent’s lighttpd check tracks uptime, bytes served, requests per second, response codes, and more.

Setup

Installation

The lighttpd check is included in the Datadog Agent package, so you don’t need to install anything else on your lighttpd servers.

In addition, install mod_status on your Lighttpd servers.

Configuration

  1. Edit the lighttpd.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s directory. See the sample lighttpd.d/conf.yaml for all available configuration options:

    init_config:
    
    instances:
        # Each instance needs a lighttpd_status_url. Tags are optional.
        - lighttpd_status_url: http://example.com/server-status?auto
        #   tags:
        #     - instance:foo
  2. Restart the Agent to begin sending lighttpd metrics to Datadog.

Validation

Run the Agent’s status subcommand and look for lighttpd under the Checks section.

Data Collected

Metrics

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

Events

The Lighttpd check does not include any events at this time.

Service Checks

- lighttpd.can_connect:

Returns CRITICAL if the Agent cannot connect to lighttpd to collect metrics, otherwise OK.

Troubleshooting

Need help? Contact Datadog Support.

Further Reading

To get a better idea of how (or why) to monitor Lighttpd web server metrics with Datadog, check out our series of blog posts about it.