Go to Celona
All Collections
Product and Developer Support
Celona Network Monitoring API: Status Codes

Celona Network Monitoring API: Status Codes

Example data, status codes, contexts & descriptions
Team Celona avatar
Written by Team Celona. Updated over a week ago

The Swaggerhub page for the Celona Network Monitoring API can be found at https://app.swaggerhub.com/apis/celonanetworks/celona-network_management_api/1.0.0

For each event type that you can subscribe to, we provide example data, a table of status codes, which may encompass additional contexts.

APSTATUS

{
    "event_name": "APSTATUS",
    "customer_name": "QAENV",
    "cluster_name": "G1-IndoorEdge",
    "site_name": "G1-IndoorSite2",
    "ap_name": "Indoor03",
    "message": "AP's status changed from 'Down' to 'Up'",
    "action": "For more diagnostics information, please click the Celona Assistant icon in 'https://qa-cso.celonanetworks.com/#/pages/access-points/1907CW57000007'",
    "timestamp": "2021-07-06 19:28:40.219576422 +0000 UTC",
    "serial_number": "1907CW57000007",
    "ipaddress": "5.24.67.5",
    "down_context": "ControlReady",
    "previous_status_code": 5,
    "current_status_code": 4
}

AP status codes

Note: these are the same values as data.status for the enodebs/{serialnumber} polling API endpoint.

0 - Unknown
1 - New
2 - Pending
3 - Provisioned
4 - Up
5 - Down
6 - Deployed

  • Unknown - The AP is in an Unknown state

  • New - The AP is assigned to a customer and can be added to a site

  • Pending - The AP is connected to a network before getting assigned to a site

  • Provisioned – The AP is assigned to a site and ready to be connected to a network (i.e. has not initiated bootstrap)

  • Up - AP is administratively UP, has S1 Up with the Edge, and ready to connect devices

  • Down - AP is not operational and cannot connect devices. The Down state can be associated with one of the following down_contexts

  • Deployed - The AP is assigned to a site and connected to a network (i.e. has initiated/completed bootstrap)

down_context

NoBootstrap
GlobalACSReady
LocalACSReady
SASReady
PendingSASGrant
AdminUp
Down

  • NoBootstrap - Access Point has not initiated bootstrap process

  • GlobalACSReady - Access Point initiated bootstrap process and downloaded configuration from Celona Orchestrator

  • LocalACSReady - Access Point reached Edge and downloaded configuration as part of the bootstrap process

  • SASReady - AP reached Edge, registered with SAS and received spectrum grants from SAS successfully

  • PendingSAS - AP reached Edge and waiting for spectrum grants from SAS. No channel grants available for this Access Point

  • AdminUp - Edge configured Access Point with available spectrum and Admin Up

  • Down - Access Point is unreachable from Edge

DEVICESTATUS

{
	"event_name": "DEVICESTATUS",
	"customer_name": "QAENV",
	"timestamp": "2021-03-06 01:55:10.670098817 +0000 UTC",
	"message": "Device Status changed from 'Provisioned' to 'Activated",
	"previous_status_code": 2,
    "current_status_code": 3
	"imsi": "315010998903111"
}

status_code

0 - Unknown
1 - New
2 - Provisioned
3 - Activated
4 - Deactivated 
5 - Connected
6 - Idle
7 - Disconnected 
8 - Blocked

  • New – The unassigned SIM in the Celona device inventory.

  • Provisioned – The SIM is assigned to a Celona Orchestrator account and can be activated to connect to the Celona network.

  • Activated – The SIM is active and exists in the Celona Edge database. It has not yet connected to the Celona network. It is allowed to connect to the network and consume network services as per the user profile.

  • Deactivated – The SIM is disabled and exists in the Celona Edge database. It cannot connect to the Celona network and user data sessions are not allowed.

  • Retired – The SIM is deactivated and has been removed from the Celona Edge database. All assigned profiles have been removed from the Celona Orchestrator.

  • Connected – The SIM is currently connected to the Celona network and has active data sessions from client devices.

  • Idle – The SIM is currently connected to the Celona network but has no active data sessions from client devices.

  • Disconnected – The SIM is active but not connected to the Celona network.

  • Blocked/Suspended – The SIM is blocked from connecting to the Celona network and all user data sessions have been removed from Celona Edge.

UEALERT

{
    "event_name": "UEALERT",
    "customer_name": "QAENV",
    "cluster_name": "G1-OutdoorEdge",
    "event_category": "UEALERT",
    "alert_context": "IMSIATTACHFAIL",
    "message": "315010999900092",
    "timestamp": "2021-06-12 16:20:06.272 +0000 UTC",
    "imsi": "315010999900092"
}

alert_context

INVALIDPLMNID
IMSINOTPRESENT
IMSIAUTHFAIL,
IMSIATTACHFAIL

  • INVALIDPLMNID - This alert is triggered when the PLMN ID in the UE connection request is not in our configured value. eNB itself will check for valid PLMN ID, so we will not see this alert

  • IMSINOTPRESENT - This alert is triggered when the IMSI is not in the configured devices list (or present in the device list but not activated)

  • IMSIAUTHFAIL - This alert is triggered when the verification of the SIM fails, most likely the SIM was incorrectly read by the device (due to any physical damage of the skin)

  • IMSIATTACHFAIL - This is a generic alert when a valid SIM failed to connect properly due to several other internal errors on the edge

DPALERT

{
    "event_name": "DPALERT",
    "customer_name": "QAENV",
    "cluster_name": "G1-IndoorEdge",
    "site_name": "G1-IndoorSite2",
    "ap_name": "Indoor03",
    "event_category": "DPALERT",
    "alert_context": "TERMINATEDSTATE",
    "message": "Grant ABCD was only AUTHORIZED until 2021-07-06T09:32:06.449896469-07:00; this heartbeat was received after that time, but the CBSD reported AUTHORIZED",
    "timestamp": "2021-07-06 16:33:17.565 +0000 UTC",
    "serial_number": "1202000240199PP0026",
    "channel_number": "0",
    "ipaddress": "5.24.67.5",
    "enb_ip_address": "5.24.55.5"
}

alert_context

SUSPENDEDSTATE
TERMINATEDSTATE
NOSPECTRUM
CPIERROR
CBSDBLACKLIST
FORCEDREREGISTER

  • SUSPENDEDSTATE - This alert is triggered when a channel granted to an AP is suspended by SAS because AP is deployed in a location with incumbent activity. All grants that cause too much interference to Navy operations are suspended

  • TERMINATEDSTATE - This alert is triggered when a channel granted to an AP is terminated. This happens when a channel allocated to Priority Access License (PAL) holder is activated or an incumbent is nearby. Celona Domain Proxy service will attempt to reallocate a new channel to the AP from the available channels

  • NOSPECTRUM - This alert is triggered when an AP has no spectrum available at that location. This is not commonly seen except for locations in Hawaii.

  • CPIERROR - This alert is triggered when the CPI parameters or the CPI certificate/installer credentials entered are incorrect

  • CBSDBLACKLIST - This alert is triggered when a specific AP has been blacklisted by SAS. This is a precautionary alert and hasn't been observed yet

  • FORCEDREREGISTER - When a registered AP needs to be reset to get new grants or needs to move from one location to another, this alert will be triggered as the AP will be deregistered and re-registered.

MEMORYALERT

This event triggers if the average memory utilization is more than 80%.

{
	"event_name": "MEMORYALERT",
	"customer_name": "QAENV",
	"cluster_name": "ajmay25",
	"node_id": "3782deea-e3d0-48b1-8396-d0222fc99c2b",
	"event_category": "NODEMEMORYSTATS",
	"message": "Memory utilization (87.982452) exceeded threshold. 3.33 GB of total 3.8 GB used",
	"timestamp": "2021-04-20 18:13:25.979 +0000 UTC",
	"ipaddress": "10.138.0.123"
}

CPUALERT

This event triggers if the average CPU utilization is more than 70%.

{
	"event_name": "CPUALERT",
	"customer_name": "QAENV",
	"cluster_name": "ajmay25",
	"node_id": "83bf98eb-673b-4d17-8aae-de3b1fecf34c",
	"event_category": "NODECPUSTATS",
	"message": "Average CPU utilization (72.788584) exceeded threshold",
	"timestamp": "2021-04-20 18:03:50.729 +0000 UTC",
	"ipaddress": "10.138.0.88"
}

EDGESTATUS

{
"event_name": "EDGESTATUS",
"customer_name": "Smoke",
"cluster_name": "ajmay25",
"event_category": "EDGESTATUS",
"event_type": "ALERT",
"message": "Edge status changed from 'Up' to 'Down'",
"action": "Please reach out to support@celona.io for additional information",
"timestamp": "2021-09-16 05:01:51.649 +0000 UTC",
"previous_status_code": 4,
"current_status_code": 5,
"edge_node_info": [
 {
  "serial_number": "b2f1c732-9f88-46a5-a4d8-a5890166d450",
  "node_type": "Leader",
  "sw_version": "1.16.0.20",
  "ipaddress": "10.138.0.28",
  "node_id": "d73954f8-e280-455b-b478-6bbec9f56f8a",
  "current_status_code": 5,
  "previous_status_code": 4
 }
]
}

status_code

1 - New
2 - Pending 
3 - Provisioned 
4 - Up
5 - Down

  • New – Edge is assigned to a customer and can be added to a cluster or site

  • Pending – Edge is connected to the network but not assigned to a cluster or site

  • Provisioned – Edge is assigned to a cluster or site and ready to be connected to the network

  • Up – Edge is connected to the network and reachable from Celona Orchestrator

  • Down – Edge may not be connected to the network or not reachable from Celona Orchestrator

Did this answer your question?