Introduction

Starlink is a satellite network developed by SpaceX to provide low-cost internet to remote locations. It is the world’s first and largest satellite constellation using low Earth orbit to deliver broadband internet capable of supporting streaming, online gaming, video calls, and more.

Generate credentials (client ID and client secret)

  • To onboard the Starlink integration, you need to generate a client ID and client secret. These credentials are essential for obtaining an authorization token, which is required to call the available API endpoints.
  • To set up API access, log into your Starlink account home page. In the Your Service Accounts section, click + in the top right corner to create a new service account. If you do not see the Your Service Accounts section, contact your account manager to inquire about access.
  • Fill in the applicable fields:
    • Name: Enter a name for your service account.
    • Secret: Provide the secret for your service account, which will be used for authentication.
    • Grant Type: Select Client Credentials (unless you have a specific reason to use Authorization Code).
  • Once the service account is created, a system-generated client ID will be provided. This client ID, along with the client secret of the service account, can be used to onboard the integration.

Discovery

The available resources under Starlink are as follows:

  • Starlink Account
  • Starlink User Terminal

Starlink publishes relationships between resources to provide a topological view and ease of maintenance. The hierarchy of Starlink resources is as follows:

  • Starlink Account
    • Starlink User Terminal

Configure the Integration

  1. From All Clients, select a client.

  2. Navigate to Setup > Account.

  3. Select the Integrations and Apps tab.

  4. The Installed Integrations page, where all the installed applications are displayed.
    Note: If there are no installed applications, it will navigate to the ADD APP page.

  5. Click + ADD on the Installed Integrations page. The Available Integrations and Apps page displays all the available applications along with the newly created application with the version.
    Note: You can even search for the application using the search option available. Also you can use the All Categories option to search.

  6. Click ADD under Starlink:

  7. In the Account Information page, enter your account information:

    Image

    FieldDescription
    Name(required) User-defined, descriptive integration name.
    Client Id(required) Enter client ID.
    Client Secret(required) Enter the client secret.
    Confirm Client Secret(required) Re-enter the client secret.
  8. Click Next.

  9. In the RESOURCE TYPE section, select:

    • ALL: All the existing and future resources will be discovered.
    • SELECT: You can select one or multiple resources to be discovered.
  10. In the DISCOVERY SCHEDULE section, select Recurrence Pattern to add one of the following patterns:

    • Minutes
    • Hourly
    • Daily
    • Weekly
    • Monthly
      Image
  11. Click SAVE.
    The application is now installed and displayed on the Installed Integration page. Use the search field to find the installed application.

  12. After configuring the integration, the Starlink metrics can be viewed from the Infrastructure page.

Monitoring

You can start collecting monitoring data without applying templates. Once the resources are discovered, OpsRamp supports monitoring the following metrics for Starlink User Terminal.

Click here to view the supported metrics
Native TypeMetric NameMetric Display NameUnitsDescription
Starlink User Terminalstarlink_downlink_throughputDownlink ThroughputMbpsRefers to the rate at which data is received from the Starlink satellite network to the user terminal.
starlink_uplink_throughputUplink ThroughputMbpsRefers to the rate at which data is sent from the user's terminal to the Starlink satellite network.
starlink_ping_drop_ratePing Drop RatePercentageAverage packet loss over the last 15 seconds is measured by sending pings at a frequency of 10 Hz to the Starlink point of presence. Pings that do not receive a response within 2 seconds are considered dropped. This metric ranges from 0.0 to 1.0, where 0 indicates no packet loss and 1 indicates complete packet loss.
starlink_ping_latencyPing LatencymsAverage ping latency from the Starlink user terminal to the Starlink point of presence.
starlink_obstructionObstructionPercentageMoving average percentage of time the Starlink user terminal has been obstructed.
starlink_uptimeUptimeSecondsTime since the device booted, in seconds.
starlink_signal_qualitySignal QualityPercentageSignal Quality is a metric derived from the Signal to Noise Ratio (SNR), typically ranging between 0 and 10 dB. This value is then represented as a percentage from 0% to 100%. Signal Quality will not report values exceeding 10 dB or falling below 0 dB.
starlink_H3CellIdH3CellIdn/aThe location of the user terminal represented as an H3 cell.

Alerting

Alerts received from the API are shown in the alerts section for the discovered resources.

OpsRamp supports alerting for the following alerts related to the Starlink User Terminal:

Alert NameDefinition
ethernet_slow_10mbpsEthernet link speed is negotiated to 10 Mbps.
ethernet_slow_100mbpsEthernet link speed is negotiated to 100 Mbps.
power_supply_thermal_throttlingThe power supply is indicating that it is overheating and may shut down soon.
actuator_motor_stuckThe Starlink actuator motor is currently jammed or stuck.
mast_not_verticalThe Starlink dish is not installed with the mast tilted more than 30 degrees from the vertical position.
unable_to_alignUnable to align to desired tilt direction.
power_disconnect_detectedStarlink detected that the previous reboot was due to a power loss.
thermal_shutdownThe Starlink has exceeded the maximum temperature thresholds and requires a reboot to recover.
thermal_throttleThe Starlink has exceeded the high temperature thresholds and will reduce the performance to a lower temperature.
disabled_no_active_accountThe service is disabled because the account or associated service line is not active.
disabled_too_far_from_service_addressThe service is disabled because the Starlink is too far from the service address.
disabled_no_service_in_oceanThe service is disabled because the Starlink is in the ocean without a service that supports maritime conditions.
disabled_invalid_countryThe service is disabled because the Starlink is in an unsupported country.
pop_changeThe Starlink point of presence (PoP) location has changed. This may result in a brief disconnect and an IP address change.
disabled_moving_while_not_mobileThe service is disabled because the Starlink device is mobile and lacks mobile service connectivity.
disabled_moving_too_fastThe service is disabled because the Starlink device is moving too fast without an aviation service plan.
high_time_obstructionThe Starlink system is detecting frequent obstructions within its field of view.
software_update_reboot_pendingA pending Starlink software update is scheduled to reboot at 3 AM local time (+/- 30 minutes).

External reference