Table of Contents

Starlink Enterprise

About

The purpose of this connector is to monitor Starlink devices through the Telemetry API and the Management API over HTTP using JSON files.

Starlink is an internet service that uses a satellite constellation in a low Earth orbit to deliver high-speed low-latency broadband internet. Because Starlink satellites are in a low orbit, at about 550 km from Earth, the round-trip data time between the user and a satellite is significantly lower compared to internet services that make use of single geostationary satellites.

The Starlink Telemetry API is a low-latency API for accessing the telemetry data from Starlink devices. This API is only available for enterprise accounts with an account manager. It is designed for users that have their own data infrastructure to monitor Starlink devices remotely. The API is stateless and will only respond with current telemetry data.

The Starlink Management API is used to activate, deactivate, and otherwise manage Starlink user terminals. Next to this, it can return paginated results containing data usage for the current and previous billing cycles for service lines on an account. Similar to the Telemetry API, this API is only available for enterprise accounts with an account manager.

The Starlink Enterprise connector was previously known as the Starlink Telemetry API connector. The name was changed to Starlink Enterprise when calls towards the Management API were added. The Starlink Enterprise 1.0.0.1 is the same connector as the Starlink Telemetry API 1.0.0.4. If you have any elements that are still using the Starlink Telemetry API, we recommend upgrading these to the latest version of the Starlink Enterprise connector.

Note

LEGAL NOTE: This connector (or package) is intended solely for use in production with Skyline's usage-based services model. Any other use is prohibited. For more detailed information, see Usage-based services. For inquiries regarding commercial production usage, contact Skyline Sales at sales@skyline.be.

Tip

To optimize your use of this connector, we recommend deploying our Standard Product Solution Starlink Enterprise via the Catalog. This way, you will also be able to use the complementary low-code app and standard available dashboards.

Key Features

  • Conditional telemetry polling: Configure telemetry polling per account.

  • User terminal details: View details on user terminals and service lines.

  • Data usage: Review and monitor your data usage per month or day by type of data consumed (fixed or mobile, priority or standard). Additional services or data consumed beyond the limit is also shown.

  • Simulation mode: Replicate real-world scenarios using a simulation extension with built-in logic based on mock accounts and user terminals.

  • User terminal dynamic virtual elements: Use separate child elements (DVE) to represent the different user terminals, allowing you to view and monitor their data separately. The DVEs will get created automatically using the Starlink Enterprise - User Terminal connector, which gets exported by this connector.

  • Ticketing system integration: Export a CSV file for customer data elements to ingest for ticketing. This CSV file contains basic info about all terminals with valid service lines.

Use Cases

Use Cases 1

Challenge: Marking terminals as offline.

Solution: The connector compares the telemetry data with the management data to distinguish the offline terminals from other terminals.

Benefit: Makes it clear which terminals can be ignored.

Use Cases 2

Challenge: Showing data usage as a stacked bar graph.

Solution: Data usage tables are built to easily create a stacked bar graph in a dashboard or low-code app.

Benefit: Shows the data usage similar to the web interface.

Use Cases 3

Challenge: Creating services with parameters from a subset of terminals.

Solution: Ability to create a dynamic virtual element per user terminal.

Benefit: Monitor the KPIs of the most relevant terminals only.

Use Cases 4

Challenge: Too many requests sent from the same IP address.

Solution: Conditional polling of telemetry data.

Benefit: Multiple elements can be created on different hosts. For example, accounts A and B can be polled from server Y, and accounts C and D can be polled from server Z. The overarching dashboard or low-code app can combine this data to show the info of every account.

Use Cases 5

Challenge: New column names and changing alert names.

Solution: Unexpected telemetry column names and alerts will be logged in the element log file.

Benefit: The element will indicate by itself when the connector needs to be extended.

Use Cases 6

Challenge: Monitoring based on alerts.

Solution: The connector shows each alert from a user terminal or from a router. Alerts will persist for as long as they are active.

Benefit: Web interface alerts are visible in the DataMiner Alarm Console.

Technical Reference

Prerequisites

  • DataMiner Feature Release 10.4.2 or higher.

  • Starlink API access: API credentials (Client ID, Client Secret) are required for authentication to enable polling.

Note

For detailed technical information, refer to our technical documentation.