Monitoring & Metrics Instrumentation Gap

[AbdulSnk]

Summary

Improves observability by adding comprehensive Prometheus metrics for application, blockchain, cache, and database operations. Introduces reusable instrumentation to capture latency, throughput, and error metrics, enabling better monitoring, alerting, and performance analysis.

Changes

• Added a reusable metrics decorator to automatically instrument method execution.
• Captured operation duration, execution count, success, and error metrics.
• Added Prometheus metrics for:
• Blockchain transaction duration, total transactions, and error counts.
• Cache hits, misses, and operation duration.
• Database query duration, transaction duration, and connection pool metrics.
• Defined SLOs/SLIs for critical operations.
• Documented Grafana dashboard setup and metrics in RUNBOOK.md.
• Added integration tests to verify metrics are emitted correctly.
• Result
• Improved visibility into application health and performance.
• Enabled monitoring of blockchain, cache, and database operations.
• Provides reliable metrics for dashboards, alerting, and troubleshooting.
• Helps identify performance bottlenecks and track operational reliability.

Closes: #59