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.

Prerequisites

• Your Limy API key

• Ability to make HTTP POST requests from your app

Step 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.

Step 2

Send the request

Example payload:

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

Step 3

Verify it's working

Navigate to your Limy dashboard and check the Bot Monitor. Note that the AI log filter is on by default.

That's it! Data should begin to populate on your dashboard within minutes.

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 [email protected]