Axiom

Ship logs to an Axiom dataset via the ingest API

Send logs to Axiom. Axiom indexes every field of an event without a schema, so the nested structure Logixlysia sends — request.method, context.requestId, your custom context — is queryable as-is with APL.

Setup

1. Create a dataset in the Axiom console.
2. Generate an API token with ingest permission for that dataset.
3. Set the environment variables:

AXIOM_API_KEY=xaat-your-token
AXIOM_DATASET=your-dataset

4. Wire the transport:

import { Elysia } from 'elysia'
import logixlysia from 'logixlysia'
import { createAxiomTransport } from 'logixlysia/axiom'

const app = new Elysia()
  .use(
    logixlysia({
      config: {
        transports: [createAxiomTransport()]
      }
    })
  )
  .get('/', () => 'ok')
  .listen(3000)

5. Trigger a request and query the dataset in Axiom.

Environment Variables

Variable	Required	Description
AXIOM_API_KEY	Yes	API token with ingest permission (xaat-…)
AXIOM_DATASET	Yes	Target dataset name
AXIOM_ORG_ID	For personal access tokens	Organization ID
AXIOM_URL	No	API base URL (default https://api.axiom.co)

Options

Options passed to createAxiomTransport() override environment variables:

const axiom = createAxiomTransport({
  dataset: 'production-logs',
  timeout: 10_000
})

Option	Type	Default	Description
apiKey	string	AXIOM_API_KEY	API token with ingest permission
dataset	string	AXIOM_DATASET	Target dataset name
orgId	string	AXIOM_ORG_ID	Required when using a personal access token
baseUrl	string	https://api.axiom.co	API base URL

Plus the shared batching options: maxBatchSize, flushIntervalMs, timeout, retries — see the overview.

Payload

Each log becomes one event in POST /v1/datasets/{dataset}/ingest:

{
  "_time": "2026-08-22T12:00:00.000Z",
  "level": "INFO",
  "message": "",
  "request": { "method": "GET", "url": "http://localhost:3000/users" },
  "status": 200,
  "durationMs": 12.4,
  "context": { "requestId": "0d5e…" }
}

Query it in Axiom with APL, e.g. ['your-dataset'] | where level == "ERROR" and durationMs > 1000.

Troubleshooting

• 401 — the token is invalid or expired; generate a new one in Axiom settings.
• 403 with a personal access token — set AXIOM_ORG_ID (personal tokens are not scoped to an organization).
• Nothing arrives — logs flush in batches (2 s by default); check that the process lived long enough, or call flush() before exit.