Better Stack Integration

Send WordPress Activity Logs to Better Stack

Use Activity Log Pro Log Channels to stream WordPress activity logs to Better Stack in near real-time.
This helps you centralize auditing, security monitoring, and troubleshooting in one log platform.

The Log Channels screen in Activity Log Pro shows a Better Stack integration configured and active, enabling real-time forwarding of WordPress activity logs to Better Stack. It highlights automatic log streaming, tamper-proof offsite storage, and asynchronous background delivery with no impact on site performance.

The Better Stack channel configuration screen in Activity Log Pro shows how to connect WordPress activity logs to Better Stack using the HTTP ingestion API. It includes fields for the Source Token and Ingest Host, along with setup instructions for creating a log source in Better Stack and streaming logs in real time.

What this integration does

When the Better Stack Log Channel is enabled, each new WordPress activity event is queued and sent to your Better Stack Logs source as structured JSON.

Typical events include:

  • User logins and failed logins
  • Plugin/theme installs, activations, updates
  • Content and settings changes
  • User and role changes

Requirements

Before setup, make sure you have:

  • Activity Log Pro Premium installed and activated
  • A Better Stack account
  • A Better Stack Logs source
  • From that source page:
    • Source Token
    • Ingest Host (can vary by region)

Setup (step-by-step)

  1. In WordPress admin, go to Activity Log Pro → Settings Log Channels.
  2. Click Add Channel.
  3. Select Better Stack.
  4. Enter a label (example: My Better Stack Source).
  5. Paste your Source Token.
  6. Enter your Ingest Host (example: in.logs.betterstack.com).
  7. Save the channel and make sure it is Enabled.
  8. Click Test on the channel row to send a test event.

Where to find Source Token and Ingest Host

In Better Stack:

  1. Go to Sources.
  2. Open your Logs source.
  3. Copy:
    • Source Token
    • Ingest Host

Paste both into your Log Channel settings in WordPress.


Verify data in Better Stack

After sending a test event:

  1. Open your Better Stack Logs source.
  2. View incoming logs in the Telemetry/logs table.
  3. Search for:
    • service:activity-log-pro (if present in your payload), or
    • event text from a known action (for example login failed or plugin update).

Example payload

{
  "id": 12345,
  "timestamp": "2026-04-30 17:30:00",
  "event_type": "Login_failed",
  "object_type": "user",
  "user_login": "admin",
  "user_role": "administrator",
  "user_ip": "192.168.1.5",
  "description": "Failed login attempt for username: admin",
  "site_url": "https://example.local",
  "site_name": "Local Dev Site",
  "message": "Failed login attempt for username: admin"
}

Performance and delivery behaviour

  • Delivery is asynchronous (background queue), so admin page loads are not blocked.
  • You can validate channel connectivity with the built-in Test button.
  • If a delivery fails, last error details are shown in Log Channels.

Troubleshooting

No logs appear

  • Confirm the channel is enabled.
  • Re-check Source Token.
  • Re-check Ingest Host (exact value from Better Stack source page).
  • Send a channel Test event and check result.

Authentication errors

  • Source Token may be invalid, expired, or copied incorrectly.
  • Regenerate/copy token again from Better Stack source settings.

Ingest host or endpoint issues

  • Enter only the host value from Better Stack (no extra path).
  • Example valid format: in.logs.betterstack.com

Logs appear but are hard to search

  • Start with broad queries and then filter by event_typeuser_loginsite_name, or keywords in message.

FAQ

Will this slow down my site?
No. Events are sent in the background via queued delivery.

Can I send to Better Stack and other channels at the same time?
Yes. Multiple Log Channels can run together.

Can I centralize logs from multiple WordPress sites?
Yes. Filter by fields like site_name and site_url to separate sites.


Need help?

If setup fails, contact support with:

  • Your channel settings (redact secrets)
  • Test result/error message
  • The exact ingest host used
  • A sample query you used in Better Stack

Back to Log Channels.