circle-info
Version 2 is coming up

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?

Last updated