Metabase
Metabase is a frontend service that provides configurable dashboards for displaying Drill4J's metrics.
Installation#
To install Metabase, follow the steps described in local-deployment.
Configuration#
Before you start using Metabase, you need to configure it. Here are the steps to do that:
Setting Drill4J DB connection#
Metabase uses the Drill4J database to fetch the data. To set up the Drill4J database connection, follow these steps:
Click on the Settings icon in the top right corner and select Admin settings.
Swagger UI
Move to the Databases menu on the header and click on the Drill4J_PostgreSQL_DB record.
Swagger UI
Check the Database connection details and fix them if needed.
Swagger UI
Setting Site URL#
Metabase uses the Site URL to generate links to the dashboards. To set the Site URL, follow these steps:
Click on the Settings icon in the top right corner and select Admin settings.
Swagger UI
Move to the General tab and set the Site URL field.
Swagger UI
Authentication and Authorization#
🚧 UNDER CONSTRUCTION. TO BE COMPLETED SOON 🚧
Troubleshooting#
I don't see the Metabase authentication form and instead presented with this message:
- Reason: Metabase was not propertly initalized. You likely have either skipped downloading data.sql file or misplaced it. Make sure to put it in db-init folder next to the docker-compose.yml file.
Metabase widgets sometimes display correctly and sometimes show errors at random times.
- The cause might be the inability to allocate shared memory to the PostgreSQL Docker container. To confirm the cause, you can check the Metabase logs and see an error like:
To fix it ensure that you add
shm-sizeparameter to thedocker-compose.ymlfile: