# Cellular Clarity

### Overview

This chart shows the signal strength for the cellular line over time. It also shows changes in cell tower ID, network and radio technology. The chart is only available for lines which have been set up as **Cellular Clarity** by an admin user.

<figure><picture><source srcset="/files/k9GU2Ljb87JOCER1tdIk" media="(prefers-color-scheme: dark)"><img src="/files/d01t9iTjN2uevc3jt75T" alt="Cellular Clarity Chart"></picture><figcaption></figcaption></figure>

### Options and colour coding

#### Options

[**Standard / MinMax** toggle](/details/details-page-options/standard-minmax-toggle.md)

#### Saved settings

The settings below will be remembered when you next log in:

* &#x20;Whether the panel is collapsed or expanded
* The status of any toggles

### Colour coding

When viewed for today only, each section on the Details page gives an indication if it is currently alerting and thus impacting the associated heat tile colour. Find out more about [colour coding](/details/details-page-options/colour-coding.md).&#x20;

### Cellular Signal Strength description

#### Download

For day view only, download the information to a CSV file&#x20;

**Vertical axis**

Shows scores from 0.0 (Poor) to 5.0 (Excellent). Excellent values are green and near 5 whilst poor values show in red and are closer to 0. Hover on the chart to see exact values.

**4.0**

The threshold is shown as a horizontal purple line on the chart with the actual threshold value on the far right. If configured, a health alert can be sent when the signal strength drops below the threshold.

**Horizontal axis**

Adjusts according to the selected time period to show hours in day view and days in week and month views; redraws if the time zone is changed at the top right of the Details page.

Note: When signal strength is lost, Highlight shows this as a gap in the chart. Whilst there is no signal strength, there is also no information on cell tower ID, network or radio technology so Highlight registers these values as 0 or null. Changes to null values are not shown as blips - only changes to genuine values are shown.

**Tower:**  Shows blips for changes in the cell tower ID\
Cradlepoint: Tower changes are not reported in Highlight as the data is not provided by the device

**Network:**   Shows blips for changes in the network - for example Vodafone to O2

**Radio:**  Shows blips for changes in the radio technology - for example LTE to Wcdma

#### Time period

Highlight displays the average recorded value for each signal strength data point in the time period:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td>Day</td><td>Shows multiple data points per hour (one for each polling period, usually five minutes)</td></tr><tr><td>Week</td><td>Shows 24 data points per day (every hour), Average for each hour is shown along with Min/Max values if selected</td></tr><tr><td>Month</td><td>Shows 6 data points per day (every 4 hours), Average for each period is shown along with Min/Max values if selected</td></tr></tbody></table>

{% hint style="success" %}
**RSRP default**\
If Highlight receives both RSRP and RSSI metrics, RSRP is used to generate the score. The tooltip shows RSSI in grey for information only. RSSI is used only when RSRP is "Unknown".
{% endhint %}

**From week or month view:** clicking any data point jumps to the selected day view.&#x20;

### Signal Strength Score

Highlight collects two signal strength metrics for a cellular connection: RSRP and RSSI. RSRP is a more accurate, precise metric and usually only available on 4G/5G connections (aka LTE). RSRP is the preferred default metric used to calculate a score between 0 (Poor) and 5 (Excellent). RSSI is only used when RSRP is not available. Using a signal strength score enables Highlight to easily handle a cellular connection which is swapping between 4G/5G (RSRP) and 3G (RSSI).

Scores are equivalent to the values as shown in this table:

| Score      | Meaning   | RSRP range     | RSSI range     |
| ---------- | --------- | -------------- | -------------- |
| 5          | Excellent | -83 and higher | -61 and higher |
| 4.0 to 4.9 | Excellent | -84 to -92     | -62 to -70     |
| 3.0 to 3.9 | Good      | -93 to -102    | -71 to -79     |
| 2.0 to 2.9 | Good      | -103 to -111   | -80 to -87     |
| 1.0 to 1.9 | Fair      | -112 to -121   | -88 to -96     |
| 0.1 to 0.9 | Poor      | -122 to -129   | -97 to -104    |
| 0          | Poor      | -130 and lower | -105 and lower |

If a threshold has been set then Highlight will send alerts when the score falls below the threshold consistently over a period of time. Refer to [the Alerting Threshold dialog.](/admin/admin-general-details/alerting-thresholds.md#cellular)

**When no Signal Strength values are available**

If we do not get a reading on RSRP nor on RSSI, then the score is set to Unknown with the following effects:

* On the chart, there's a gap in the data and no tooltip, unless Tower/Network/Radio are collected then tooltip shows Unknown for Score, RSRP and RSSI.
* On the chart daily CSV, the Score, RSRP and RSSI all show as blank/empty.
* For Alerting, Highlight decrements the Health fuel gauge for the watch for NULL values only if the threshold is set >0. This will eventually change the colour of the side bar - amber then red and send alerts if configured.
* For Reporting, Highlight excludes NULL periods when calculating the average.
* For Reporting API, no change.

### Zoom options

There are two methods to zoom in on charts: drag and click. Find out more about [zoom options.](/details/details-page-options/zoom-options.md)

### Background colours

Grey backgrounds indicate non-business hours and purple backgrounds indicate maintenance periods.  Find out more about [background colours](/details/details-page-options/background-colours.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.highlight.net/details/details-pages/cellular-clarity.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
