Ended Status is a Conviva system dimension that records how each session ended, so you can separate sessions the player closed from sessions Conviva closed because heartbeats stopped arriving. It is available in Trends as a filter, a drill-down, and a group-by, and it appears as a field in the Viewer Timeline, Viewer Sessions, and the Viewer module.
Ended Status is a system dimension: it is available by default and is not created or counted in Dimension Management.
Ended Status is recorded when the session ends, alongside the Ended Play.
Ended Status Values New Sep 30, 2026
Ended Status takes one of three values. The readable label is what appears in dimension tables, Viewer Sessions, and exports.
| Value | Meaning |
|---|---|
| Graceful End | The player or Conviva Sensor explicitly reported that the session ended. This is the normal, expected termination. |
| By Expiration | No heartbeat arrived within the expiration window, so Conviva closed the session. The client stopped reporting — the app was backgrounded or killed, the device slept, or the network dropped. |
| Not Ended | The session is still active, or it was revived after a late heartbeat arrived. |
For the length of the expiration window and how Conviva treats a session that revives afterwards, see Session Expiration and Revived Session Handling.
Ended Status shown per session in Viewer Sessions.
How Ended Status Interacts with Started-Type Metrics
Ended Status is assigned to a session only when it reaches a terminal outcome — Graceful End or By Expiration. A session that hasn't reached one of those outcomes yet is Not Ended. Because of this, how a metric behaves against Ended Status depends on whether that metric is counted at session start or when a session concludes:
- Metrics counted when a session concludes — Ended Plays, Exits Before Video Start (EBVS), and metrics derived from Ended Plays such as Video Playback Failures Technical (VPF-T) — only accumulate once a session has ended or exited, so they are always 0 against Not Ended.
- Metrics counted at session start — Attempts and Plays — are 'Started'-type metrics, counted in the interval the play started, whether or not the session has ended yet. These are the metrics most often filtered or broken out by Ended Status, and their behavior against it is less obvious.
Example: Attempts by Ended Status
Attempts, EBVS, Ended Plays, and VPF-T broken out by Ended Status.
In this example, Not Ended shows 148.56K Attempts but 0 for EBVS, Ended Plays, and VPF-T — these sessions started in the period but hadn't also ended or exited within it, so none of the metrics counted at session conclusion have a value yet. Graceful End and By Expiration each show the Attempts that both started and concluded within the same period, alongside the full Ended Plays, EBVS, and VPF-T counts for that outcome.
Because most viewing sessions last longer than a minute, a large share of Attempts or Plays falls under Not Ended at fine time granularities — widen the granularity (for example, to hourly or daily) to reduce how often a session's start and end interval land in different buckets.
Using Ended Status in Trends New Sep 30, 2026
Ended Status is available in Trends with a Beta badge. It behaves like any other dimension: add it from the dimension selector popup, use it as a filter chip, open it as a dimension table, or combine it with other dimensions — for example, Exits Before Video Start (EBVS) by Device Type and Ended Status.
Expired sessions inflate EBVS and other exit-related metrics, because a client that stopped reporting looks the same as a viewer who left. Filtering on Ended Status tells the two apart: a rise concentrated in By Expiration points at app or player instability, while a rise in Graceful End is ordinary viewer behavior.
Example: top errors on expired sessions
To find which errors drive failures on sessions that Conviva closed:
- In Trends, click + in the filter bar and add Ended Status equals By Expiration.
- Select the Video Playback Failures Technical (VPF-T) metric chip and open the Technical Error Code dimension table.
- Read off which errors drive failures on expired sessions.
In this example, Buffering Timeout Error accounts for more than half of all impacted Ended Plays.
Related Details
| Details | Description |
|---|---|
| Dashboards and Presentation |
|
| Dimensions | Yes. Ended Status is a Conviva system dimension — it is available by default and does not need to be created in Dimension Management. |
| Diagnostics | N/A |
| Manual Alert Support | No |
| AI Alert Support | No |
| Metric Adjustment | None |
For the full list of dimensions and metrics, see Metrics.