Version 2 is coming up
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Custom Log Shipping

Overview

This integration lets you send access logs directly to Limy's ingestion endpoint via HTTP POST.

Use this when you don't have a CDN or want to send logs from your own infrastructure.

1

Format your logs

Send logs as a JSON array to:

POST https://stream.getlimy.ai

Include these headers:

X-API-KEY: lmy_xxxx
User-Agent: Limy-Custom-HTTP/1.0

Each log entry needs these fields:

Field
Required

timestamp

method

host

path

status_code

ip

user_agent

referer

query_params

bytes_sent

duration_ms

Max 20MB or 1,000 entries per request.

2

Send the request

Example payload:

[
  {
    "timestamp": "2025-06-15T14:30:00Z",
    "method": "GET",
    "host": "domain.com",
    "path": "/shopping",
    "status_code": 200,
    "ip": "192.168.1.1",
    "user_agent": "Mozila...",
    "query_params": {
      "brand": "nike"
    },
    "referer": "https://chatgpt.com"
  }
]
3

Verify it's working

Navigate to your Limy dashboard and check the Agent Monitor.

Tips

  • Batch up to 1,000 logs per request

  • Limit request size to 20MB

  • Send async so you don't block your app

  • Implement retries for failures

Need More Help?

  • Contact answers@limy.ai for any further questions

Last updated