=== Gotcha Monitoring ===
Contributors: gotcha
Tags: monitoring, error tracking, performance, web vitals, self-hosted
Requires at least: 5.9
Tested up to: 6.9
Requires PHP: 8.1
Stable tag: 1.0.0
License: MIT
License URI: https://opensource.org/licenses/MIT

PHP and JavaScript errors, response time per page type and Web Vitals — sent to your own self-hosted Gotcha instance.

== Description ==

Gotcha is a self-hosted error and performance monitoring service: a single Go
binary plus PostgreSQL and ClickHouse, running on your own server. This plugin
connects a WordPress site to it.

What it sends:

* **PHP errors** — uncaught exceptions and fatal errors, with stack trace and context.
* **Response time per page type** — transactions named `single.post`, `archive.category`, `rest:/wp/v2/posts`, `wp-cron`, not by URL.
* **JavaScript errors and Web Vitals** — LCP, INP, CLS, FCP, TTFB from real visitors' browsers.

The plugin is a complete no-op until you set a DSN in **Settings → Gotcha**.
No data leaves the site before that, and nothing is sent anywhere except the
instance you point it at.

Under the hood it uses the official Sentry PHP and JavaScript SDKs: Gotcha
accepts the Sentry ingest protocol, so there is no proprietary agent involved.

== Installation ==

1. Upload the plugin zip via **Plugins → Add New → Upload Plugin**, or unpack it into `wp-content/plugins/`.
2. Activate it.
3. Stand up a Gotcha instance if you do not have one yet: https://getgotcha.ru/docs/installation/
4. Create a project, copy its DSN from the "Setup" page.
5. Paste the DSN in **Settings → Gotcha**.

== Frequently Asked Questions ==

= Does it send anything to a third party? =

No. Data goes only to the instance whose DSN you entered — your own server.

= Does it slow the site down? =

Errors are sent out of band, and tracing is sampled (20% of requests by
default; set 0 to disable tracing entirely and keep errors only).

= Which Gotcha version is required? =

Any current one. The plugin speaks the Sentry ingest protocol, which Gotcha has
supported from the start.

== Changelog ==

= 1.0.0 =
* First release: PHP errors, transactions per page type, browser SDK with Web Vitals.
