m3terDocumentation

Data Exports (Preview)

Note: Data Exports in Preview Release
Please note that the Data Exports feature is currently a Preview feature. See Feature Release Stages for Preview feature guidance.

The m3ter Data Export service allows you to export usage data and operational data from your m3ter Organization directly into your AWS S3 or Google Cloud Storage buckets:

  • Firstly, you can create Export Destinations and enable the Data Export service to export data to your AWS S3 or Google Cloud Storage buckets.

  • Secondly, use the Export Destinations you've set up to configure Export Schedules for usage or operational data exports at specified intervals of minutes, hours, or days.

  • Alternatively, select an Export Destination to run a one-off, ad-hoc, data export, delivered either to an existing Export Destination, or local device.

When setting up Export Schedules or running ad-hoc exports, you can define precisely the data you want included in the exported data set:

  • Usage Data. Define the usage data measurements ingested for your Organization by Meter and Account that you want to export.

  • Operational Data. Export the configuration and operational data for a range entities from your production environment, such as Bills and Bill Line Items, Prepayments/Commitments, Accounts, and Balances.

  • Export Format. Two file formats are available for data exports: .CSV or JSONL.

Export jobs are created for both export schedules and ad-hoc exports you've created, and you can open a page to review export jobs at any time to check their status.

If you want to download the content of a data export file locally, you can simply omit a destination when setting up either an Export schedule or an ad-hoc Export. When the Export job runs and has succeeded, a download button is provided on the Export jobs page.

In this way, the Data Export service is designed to facilitate business use cases where you want to export a clearly defined usage or operational data set extracted from your m3ter Organization, and which you can then use to drive other business applications such as dashboards or other business intelligence and reporting tools.

This section explains how to work with, create, and manage Data Exports for your m3ter Organization:

Important: Permissions for Data Export! For users to be able to create, manage, and run Data Exports for either usage or operational data in your Organization, they will need the following permissions assigned to them:

  • Create and Manage Exports. Create and Update configuration actions for config:exportDestination, config:exportSchedules, and config:exportStatus resources.

  • Run Exports. Download export action for exports:data resource.

  • Do not grant permission to manage data exports to users who shouldn't have access to all data in m3ter. See Understanding, Creating, and Managing Permission Policies.



Additional Support

Login to the Support portal for additional help and to send questions to our Support team.