Send your first log

This quickstart proves the complete path from a sender to a visible log. It normally takes a few minutes.

Before you start

You need a Fluxtail account, permission to create receivers and access tokens, and curl on your computer.

1. Create a stream

Open Streams, create a stream named Quickstart, and leave it active. A stream is the saved destination used to organize logs.

2. Create an HTTP JSON receiver

Open Receivers, choose Create receiver, select HTTP JSON, and route it to the Quickstart stream. Copy the exact receiver URL shown by Fluxtail.

The URL has this shape:

https://ingest.fluxtail.io/v1/receivers/RECEIVER_ID/logs

3. Create a receiver token

Open Access tokens and create a token with ingest:write, bound to the HTTP receiver you just created. Copy it now; store it in your shell instead of a tracked file:

export FLUXTAIL_RECEIVER_URL='PASTE_THE_EXACT_RECEIVER_URL'
export FLUXTAIL_TOKEN='PASTE_THE_RECEIVER_TOKEN'

4. Send one event

curl --fail-with-body -X POST "$FLUXTAIL_RECEIVER_URL" \
  -H "Authorization: Bearer $FLUXTAIL_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"message":"docs quickstart","severity":"INFO","service_name":"checkout"}'

A successful request returns HTTP 202:

{"accepted":1}

5. Verify it in Live Tail

Open Live Tail, select the Quickstart stream, and search for docs quickstart. The row should show the current time, severity INFO, and service checkout.

If the event does not appear

401: the token is missing, invalid, or not bound to this receiver.
403: the token and receiver protocol do not match.
429: the account or receiver event limit was reached.
503: authentication, rate limiting, or the ingest queue is temporarily unavailable.
202 but no row: clear Live Tail filters, confirm the selected stream, then see No logs arriving?.