wp-prometheus/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.2.0] - 2026-02-02

Added

• WooCommerce integration metrics (when WooCommerce is active):
  • wordpress_woocommerce_products_total - Products by status and type
  • wordpress_woocommerce_orders_total - Orders by status
  • wordpress_woocommerce_revenue_total - Revenue (all time, today, month)
  • wordpress_woocommerce_customers_total - Customers (registered, guest)
• Cron job metrics:
  • wordpress_cron_events_total - Scheduled cron events by hook
  • wordpress_cron_overdue_total - Number of overdue cron events
  • wordpress_cron_next_run_timestamp - Unix timestamp of next scheduled cron
• Transient cache metrics:
  • wordpress_transients_total - Transients by type (total, with_expiration, persistent, expired)
• WooCommerce metrics section in settings (only visible when WooCommerce is active)
• Support for WooCommerce HPOS (High-Performance Order Storage)

Changed

• Updated Help tab with new metrics reference

[0.1.1] - 2026-02-02

Changed

• Reorganized settings page with tabbed interface (License, Metrics, Help tabs)
• Moved Prometheus configuration help to dedicated Help tab
• Separated static and runtime metrics in settings with descriptions
• Added admin CSS for improved tab styling

Added

• New Help tab with endpoint information, curl examples, and metrics reference table
• Custom code examples section in Help tab

[0.1.0] - 2026-02-02

Added

• HTTP request metrics:
  • wordpress_http_requests_total - Counter of HTTP requests by method, status code, and endpoint
  • wordpress_http_request_duration_seconds - Histogram of request durations
• Database query metrics:
  • wordpress_db_queries_total - Counter of database queries by endpoint
  • wordpress_db_query_duration_seconds - Histogram of query durations (requires SAVEQUERIES)
• RuntimeCollector class for collecting metrics during WordPress request lifecycle
• New settings options for enabling/disabling runtime metrics
• Translation files (.pot, .po, .mo) for German (Switzerland)

Changed

• Metrics are now categorized into static metrics (users, posts, etc.) and runtime metrics (HTTP, database)
• Runtime metrics only collected when explicitly enabled and license is valid

[0.0.2] - 2026-02-01

Fixed

• Fixed composer.json dependency version constraint for wc-licensed-product-client (^0.2.2 instead of dev-main)
• Changed minimum-stability back to stable

[0.0.1] - 2026-02-01

Added

• Initial plugin structure and bootstrap
• Main plugin class with singleton pattern
• License management integration with wc-licensed-product-client
• Prometheus metrics collector with default WordPress metrics:
  • wordpress_info - WordPress installation information
  • wordpress_users_total - Total users by role
  • wordpress_posts_total - Total posts by type and status
  • wordpress_comments_total - Total comments by status
  • wordpress_plugins_total - Total plugins by status
• Authenticated /metrics endpoint with Bearer token
• Admin settings page under Settings > Metrics
• Extensibility via wp_prometheus_collect_metrics action hook
• Gitea CI/CD pipeline for automated releases
• Comprehensive documentation (README.md, PLAN.md, CLAUDE.md)

Security

• Bearer token authentication for metrics endpoint
• Nonce verification for all AJAX requests
• Capability checks for admin operations
• Input sanitization and output escaping