=== DecaLog ===
Contributors: PierreLannoy, hosterra
Tags: logs, error reporting, monitoring, tracing, logging
Requires at least: 6.4
Requires PHP: 8.2
Tested up to: 7.0
Stable tag: 4.6.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Capture and log events, metrics and traces on your site. Make WordPress observable - finally!

== Description ==

**Capture and log events, metrics and traces on your site. Make WordPress observable - finally!**

De-facto standard stack for WordPress observability, **DecaLog** provides reliable and powerful logging, monitoring and tracing features for WordPress core, PHP, database, plugins and themes.

**DecaLog** captures events generated by WordPress core, PHP, database, plugins and themes, collates metrics and KPIs and follows traces of the full WordPress execution. It has the ability to enrich these events, metrics and traces with many details regarding their triggering, before storing them in WordPress database or passing them to external services.

If you don't want to use external services, **DecaLog** provides the tools to leverage all the benefits of observability right in the WordPress admin dashboard. It supports multisite logs delegation and contains many features to help to protect personal information (user pseudonymization, IP obfuscation, etc.).

For a full list of supported - internal or third-party - services please, jump to the official [supported services list](https://perfops.one/decalog#services).

**DecaLog** can be used in dev/debug phases or on production sites: it has nearly no resource impact on the server. It provides an extensive set of WP-CLI commands to help operations too.

> **DecaLog** is part of [PerfOps One](https://perfops.one/), a suite of free and open source WordPress plugins dedicated to observability and operations performance.

= Developers =

If you're a plugins / themes developer and want to take advantage of the logging features of DecaLog, there's a [DecaLog SDK](https://decalog.io/) for you.

= Support =

This plugin is free and provided without warranty of any kind. Use it at your own risk, I'm not responsible for any improper use of this plugin, nor for any damage it might cause to your site. Always backup all your data before installing a new plugin.

Anyway, I'll be glad to help you if you encounter issues when using this plugin. Please read carefully the FAQ at the bottom of this page before requesting support.

= Privacy =

This plugin, as any piece of software, is neither compliant nor non-compliant with privacy laws and regulations. It is your responsibility to use it - by activating the corresponding options or services - with respect for the personal data of your users and applicable laws.

This plugin doesn't set any cookie in the user's browser.

This plugin may handle personally identifiable information (PII). If the GDPR or CCPA or similar regulation applies to your case, you must use the anonymization options embedded in the plugin and/or adapt your processes (consent management, security measure, treatment register, etc.).

= Donation =

If you like this plugin or find it useful and want to thank me for the work done, please consider making a donation to [La Quadrature Du Net](https://www.laquadrature.net/en) or the [Electronic Frontier Foundation](https://www.eff.org/) which are advocacy groups defending the rights and freedoms of citizens on the Internet. By supporting them, you help the daily actions they perform to defend our fundamental freedoms!

== Installation ==

= From your WordPress dashboard =

1. Visit 'Plugins > Add New'.
2. Search for 'DecaLog'.
3. Click on the 'Install Now' button.
4. Activate DecaLog.

= From WordPress.org =

1. Download DecaLog.
2. Upload the `decalog` directory to your `/wp-content/plugins/` directory, using your favorite method (ftp, sftp, scp, etc...).
3. Activate DecaLog from your Plugins page.

= Once Activated =

1. Visit 'PerfOps One > Control Center > DecaLog' in the left-hand menu of your WP Admin to adjust settings.
2. Enjoy!

== Frequently Asked Questions ==

= Can this plugin work on multisite? =

Yes. It is designed to work on multisite too. Network Admins can configure the plugin and have access to all logs. Sites Admins have access to the logs of their own sites only.

= Where can I get support? =

Support is provided via the official [WordPress page](https://wordpress.org/support/plugin/decalog/). Because I am human myself, please note that I only answer to support requests made by humans, who behave like humans. This excludes requests or bug reports written by AI or those that do not adhere to basic rules of courtesy.

= Where can I find documentation? =

Documentation for users is provided as the form of inline help in the plugin.

Developer's documentation can be found in the [DecaLog SDK Documentation](https://decalog.io/).

= Where can I report a bug? =
 
You can report bugs and suggest ideas via the [GitHub issue tracker](https://github.com/Pierre-Lannoy/wp-decalog/issues) of the plugin.

== Changelog ==

Please, see [full changelog](https://perfops.one/decalog-changelog).

== Upgrade Notice ==

== Screenshots ==

1. Running Loggers List
2. Available Loggers Types
3. WordPress Events Log
4. Event Details in Internal Viewer
5. WordPress Traces List
6. Trace Details in Internal Viewer
7. Live Events with In-browser Console
8. Events & Traces Seen in Grafana (example of external service)
9. Metrics Seen in InfluxDB (example of external service)