native_observability

🚀 Overview

Native Observability brings real observability into Drupal.
Trace requests, inspect execution, analyze performance, and explore runtime behavior — directly inside your application.

No core patches. No external dependencies required to get started.
Just install, enable, and start seeing what actually happens inside your system.

✨ What you get

• 🔁 Request tracing with correlation IDs
• 🧩 Execution spans with timeline visualization
• 🌐 External HTTP (Guzzle) tracing
• 📊 Performance metrics (latency, throughput, P95/P99)
• 📈 Dashboard with cache, database, and runtime insights
• 📝 Structured reports (printable HTML)
• 📡 Telemetry export (OpenTelemetry, Prometheus, Elastic)

🆕 Recent improvements

• 🧭 Preserved dashboard time range across navigation
• 🌐 Restored external Guzzle HTTP request visibility
• 🧹 Improved database observer (hidden orphan traces)

🧠 How it works

1. A request enters Drupal
2. A unique request ID is assigned
3. Execution is traced and stored
4. Spans capture internal operations
5. Metrics are aggregated
6. Data is visualized in dashboard and reports

This lets you understand:

• ✔ what happened
• ✔ how long it took
• ✔ where time was spent
• ✔ which services or queries slowed things down

📊 Dashboard

Explore performance and behavior through a built-in dashboard:

• 📉 Latency, throughput, and error rate
• 🗄 Database and cache observability
• 🌐 External request analysis
• 📈 Charts powered by Apache ECharts

🧱 Modules

• native_observability – tracing core
• native_observability_execution – execution monitoring
• native_observability_spans – span structure
• native_observability_metrics – performance analytics
• native_observability_dashboard – UI dashboard
• native_observability_report – reporting
• native_observability_otel – telemetry export

📚 Requirements

Dashboard and reports use Apache ECharts for chart rendering.

"merge-plugin": {
  "include": [
    "[Module_ROOT_PATH]/native_observability/modules/native_observability_dashboard/composer.libraries.json"
  ]
}

🔥 Why it matters

Logs tell you what happened.
Observability shows you why.

Native Observability gives Drupal real runtime visibility — without changing how your application works.

⚖ Performance

Approximate overhead: ~10% when full tracing is enabled.

📌 Status

Stable 1.0.5 release.
Actively maintained and evolving.