# rack-http-logger

**Repository Path**: mirrors_mattt/rack-http-logger

## Basic Information

- **Project Name**: rack-http-logger
- **Description**: Log metrics from HTTP request parameters according to l2met conventions
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-09
- **Last Updated**: 2026-04-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Rack::HTTPLogger

`Rack::HTTPLogger` is Rack middleware
that provides a logging endpoint for your application.
HTTP request parameters are automatically formatted
according to [l2met](https://github.com/ryandotsmith/l2met)
and logged to a specified stream,
such as `STDOUT`.

This is designed for anyone using Heroku,
which uses [Logplex](https://devcenter.heroku.com/articles/logplex)
to aggregate messages for further monitoring and analytics.
With `Rack::HTTPLogger` remote events,
such as mobile device registrations,
can be collected and processed into your common log stream.

## Installation

```
$ gem install rack-http-logger
```

## Options

- `stream`: Stream to which lines are logged. _Defaults to `$stdout`_.
- `sync`: Print log lines to stream synchronously (not recommended for applications with high throughput). _Defaults to `true`_
- `method`: Matched HTTP Method. _Defaults to `LOG`_
- `path`: Matched URL path. _Defaults to `/`_
- `source`: Source attribute in log line. _Defaults to `rack-http-logger`_

## Usage

Rack::HTTPLogger can be run as Rack middleware.

### config.ru

```ruby
require 'rack/http-logger'

use Rack::HTTPLogger
```

## Contact

[Mattt](https://twitter.com/mattt)

## License

Rack::HTTPLogger is available under the MIT license.
See the LICENSE file for more info.