Lighttpd Check

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

Host

To configure this check for an Agent running on a host:

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

   init_config:
   
   instances:
     ## @param lighttpd_status_url - string - required
     ## Status url of your Lighttpd server.
     #
     - lighttpd_status_url: http://localhost/server-status?auto

2. Restart the Agent.

Containerized

For containerized environments, see the Autodiscovery Integration Templates for guidance on applying the parameters below.

Parameter	Value
<INTEGRATION_NAME>	lighttpd
<INIT_CONFIG>	blank or {}
<INSTANCE_CONFIG>	{"lighttpd_status_url": "http://%%host%%/server-status?auto"}

Log collection

1. Collecting logs is disabled by default in the Datadog Agent, you need to enable it in datadog.yaml:

   logs_enabled: true

2. Add this configuration block to your lighttpd.d/conf.yaml file to start collecting your lighttpd Logs:

   logs:
     - type: file
       path: /path/to/my/directory/file.log
       source: lighttpd

   Change the path parameter value and configure it for your environment. See the sample lighttpd.d/conf.yaml for all available configuration options.

3. Restart the Agent.

Validation

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

Data Collected

Metrics

See metadata.csv for a list of metrics provided by this integration.

Events

The Lighttpd check does not include any events.

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.