Getting Started

The simplest way to test log ingestion using curl:

curl -X POST https://api.logtide.dev/api/v1/ingest \
  -H "X-API-Key: lp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "logs": [{
      "time": "2025-01-23T10:30:00Z",
      "service": "my-app",
      "level": "info",
      "message": "Hello from LogTide Cloud!",
      "metadata": { "environment": "production" }
    }]
  }'

curl -X POST http://localhost:8080/api/v1/ingest \
  -H "X-API-Key: lp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "logs": [{
      "time": "2025-01-23T10:30:00Z",
      "service": "my-app",
      "level": "info",
      "message": "Hello from LogTide!",
      "metadata": { "environment": "production" }
    }]
  }'

Send logs from Python using the requests library (no SDK needed):

import requests
from datetime import datetime, timezone

# Configuration
API_URL = "https://api.logtide.dev/api/v1/ingest"  # or http://localhost:8080 for self-hosted
API_KEY = "lp_your_api_key_here"

# Send a log
response = requests.post(
    API_URL,
    headers={
        "X-API-Key": API_KEY,
        "Content-Type": "application/json"
    },
    json={
        "logs": [{
            "time": datetime.now(timezone.utc).isoformat(),
            "service": "my-python-app",
            "level": "info",
            "message": "Hello from Python!",
            "metadata": {"user_id": 123}
        }]
    }
)

print(f"Status: {response.status_code}")

For production use, consider the Python SDK with retry logic and batching.

Send logs from Node.js using fetch (no SDK needed):

// Node.js 18+ (native fetch) or install node-fetch
const API_URL = "https://api.logtide.dev/api/v1/ingest"; // or http://localhost:8080
const API_KEY = "lp_your_api_key_here";

async function sendLog() {
  const response = await fetch(API_URL, {
    method: "POST",
    headers: {
      "X-API-Key": API_KEY,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      logs: [{
        time: new Date().toISOString(),
        service: "my-node-app",
        level: "info",
        message: "Hello from Node.js!",
        metadata: { userId: 123 }
      }]
    })
  });

  console.log('Status: ' + response.status);
}

sendLog();

For production use, consider the Node.js SDK with circuit breaker and batching.

Automatically collect logs from Docker containers using Fluent Bit:

# Add to your docker-compose.yml
services:
  my-app:
    image: my-app:latest
    # Your app just writes to stdout - no code changes needed!

  fluent-bit:
    image: fluent/fluent-bit:4.2.2  # or cr.fluentbit.io/fluent/fluent-bit:4.2.2 for ARM64
    volumes:
      - /var/lib/docker/containers:/var/lib/docker/containers:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      LOGTIDE_API_KEY: lp_your_api_key_here
      LOGTIDE_API_HOST: api.logtide.dev  # or backend for self-hosted

See the full No-SDK Setup guide for complete Fluent Bit configuration. For ARM64/Raspberry Pi, use cr.fluentbit.io/fluent/fluent-bit:4.2.2.

Use OpenTelemetry for vendor-neutral instrumentation:

# Install OpenTelemetry packages (Node.js example)
npm install @opentelemetry/api-logs @opentelemetry/sdk-logs \
  @opentelemetry/exporter-logs-otlp-http

import { logs, SeverityNumber } from '@opentelemetry/api-logs';
import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
import { LoggerProvider, BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';

// Configure exporter
const exporter = new OTLPLogExporter({
  url: 'https://api.logtide.dev/v1/otlp/logs', // or localhost:8080
  headers: { 'X-API-Key': 'lp_your_api_key_here' },
});

// Setup provider
const provider = new LoggerProvider();
provider.addLogRecordProcessor(new BatchLogRecordProcessor(exporter));
logs.setGlobalLoggerProvider(provider);

// Send a log
const logger = logs.getLogger('my-app');
logger.emit({
  severityNumber: SeverityNumber.INFO,
  body: 'Hello from OpenTelemetry!',
  attributes: { 'user.id': '123' },
});

See the full OpenTelemetry guide for Python, Go, and collector setup.