Quick Start

1. Create Your Account

Register at app.logtrace.io using your corporate email. Select the Starter plan (up to 50 GB/month, 3 team members, 7-day retention). Verification arrives within 30 seconds to your inbox. No phone number required.

2. Generate an API Key

Navigate to Settings → API Keys in the dashboard. Click Create Key, name it prod-agent-01, and assign the Log Ingest scope. Copy the key immediately — it is shown only once. Keys are prefixed with lt_key_.

3. Install the Agent

Deploy the LogTrace agent on your servers. Linux (Ubuntu 20.04+, CentOS 8+, Debian 11+) and Windows Server 2019+ are supported. The agent runs as a lightweight systemd service or Windows service, using under 50 MB RAM at idle and less than 2 % CPU during peak throughput.

4. Send Your First Log

Configure your application or the agent to forward logs to the ingest endpoint. Within seconds, logs appear in the Live Stream view. Set up your first alert rule to catch >500 errors or latency spikes above 2 seconds.

Linux — Install via APT

Run these commands on Ubuntu 20.04 or newer:

curl -fsSL https://apt.logtrace.io/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/logtrace.gpg
echo "deb [signed-by=/usr/share/keyrings/logtrace.gpg] https://apt.logtrace.io stable main" | sudo tee /etc/apt/sources.list.d/logtrace.list
sudo apt update
sudo apt install logtrace-agent

Then configure the agent with your API key:

sudo logtrace-agent configure --api-key lt_key_a8f3k29d... --endpoint ingest.logtrace.io --region ru-central

Linux — Install via YUM

For CentOS 8, Rocky Linux 8, or AlmaLinux 8:

sudo rpm --import https://yum.logtrace.io/gpg.key
sudo tee /etc/yum.repos.d/logtrace.repo < <EOF
[logtrace]
name=LogTrace Agent
baseurl=https://yum.logtrace.io/stable/x86_64
enabled=1
gpgcheck=1
gpgkey=https://yum.logtrace.io/gpg.key
EOF
sudo dnf install logtrace-agent

Windows — Install via PowerShell

Run PowerShell as Administrator:

Invoke-WebRequest -Uri https://installers.logtrace.io/logtrace-agent-latest.msi -OutFile $env:TEMP\logtrace-agent.msi
msiexec /i $env:TEMP\logtrace-agent.msi /qn API_KEY="lt_key_a8f3k29d..." ENDPOINT="ingest.logtrace.io"

Verify the service is running:

Get-Service LogTraceAgent | Select-Object Name, Status, StartType

Send a Test Log via cURL

Validate your setup by sending a single log line directly to the ingest API:

curl -X POST https://ingest.logtrace.io/v1/logs \
  -H "Authorization: Bearer lt_key_a8f3k29d..." \
  -H "Content-Type: application/json" \
  -d '{
    "service": "payment-gateway",
    "level": "INFO",
    "message": "Order #48291 processed successfully",
    "timestamp": "2025-01-15T09:32:11Z",
    "fields": {
      "order_id": 48291,
      "amount": 12750.00,
      "currency": "RUB"
    }
  }'

A 200 OK response confirms ingestion. Check the Live Stream at app.logtrace.io/stream to see it appear.

Configure logtrace-agent.yaml

Edit /etc/logtrace/agent.yaml for persistent file-based collection:

api:
  key: lt_key_a8f3k29d...
  endpoint: ingest.logtrace.io
  region: ru-central

collection:
  files:
    - path: /var/log/nginx/access.log
      service: nginx-proxy
      format: json
    - path: /var/log/myapp/app.log
      service: order-service
      format: logfmt

buffer:
  flush_interval: 5s
  max_size_mb: 128

Restart the agent to apply changes:

sudo systemctl restart logtrace-agent

Verify Agent Status

Check that the agent is healthy and sending data:

sudo logtrace-agent status

Expected output:

Agent: v2.4.1
Status: Running
Uptime: 3m 12s
Events sent: 1,247
Last flush: 2s ago
Buffer: 0.03 MB / 128 MB

If you see Events sent: 0, verify your API key and file paths in the configuration.