From a9b265bfa348f7d06b70032b059acbfc06830ace Mon Sep 17 00:00:00 2001 From: Ziinc Date: Mon, 10 Mar 2025 11:29:43 +0100 Subject: [PATCH] docs: add loki drain information (#31148) * docs: add loki drain information * chore: typos * docs: update DataDog capitalizatoin --- apps/docs/content/guides/telemetry/log-drains.mdx | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/apps/docs/content/guides/telemetry/log-drains.mdx b/apps/docs/content/guides/telemetry/log-drains.mdx index bcd3c61429a..746fff13e0f 100644 --- a/apps/docs/content/guides/telemetry/log-drains.mdx +++ b/apps/docs/content/guides/telemetry/log-drains.mdx @@ -16,6 +16,7 @@ The following table lists the supported destinations and the required setup conf | --------------------- | ---------------- | ------------------------------------------------- | | Generic HTTP endpoint | HTTP | URL
HTTP Version
Gzip
Headers | | DataDog | HTTP | API Key
Region | +| Loki | HTTP | URL
Headers | HTTP requests are batched with a max of 250 logs or 1 second intervals, whichever happens first. Logs are compressed via Gzip if the destination supports it. @@ -181,6 +182,18 @@ To setup DataDog log drain, generate a DataDog API key [here](https://app.datado If you are interested in other log drains, upvote them [here](https://github.com/orgs/supabase/discussions/28324) +## Loki + +Logs sent to the Loki HTTP API are specifically formatted according to the HTTP API requirements. See the official Loki HTTP API documentation for [more details](https://grafana.com/docs/loki/latest/reference/loki-http-api/#ingest-logs). + +Events are batched with a maximum of 250 events per request. + +The log source and product name will be used as stream labels. + +The `event_message` and `timestamp` fields will be dropped from the events to avoid duplicate data. + +Loki must be configured to accept **structured metadata**, and it is advised to increase the default maximum number of structured metadata fields to at least 500 to accommodate large log event payloads of different products. + ## Pricing For a detailed breakdown of how charges are calculated, refer to [Manage Log Drain usage](/docs/guides/platform/manage-your-usage/log-drains).