Reporting Framework
The Reporting Framework is an infrastructure to make database data available in searchable indexes for efficient slicing and dicing of data and real-time monitoring with visualization and reports. The framework utilizes open-source components to achieve this data pipeline and visualization capabilities.
Postgres WAL contains events on the database, specifically, changes to any table fields. These events are read by Debezium and pushed to Kafka Topics. Using a connector the fields are further pushed into OpenSearch indexes. These indexes may be searched by APIs or consumed by OpenSearch Dashboards for visualization.
The salient features of the framework are the following:
Searchable indexes in OpenSearch
No load on main DB esp when dataset is large and SQL queries get complex
Real-time slicing and dicing of data with searchable indexes
OpenSearch Dashboards
Ease of creation of dashboards and reports
Authentication and authorisation using Keycloak
Authorized access to dashboards
Single sign-on with Keycloak
PII data not available for search*
Privacy protection
* As a highly recommended practice PII data is not shunted to the search indexes, however, the framework does not impose any restriction as such.
Installation
Refer to Installation Guide and Post Installation Check.
Accessing OpenSearch dashboards
Pick the URL provided during the installation of the Helm chart of the module (like SR, PBMS)
Add Keycloak roles to the user who is accessing the dashboard (as given here).
Confirm that the number of indexed records in OpenSearch matches the number of rows in the DB (guide TBD). This check confirms that the reporting pipeline is working fine.
Creating dashboards
Last updated
