Dashboard Apps
On this page
Note
This is a Preview feature.
SingleStore Dashboard Apps enables users to create, publish, and manage real-time interactive dashboards through the Cloud Portal.
You can create and manage dashboard apps using the Cloud Portal.
Publish Dashboard Apps using the Cloud Portal
Create a Dashboard App
Dashboard Apps can be created for shared notebooks only.
-
Using Apps in the left navigation
-
Using Shared Notebooks
-
Navigate to Data Studio > Shared.
-
Select a shared notebook.
-
Select Publish (on the top right).
-
New Dashboard App
After selecting Publish, a new dialog box appears.
![Select Dashboard in Publish Settings dialog.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blta1a57fc1cc7ce37f/67aba665c401d61ed65c0b42/appsetting-Hp91QR.png?width=850&disable=upscale&auto=webp)
Publish Settings |
|
---|---|
Publish as |
Select Dashboard. |
Name |
Enter a name of the dashboard app. |
Description |
Enter the dashboard app description. |
Notebook |
Select a shared notebook to publish as a dashboard app. |
Deployment |
Select the SingleStore deployment (workspace) your notebook will connect to. Selecting a workspace allows you to connect to your SingleStore databases referenced in the Notebook natively. |
Select Next.
![Shows the summary of Publish Settings](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt757205f28fc087ed/67aba6433f221cfb6acd92cd/appsummary-f8cPgl.png?width=850&disable=upscale&auto=webp)
Select Publish to publish your notebook as a dashboard app.
Manage an Existing Dashboard App
To view an existing dashboard app, select Apps in the left navigation.
View a Dashboard App
To view a dashboard app, select the dashboard app name under the Name column.
![View the pubished dashboard app in Apps.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/bltb73c2b1d40193531/67aba6712f34dc3e3c45ec72/dashapp-cNm0Re.png?width=850&disable=upscale&auto=webp)
You can view the following details for each dashboard app:
![View the dashboard after selecting the dashboard app name under Name column.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blta8464fea936f0eb3/67aba6710830d2ae36d949e0/dashboardview-J7BTA0.png?width=850&disable=upscale&auto=webp)
You can view the details of a dashboard app on the right navigation.
Update a Dashboard App
To update an existing dashboard app, select the ellipsis in the Actions column of the dashboard app, and select Update.
![Update the details of dashboard in Dashboard settings.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt2a1dc81e33280839/67aba64e2ecf947369cbc5ef/dashupdatesettings-8MsNvH.png?width=850&disable=upscale&auto=webp)
You can also update the dashboard app using your shared notebook.
![Select Update Dashboard in the upper right in the notebook to update the dashboard details.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/bltfbcdd26fced1ea07/67aba671bef6773f6fde3b2b/dashupdate-XF5JEE.png?width=850&disable=upscale&auto=webp)
Select Update Dashboard.
![View the dialog for updating the dashboard after selecting Update Dashboard in the notebook or in the Apps.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt08beb20ac4de29ff/67aba65aebf5b97a35e0ea08/dashboardupdate-wwACPL.png?width=850&disable=upscale&auto=webp)
Delete a Dashboard App
To delete an existing dashboard app, select the ellipsis in the Actions column of the dashboard app, and select Delete.
Status of Dashboard Apps
Status |
Description |
---|---|
Initializing |
The notebook is creating or updating the dashboard. |
Active |
The dashboard is configured correctly. |
Failed |
The dashboard is not configured correctly. |
Error |
An error unrelated to the notebook code prevented the dashboard from initializing. |
Troubleshoot Dashboard Apps
SingleStore automatically saves a snapshot of the notebook for each execution that fails.
Error |
Solution |
---|---|
Workspace Deleted |
Update the dashboard and select a deployment. |
Workspace Suspended |
Resume the workspace or create a new dashboard with a different deployment. |
Database Detached |
Reattach the database with the right permissions or create a new dashboard with a different database. |
Notebook Deleted/Not Present |
Create a new dashboard with a different notebook. |
Internal Errors/Misc |
Reach out to SingleStore Support or use the chat feature in the Cloud Portal. |
Last modified: December 5, 2024