Skip to main content

Intro

Connhex Exporter is a service designed to export data collected in Connhex Cloud in an asynchronous and scalable manner.

By operating asynchronously, Connhex Exporter allows resource-intensive operations, such as generating insightful reports or transforming data, to be performed without impacting other Connhex services.

Export tasks are executed in the background with low priority, ensuring there are no time limitations associated with the export process. This means that users can easily export all the datapoints received from a specific device: additionally, before exporting, data can be processed and grouped to calculate meaningful insights (check data decimation).

Connhex Exporter also integrates with the Connhex Notifications service, enabling the delivery of exported data to end users through customized notifications. This integration enhances the user experience by providing a convenient way to access the exported data.

There are three main components:

  • Requests: requests describe the export request that is triggered through an API call. They include information about the type of export (either one shot or recurring), optional notification details and export format options. You can find more details about export requests here.
  • Items: items specify which metrics are to be exported from Connhex Cloud and how they should be processed. They provide information about the time range, data processing requirements and other specifications for the export. An export request can contain multiple items. You can find more details about export items here.
  • Jobs: a job represents the execution of an export. It contains information about the export status and details about any associated notification. Since exports can be recurring (for example, exporting data every 15th of the month), there may be multiple jobs for the same export item. You can find more details about export jobs here.

Use cases​

The use cases for Connhex Exporter are quite straightforward. It can be utilized whenever you need to deliver data collected in Connhex Cloud to your end users, without having to be concerned about the performance impact of the task.