Skip to main content

Home

App store

Unravel uses the telemetry data available from your cluster to provide valuable views and insights through Plotly dash apps. You can manage these dash apps from the App store on Unravel UI.

From the App store, you can install an app, run the administrative tasks for managing your apps, navigate to different apps, and open the apps.

You can customize the configurations set by default for the App store. Refer to App Store configuration.

Important

Ensure to install GNU Compiler Collection (GCC) version 4.9.3,, which consists of compilers and libraries for C, C++, etc., on the Unravel node for the App store to function properly.

In case of a multi-cluster deployment, install GCC on the Unravel core node.

Install Apps from Unravel Apps page
  1. Download the app and save it in your system.

  2. On the Unravel UI, from the upper-right corner, click appstore-icon.png. The App store page is displayed. A blank page is displayed, If there are no apps installed.

  3. Click the App settings button (column-setting.png) on the right and then click appstore-install-new-app.png. The Install New App dialog box is displayed.

  4. Click the Upload & Install button and upload the app tar file. The App is installed and is listed in the App store. After installation, you must start the app to get app running.

View App Store

The App Store has the administrator view and the user view.

Start/stop an App in the App Store
  1. On the App store, click the App settings button (column-setting.png) on the right. The App list is displayed.

  2. Click appstore-start-app.png in the Actions column corresponding to the app that you want to start. A notification is displayed after the app is started successfully.

    The App Status column displays Running corresponding to the app that is started.

    Click appstore-stop-app.png in the Actions column corresponding to the app that you want to stop. A notification is displayed after the app is stopped successfully.

    The App Status column displays Stopped corresponding to the app that is stopped.

Monitor the App resources in App Store

As an administrator, you can view the list of all the apps in the App Store and monitor the set resources.

Click the App settings button (column-setting.png) on the right. The App list is displayed.

appstore-app-list.png

The following columns are shown:

Columns

Description

App Name

Name of the app.

App Status

Status of the app; Running or Stopped.

Resources

The following resources can be shown based on the ones that you have set:

  • Process count

  • Number of threads

  • RSS

  • Memory percentage

  • VMS

  • CPU time

  • CPU percentage

The resource usage is shown for each resource, and the resource limit set for the resources is superscripted adjacent to the resource usage.

For example, in the following image, for the Dashboard app, the process count is 5, whereas the limit is (20).

appstore-resource-usage-example.png

Actions

The following actions can be performed:

  • 46-edit.png Add/edit resource usage.

  • appstore-start-app.png/appstore-stop-app.png Start/stop an app.

  • 46-trash.png Uninstall an app.

  • View.png Open an app.

  • appstore-eventlog-icon.png Check the event log of an app.

Set resource limits for an App

If you are an App store administrator, you can add specific resources for an app that you can monitor. In the App store, you are notified if an App has overrun the set resources. Also, the app is stopped automatically if its resource usage exceeds the specified limit.

  1. On the App store, click the App settings button (column-setting.png) on the right. The App list is displayed.

  2. Click 46-edit.png in the Actions column corresponding to the app for which you want to add the resource limit. The Resource setting page is displayed.

  3. Click CyanWhitePlus.png correspond to the app for which you want to add a resource. You can add the following resources:

    • Process count

    • Number of threads

    • RSS

    • Memory percentage

    • VMS

    • CPU time

    • CPU percentage

  4. Set the following for the selected resource:

    • Limit

    • Unit

  5. Click appstore-resource-save.png and click Yes to confirm. The resources are added and you can monitor the resource usage from the App list.

Editing resource limit for an App

If you are an App store administrator, you can set a specific limit for the resources utilized by the app.

  1. On the App store, click the App settings button (column-setting.png) on the right. The App list is displayed.

  2. Click 46-edit.png in the Actions column corresponding to the app for which you want to edit the resource limit. The Resource setting page is displayed.

  3. Set the following for the selected resource:

    • Limit

    • Unit

  4. Click appstore-resource-save.png and click Yes to confirm. The resource limits are set and you can monitor the resource usage from the App list.

Check event logs of an App in App Store

In case your App has stopped suddenly or you detect any other irregularity in the normal functioning of your app, you can check the event log to analyze the issue.

  1. On the App store, click the App settings button (column-setting.png) on the right. The App list is displayed.

  2. Click appstore-eventlog-icon.png in the Actions column corresponding to the app for which you want to view the event log.

    The Logs page is displayed with the corresponding app logs. The time of the event, event type, and description are shown.

Uninstall an App in App Store
  1. On the App store, click the App settings button (column-setting.png) on the right. The App list is displayed.

  2. Click 46-trash.png in the Actions column corresponding to the app you want to uninstall.

  3. Click Yes to confirm. The app is uninstalled.

Open an App

On the Unravel UI, from the upper-right corner, click appstore-icon.png. The App store page is displayed, listing all the installed apps. Click the Open button corresponding to the app that you want to open.

If you are an administrator, you can either click the Go to Apps button on the upper right corner of the Administrator page, which will lead to the App store page, or in the app list, you can click View.png corresponding to the app that you want to open.