# onlylogs.io

> onlylogs.io is a log management service for developers. It collects, displays, and searches application logs in real time via a simple HTTP log drain. Each project exposes a unique `ONLYLOGS_DRAIN_URL` that accepts newline-delimited plain-text logs over HTTPS POST.

## Overview

- [Homepage](/index.md): Product overview, feature list, and contact details for requesting access.
- [Integration instructions](/instructions.md): End-to-end guide for streaming logs from Heroku, Dokku, Scalingo, Clever Cloud, Fly.io, Kubernetes, Vector, Fluent Bit, and Ruby on Rails (via the `onlylogs` gem).

## Key concepts

- A **log drain** is an HTTPS endpoint that receives newline-delimited plain-text log lines via POST.
- Each onlylogs.io project has a unique `ONLYLOGS_DRAIN_URL` used as the drain destination.
- The backend accepts any plain-text lines, but a recommended format is `[ISO8601_TIMESTAMP] [SEVERITY_LETTER] MESSAGE`.
- Log shipping works with any HTTP-capable log drain: Heroku drains, Dokku's Vector plugin, Vector, Fluent Bit, or the Ruby [onlylogs](https://github.com/renuo/onlylogs) gem (`HttpLogger` or `SocketLogger`).

## Contact

- Access requests: onlylogs@renuo.ch