Skip to content

Installing the WordPress Plugin

Prerequisites

  • WordPress 5.2+ with PHP 7.4+
  • Outbound HTTPS from your server to the Logystera gateway (only needed when connecting)

Step 1 — Install the plugin

Option A: Upload via WP Admin

  1. Download the latest logystera-log-ingest.zip from your dashboard or the releases page.
  2. In WordPress admin go to Plugins → Add New → Upload Plugin.
  3. Upload the ZIP file and click Install Now.
  4. Click Activate Plugin.

Option B: Manual install (FTP / SSH)

cd /path/to/wp-content/plugins
unzip logystera-log-ingest.zip

Then activate from Plugins → Installed Plugins.

What happens on activation

The plugin starts collecting events immediately — no account or configuration required. Events are buffered locally in JSONL files under wp-content/uploads/logystera/.

Go to Logystera in your WordPress admin sidebar. You will see the full admin interface with all tabs (Status, Settings, Events, etc.). A banner at the top indicates the plugin is not yet connected.

You can browse buffered events, configure which signals to collect, and adjust settings — all before connecting.

Step 2 — Connect to Logystera (optional)

Connecting sends your buffered events to the Logystera platform for monitoring, alerting, and dashboards. Without connecting, events stay local only.

Click Connect in the banner at the top of the admin page (or go to the Credentials tab). This opens the Logystera app in your browser:

  1. Sign in (or create an account if you have an invitation).
  2. Confirm the site URL on the connection page.
  3. Click Connect Site.

You are redirected back to WordPress with credentials configured automatically. The plugin immediately flushes any buffered events and shows how many were sent.

Data sent on connect

When you click Connect, the plugin sends the following metadata to Logystera:

Field Example Purpose
site_url https://example.com Identifies the WordPress installation
wp_version 6.7.1 WordPress version
php_version 8.2.18 PHP version
plugin_version 1.0.0.52 Plugin version
timezone Europe/Berlin Site timezone
entity_fingerprint a3f1c2d4e5b6 Stable hash of site URL + paths (for reconnect matching)

This metadata is sent once during connect and is not transmitted again. Event data is sent separately during normal operation.

Manual setup (fallback)

If you prefer to configure credentials manually:

  1. Log in to app.logystera.com, go to Entities → Add Entity, choose WordPress.
  2. Copy the Entity Token and Entity Secret.
  3. In the Credentials tab, paste the token and secret, then click Save Credentials.

Step 3 — Verify signal delivery

In your Logystera dashboard, open the entity and go to the Events tab. Within a few minutes of normal site traffic you should see http.request events appearing.

If no signals appear after 10 minutes, see Troubleshooting.

Credential rotation

To rotate credentials without disconnecting, go to the Credentials tab and click Rotate Credentials. This opens Logystera in your browser, generates new credentials, and delivers them back to the plugin automatically. Old credentials stop working immediately.

Reconnecting

If you disconnect and reconnect the same site, the plugin reuses the existing entity in Logystera. Old credentials are revoked and fresh ones are issued.

Multisite

The plugin supports WordPress Multisite. Install and activate network-wide from Network Admin → Plugins. Each subsite shares the same entity credentials — signals include labels.site.blog (the blog ID) to distinguish subsites.

To monitor subsites as separate entities, install the plugin on each subsite individually with different credentials.

Uninstalling

Deactivating the plugin stops all event collection and removes WP-Cron tasks. Data is preserved for reactivation.

Uninstalling (deleting) the plugin removes everything: MySQL history tables (wp_logystera_events, wp_logystera_gateway_logs), JSONL buffer files, and all plugin options from the WordPress database.