Getting started with DataHub

The Getting started section describes how to access Cumulocity IoT DataHub and walks you through the main UI features.

Accessing and logging into DataHub

You access Cumulocity IoT DataHub via a web browser. It has been tested with the following web browsers:

Info: Mobile devices like smartphones or tablets are not supported.

How to log into DataHub

After the Cumulocity IoT DataHub services have been subscribed for your tenant, you have to log into your tenant. In the application switcher you will find the DataHub button. When you click this button, you will be taken to the home page of DataHub. DataHub provides the management and monitoring UI of Cumulocity IoT DataHub. Alternatively your tenant administrator can give you the URL directly navigating to DataHub, which requires a login as well.

As working with DataHub requires you to have corresponding DataHub permissions, you will get a warning after login if you omit those permissions.

When you want to log out, click the User button at the right of the top bar and from the context menu select Logout.

Overview of UI features

DataHub provides the UI you use for managing and monitoring your offloading pipelines. The main navigation bar at the left provides links to the relevant pages. The access to these pages is restricted and depends on corresponding user roles/permissions as defined in section Defining DataHub permissions and roles.

Page Description Required role Prerequisites
Home Get an introduction to DataHub and access quick links with related functionality DATAHUB_READER, DATAHUB_ADMINISTRATOR, or DATAHUB_MANAGER -
Settings Set up DataHub DATAHUB_ADMINISTRATOR -
Offloading Configure and manage your offloading pipelines DATAHUB_ADMINISTRATOR or DATAHUB_MANAGER -
Auditing/Query log View the query log DATAHUB_READER, DATAHUB_ADMINISTRATOR, or DATAHUB_MANAGER Tracking of usage statistics has to be enabled
Auditing/System log View the system log DATAHUB_ADMINISTRATOR -
Status View the latest job status of your offloading pipelines DATAHUB_ADMINISTRATOR or DATAHUB_MANAGER -
Administration View usage statistics DATAHUB_READER, DATAHUB_ADMINISTRATOR, or DATAHUB_MANAGER Tracking of usage statistics has to be enabled
Administration Check system status DATAHUB_ADMINISTRATOR -
DataHub homepage

Tenant and user settings

The DataHub instance you have access to is tenant-specific, i.e., this instance solely serves your tenant. You use your Cumulocity IoT account to access your DataHub instance.

In addition to your Cumulocity IoT account, you have a separate account (which is created during the initial setup) for accessing Dremio. Contact your administrator for the Dremio account credentials. On the Home page there is a direct link to the Dremio instance under Quick links.