Portal Configuration

Configuration of Data Streams

More technical details on integrating the different data Streamer and cloud systems can be found in the Developer section.

Setting up a Data Stream on the configuration tab in the 1NCE Customer Portal requires the customer to select the Stream Type to specify if just Event or Usage Data is desired.

An activated and configured stream will be enabled instantly, and the performance can be monitored. The current Remote Status is shown in the Customer Portal as HTTP status coded from the remote site. If a 200 (OK) is displayed, the Data Stream is operating normally. In case the receiving section is not reachable, or the configuration is invalid it will show a 500 HTTP error.

Data Streamer ConfigurationData Streamer Configuration

Data Streamer Configuration

Customers can pause and resume the stream at any time by using the action buttons next to the stream details.

For setting up the Data Streams for a Rest API, the specification of an API Callback is required. The 1NCE Data Stream acts as an HTTP Client and needs an HTTP Server to handle each Post. Every sent message includes an array of one or more objects.

Integration with Cloud Services

AWS Kinesis
Integration with AWS Kinesis requires an IAM Role with a Trust Relationship to the 1NCE Account and the right to write data to the desired Data Stream. It is suggested to create the required IAM Role using the provided Template link in the Customer Portal "Create IAM Role".

Kinesis Data Streamer InputKinesis Data Streamer Input

Kinesis Data Streamer Input

Since Kinesis is a regional service, a specification of the AWS region is required. You are required to specify the name of the Stream you want the data to be sent to.

AWS S3
Integration with IAM Role with a Trust Relationship to the 1NCE Account and the right to write data to the desired Bucket. It is suggested to create a dedicated IAM user for the connection. It is suggested to create the required IAM Role using the provided Template link in the Customer Portal "Create IAM Role".

Since S3 is a global service, with regional data locality, a specification of the AWS region is required. You are required to specify the name of the S3 Bucket you want the data to be stored in.

S3 Data Streamer inputS3 Data Streamer input

S3 Data Streamer input

The integration will deliver CSV files to the S3 Bucket in the following format:
Filename format events_YYYYMMDD_HHmmss.csv will be used for event data
Filename format cdr_YYYYMMDD_HHmmss.csv will be used for usage data

Keen.IO
Integration with keen.io offers the possibility to analyze and embed rich data about your SIM Cards.
The integration requires a keen.io account with a correct Project Key as well as the corresponding Write Key and a Collection Name.

Shortly after configuration first data is sent to keen.io. Incoming data can be explored on keen.io on the “Streams” tab. Depending on the stream type the customer configured one or two streams appear with the following names: 1NCEEventData & 1NCEUsageData.

Data Dog
Integration with DataDog provides real-time performance monitoring for your SIMs. In conjunction with the 1NCE Platform, it enables the customer to collect and analyze metrics about the usage of your SIM Cards. The customer can create dashboards and trigger alerts on specific situations.

The Integration requires a DataDog account with an active Application Key and API Key. The Region setting needs to match the region of the DataDog account.

Shortly after configuration the first data are sent to DataDog. Incoming data can be checked in the DataDog explorer and dashboards can be created.

The integration will deliver the following metrics:
volume
volume_tx
volume_rx
cost


Did this page help you?