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