Subscribe for a device using quality targets registered with Application Profiles. The operator sends a notification whenever the network's ability to meet these targets changes.
Crowds nearby cause the network to assess that it cannot meet the latency target. The operator sends a notification.
The network assesses that it can meet the latency target again. The operator sends another notification.
The set expiration time is reached. The subscription ends, and a notification gives the reason.
How it differs from a queryA query asks about now or a future time; a subscription sends notifications when the network assessment changes.
After a notificationRequest QoD to improve the connection, or adjust the app, such as its video quality.
Connectivity Insights Subscriptions: How it works
- Create subscriptionSubmit the device, the profile ID from Application Profiles, and the notification URL.
- Wait for an eventThe operator continuously assesses whether the network can meet these quality targets.
- Send notificationA notification is sent whenever the assessment changes. It can include assessments of whether each target can be met, plus details such as signal strength and connection technology.
Connectivity Insights Subscriptions: API spec
POST /subscriptions to create; GET /subscriptions to list; GET/DELETE /subscriptions/{subscriptionId} to look up or deleteprotocol (HTTP), sink, types, plus config.subscriptionDetail containing device device and applicationProfileId, with optional application server applicationServer| Event details | Meaning | Example |
|---|---|---|
| data.packetDelayBudget, data.targetMinDownstreamRate, data.targetMinUpstreamRate, data.packetlossErrorRate, data.jitter | Network assessment of each target (for items included in the response): meets the application requirements or unable to meet the application requirements | meets the application requirements |
| data.additionalKpis.signalStrength | Signal strength (if included): excellent, good, fair, poor, no signal | good |
| data.additionalKpis.connectivityType | Connection technology (if included): 5G-SA, 5G-NSA, 4G, 3G | 5G-SA |
| data.terminationReason | Subscription end reasons: MAX_EVENTS_REACHED, NETWORK_TERMINATED, SUBSCRIPTION_EXPIRED, ACCESS_TOKEN_EXPIRED, SUBSCRIPTION_DELETED | SUBSCRIPTION_EXPIRED |
Responses for three scenarios (excerpts)
org.camaraproject.connectivity-insights-subscriptions.v0.network-qualityNetwork quality eventunable to meet the application requirementsNetwork assessment: latency target cannot be metmeets the application requirementsNetwork assessment: latency target can be met5G-SAConnection technologyorg.camaraproject.connectivity-insights-subscriptions.v0.subscription-endedEndedSUBSCRIPTION_EXPIREDSubscription expiration time reachedSpec source: CAMARA ConnectivityInsights r3.2 (Connectivity Insights Subscriptions v0.6.0)