Issue Data

The UXI dashboard displays two types of issues: Threshold Issues and Test Failures.

The issue data available via the data push includes the issue uid, timestamp, sensor details, network, service, issue code, severity, event type and status.

You will receive a message when the issue event_type changes. For example when the issue is first CREATED on your dashboard and again when the issue is RESOLVED on your dashboard. If you are using Incident Detection you will receive messages when the issue is added to an incident (INCIDENT_ADDED) or removed from (INCIDENT_REMOVED) an incident. You will also receive messages if the issue is UPDATED. Therefore, for opening and closing tickets, it's recommended to use the event_type field to know when issues are open and resolved.

The issue data includes all issues, regardless of whether Incident Detection is enabled or whether mutes are applied. If you are only interested in being notified of incidents, you can enable the webhooks, email notifications, or the data push data type for Incidents.

Issue Schema

The issue schema is the same format for all issues. Some fields may contain null values if the data was not available at the time the issue was detected or is not applicable.

Name		Type	Comments
code		string	The issue code. See possible values at the bottom of this document.
context		object	Object containing context of the test result
	customer_uid	string	Customer UID
	hierarchy_node_name	string	The name of the group is directly above the sensor.
	hierarchy_node_path	string	dot delimited representation of the full sensor hierarchy
	interface_type	string	Interface type for the issue. Value could be “wifi” or "ethernet"
	mac_address	string	MAC address of the sensor (May be null)
	network_name	string	Alias of the network as defined in the dashboard (May be null)
	network_uid	string	Network UID
	sensor_name	string	Name of the sensor as defined in the dashboard (May be null)
	sensor_serial	string	Serial number of the sensor
	sensor_uid	string	UID of the sensor
	service_name	string	Name of the service as defined in the dashboard. (May be null)
	service_uid	string	Uid of the service. (May be null)
severity		string	Severity of the issue. Will be "WARNING" or "ERROR"
status		string	Status of the issue. Will be "CONFIRMED" or "RESOLVED"
timestamp		datetime	timestamp in YYYY-MM-DDThh:mm:ss (UTC time)
uid		string	Unique uid of the issue.
incident_uid		string	Incident UID the issue is part of. This only applies for dashboards with Incident detection and will only show when the issue is included an incident. Otherwise, this is null.
event_type		string	Can be one of the following: CREATED the issue is created RESOLVED the issue is resolved INCIDENT_ADDED the issue has been added to an incident. This only applies for dashboards using Incident detection. INCIDENT_REMOVED the issue has been removed from an incident. This only applies for dashboards using Incident detection. UPDATED the issue has been updated.

Here is a sample of the issue format:

   {
      "uid":"b8c2224a-63b3-4235-ac78-f4c1cf41238a",
      "code":"INTERNAL_HIGH_JITTER",
      "severity":"INFO",
      "status":"RESOLVED",
      "timestamp":"2022-11-08T19:20:00",
      "event_type":"RESOLVED",
      "incident_uid":null,
      "context":{
         "customer_uid":"7ae10733-a344-4f6c-8bc7-447ce3d76388",
         "hierarchy_node_path":"447ce3d76388.0f1e1b9c362e",
         "hierarchy_node_name":"Healthcare North Campus",
         "network_uid":"ssid-b4806328a465",
         "network_name":"Cape",
         "service_uid":"-N4iPH3Y1b9Bv6LCF17j",
         "service_name":"patient app",
         "sensor_uid":"49c6de35-a36e-42c0-8574-9f3248c36242",
         "sensor_serial":"CNGPKLQ01S",
         "sensor_name":"Pathology Lab",
         "interface_type":"wifi",
         "mac_address":"20:4c:03:37:2c:4d"
      }
   }

Note Regarding Names and UIDs:

In the issue data, sensor_name, network_name, hierarchy_node_name and service_name may change if an admin user changes the configuration in the UXI dashboard. However, the corresponding UIDs such as device_uid, network_uid and service_uid (if applicable to the test) and customer_uid will not change.

In addition, the uid for the issue is unique for that issue, so you can identify when the same issue was first detected and resolved.

Issue Codes

You may receive issue data with the following issue codes:

LOW_RSSI

LOW_BITRATE

LOW_TX_BITRATE

LOW_RX_BITRATE

HIGH_DHCP_RESPONSE_TIME

HIGH_DNS_RESPONSE_TIME

EXTERNAL_HIGH_LOSS

EXTERNAL_HIGH_LATENCY

INTERNATIONAL_CONNECTIVITY_DOWN

LOCAL_CONNECTIVITY_DOWN

DNS_FAILURE

DNS_UNREACHABLE

NO_CONNECTIVITY

GATEWAY_UNREACHABLE

NO_CONNECTIVITY_DNS

WIFI_NOT_ASSOCIATED

DHCP_FAILURE

DHCP_NO_OFFERS

DHCP_NO_GATEWAY

DHCP_NO_ROUTERS

WIFI_SSID_MISSING

WIFI_SSID_MISSING_IN_BAND

WIFI_BSSID_MISSING

WIFI_BSSID_MISSING_IN_BAND

WIFI_BSSID_INCORRECT_SSID

CAPTIVE_PORTAL_HTTP_404

CAPTIVE_PORTAL_HTTP_403

CAPTIVE_PORTAL_HTTP_500

CAPTIVE_PORTAL_HTTP_503

CAPTIVE_PORTAL_HTTP_504

CAPTIVE_PORTAL_LOGIN_FAILED

CAPTIVE_PORTAL_WRONG_NET

CAPTIVE_PORTAL_NO_REDIRECT

CAPTIVE_PORTAL_CONNECTION_FAILED

CAPTIVE_PORTAL_INCORRECT_PAGE

CAPTIVE_PORTAL_TIMEOUT

CAPTIVE_PORTAL_LIMIT_REACHED

CAPTIVE_PORTAL_BAD_STATUS_CODE

CAPTIVE_PORTAL_UNKNOWN_PAGE

CAPTIVE_PORTAL_TOO_MANY_REDIRECTS

RSSI_DROP

INTERNAL_HIGH_LOSS

INTERNAL_HIGH_LATENCY

INTERNAL_HIGH_JITTER

EXTERNAL_HIGH_JITTER

WIFI_ASSOCIATION_FAILED

UNEXPECTED_CAPTIVE_PORTAL

CAPTIVE_PORTAL_NOT_AUTHENTICATED

POWER_OUTAGE

INTERNAL_SERVICE_DNS_FAILURE

EXTERNAL_SERVICE_DNS_FAILURE

SSID_CASE_INCORRECT

INTERNAL_SERVICE_UNAVAILABLE

EXTERNAL_SERVICE_UNAVAILABLE

INTERNAL_SERVICE_TCP_PING_FAILED

EXTERNAL_SERVICE_TCP_PING_FAILED

WIFI_AUTHENTICATION_FAILED

UNKNOWN_CAPTIVE_PORTAL_FAILURE

CAPTIVE_PORTAL_LANDING_INACCESSIBLE

CAPTIVE_PORTAL_INCORRECT_REDIRECT

CAPTIVE_PORTAL_REDIRECT_CONN

CAPTIVE_PORTAL_LOGIN_CONN

CAPTIVE_PORTAL_LOGOUT_CONN

INTERNAL_HTTP_GENERIC_ERROR

INTERNAL_HTTP_TIMEOUT

INTERNAL_HTTP_SERVICE_NOT_KNOWN

INTERNAL_HTTP_CONNECTION_ERROR

INTERNAL_HTTP_TOO_MANY_REDIRECTS

INTERNAL_HTTP_STATUS_CODE_ERROR

INTERNAL_HTTP_UNKNOWN_ERROR

INTERNAL_HTTP_REDIRECT_SSL_ERROR

EXTERNAL_HTTP_GENERIC_ERROR

EXTERNAL_HTTP_TIMEOUT

EXTERNAL_HTTP_SERVICE_NOT_KNOWN

EXTERNAL_HTTP_CONNECTION_ERROR

EXTERNAL_HTTP_TOO_MANY_REDIRECTS

EXTERNAL_HTTP_STATUS_CODE_ERROR

EXTERNAL_HTTP_UNKNOWN_ERROR

EXTERNAL_HTTP_REDIRECT_SSL_ERROR

INTERNAL_HTTPS_GENERIC_ERROR

INTERNAL_HTTPS_TIMEOUT

INTERNAL_HTTPS_SERVICE_NOT_KNOWN

INTERNAL_HTTPS_CONNECTION_ERROR

INTERNAL_HTTPS_TOO_MANY_REDIRECTS

INTERNAL_HTTPS_STATUS_CODE_ERROR

INTERNAL_HTTPS_UNKNOWN_ERROR

EXTERNAL_HTTPS_GENERIC_ERROR

EXTERNAL_HTTPS_TIMEOUT

EXTERNAL_HTTPS_SERVICE_NOT_KNOWN

EXTERNAL_HTTPS_CONNECTION_ERROR

EXTERNAL_HTTPS_TOO_MANY_REDIRECTS

EXTERNAL_HTTPS_STATUS_CODE_ERROR

EXTERNAL_HTTPS_UNKNOWN_ERROR

PRIMARY_DNS_FAILURE

SECONDARY_DNS_FAILURE

INTERNAL_SSL_ERROR

EXTERNAL_SSL_ERROR

CAPTIVE_PORTAL_NO_CONN_AFTER

INTERNAL_DNS_NO_ANSWERS

EXTERNAL_DNS_NO_ANSWERS

DNS_NO_ANSWERS

NO_CONNECTIVITY_PAST_PORTAL

WIFI_4WAY_HANDSHAKE_FAILED

HIGH_RETRY_RATE

HIGH_CHANNEL_UTILISATION

WIFI_8021X_AUTHENTICATION_FAILED

WIFI_8021X_AUTHENTICATION_TIMEOUT

WIFI_8021X_AUTHENTICATION_UNKNOWN_CA

NO_NAMESERVERS_IN_LEASE

BAD_SKYPE

AP_SCAN_BSSID_IN_MULTIPLE_CHANNELS

NO_ETHERNET_CARRIER

INTERNAL_TELNET_SOCKET_EOF_ERROR

INTERNAL_TELNET_CONNECTION_ERROR

INTERNAL_TELNET_PROMPT_NOT_FOUND

INTERNAL_TELNET_SOCKET_TIMEOUT_ERROR

EXTERNAL_TELNET_SOCKET_EOF_ERROR

EXTERNAL_TELNET_CONNECTION_ERROR

EXTERNAL_TELNET_PROMPT_NOT_FOUND

EXTERNAL_TELNET_SOCKET_TIMEOUT_ERROR

HIGH_CAPTIVE_PORTAL_LOAD_TIME

LOW_INTERNAL_VOIP_MOS

LOW_EXTERNAL_VOIP_MOS

HIGH_EXTERNAL_TELNET_ELAPSED_TIME

HIGH_INTERNAL_TELNET_ELAPSED_TIME

SLACK_API_TIMEOUT

SLACK_API_FATAL_ERROR

SLACK_API_UNKNOWN_ERROR

SLACK_API_RATE_LIMIT_ERROR

SLACK_RTM_API_PONG_NOT_FOUND

SLACK_API_TOKEN_REQUIRED

SLACK_API_SSL_ERROR

SLACK_API_LOGIN_ERROR

SPEEDTEST_CONNECTION_ERROR

SPEEDTEST_UNKNOWN_ERROR

YOUTUBEDL_DL_ERROR

YOUTUBEDL_INFO_ERROR

YOUTUBEDL_STREAM_ERROR

SLACK_RTM_API_PONG_TIMEOUT

ETHERNET_8021X_AUTHENTICATION_FAILED

ETHERNET_8021X_AUTHENTICATION_TIMEOUT

ETHERNET_8021X_AUTHENTICATION_UNKNOWN_CA

STATIC_IP_BAD_CONFIG

INTERNAL_WEB_APP_TIMEOUT

EXTERNAL_WEB_APP_TIMEOUT

INTERNAL_WEB_APP_TARGETS_FAILED

EXTERNAL_WEB_APP_TARGETS_FAILED

EXTERNAL_WEB_APP_UNSUPPORTED_PROXY_METHOD

EXTERNAL_WEB_APP_PROXY_ALERT_TIMEOUT

EXTERNAL_WEB_APP_UNSUPPORTED_PROXY_TYPE

EXTERNAL_WEB_APP_PROXY_CONNECTION_REFUSED

EXTERNAL_WEB_APP_PROXY_AUTH_FAILED

EXTERNAL_WEB_APP_SSL_ERROR

INTERNAL_WEB_APP_UNSUPPORTED_PROXY_METHOD

INTERNAL_WEB_APP_UNSUPPORTED_PROXY_TYPE

INTERNAL_WEB_APP_PROXY_ALERT_TIMEOUT

INTERNAL_WEB_APP_PROXY_CONNECTION_REFUSED

INTERNAL_WEB_APP_PROXY_AUTH_FAILED

INTERNAL_WEB_APP_SSL_ERROR

EXTERNAL_WEB_APP_TEST_FAILED

INTERNAL_WEB_APP_TEST_FAILED

EXTERNAL_WEB_APP_RUNTIME_ERROR

INTERNAL_WEB_APP_RUNTIME_ERROR

EXTERNAL_WEB_APP_UNSUPPORTED_SIDE_SYNTAX

INTERNAL_WEB_APP_UNSUPPORTED_SIDE_SYNTAX

WIFI_SCEP_SERVER_BAD_RESPONSE

WIFI_SCEP_SERVER_NO_RESPONSE

WIFI_SCEP_SERVER_UNVERIFIABLE

WIFI_SCEP_BAD_REQUEST

WIFI_SCEP_DECRYPTION_ERROR

WIFI_SCEP_FAILURE

WIFI_SCEP_ENROLLMENT_NETWORK_FAILURE

ETHERNET_SCEP_SERVER_BAD_RESPONSE

ETHERNET_SCEP_SERVER_NO_RESPONSE

ETHERNET_SCEP_SERVER_UNVERIFIABLE

ETHERNET_SCEP_BAD_REQUEST

ETHERNET_SCEP_DECRYPTION_ERROR

ETHERNET_SCEP_FAILURE

ETHERNET_SCEP_ENROLLMENT_NETWORK_FAILURE

HIGH_EXTERNAL_WAT_ELAPSED_TIME

HIGH_INTERNAL_WAT_ELAPSED_TIME

ZEBRA_ROAM_FAILED

ZEBRA_VOICE_CALL_WARNING

INTERNAL_LIBRESPEED_SERVER_ERROR

EXTERNAL_LIBRESPEED_SERVER_ERROR

INTERNAL_LIBRESPEED_GENERIC_ERROR

EXTERNAL_LIBRESPEED_GENERIC_ERROR

INTERNAL_LIBRESPEED_TIMEOUT

EXTERNAL_LIBRESPEED_TIMEOUT