Skip to content

Expeto xCore Metrics⚓︎

xCore Metrics Used in Default Alerts⚓︎

The following metrics appear in PromQL expressions within the default alerts of Expeto NMS. These metrics are commonly used to monitor key aspects of system health and performance.

Category Data Type Prometheus Metric Description
Client Metrics Total Clients xcore_clients Number of active clients connected to the xCore.
Throughput Metrics Upload Bytes xcore_upload_bytes_total Total bytes uploaded through the xCore.
Download Bytes xcore_download_bytes_total Total bytes downloaded through the xCore.
Authentication Metrics 3G MAP Auth Requests xcore_q_hlr_map_c_cs_send_auth_RqRcvd_total Total 3G MAP authentication requests received.
4G S6A Auth Requests xcore_q_hss_s6a_auth_retrieval_RqRcvd_total Total 4G S6A authentication requests received.
Session Metrics S1 Data Session Requests xcore_q_mme_s1_s1ap_initialCtx_setup_Rq_total Number of S1 initial context setup requests.
S5/S8 Session Requests xcore_q_pgw_s5_create_session_ReqRcvd_total Total S5/S8 session requests received.
S5/S8 Failed Responses xcore_q_pgw_s5_create_session_RespSentFail_total Number of failed responses for S5/S8 session creation requests.
Error Metrics License Errors xcore_license_error Tracks license-related errors in the system.
Uptime Metrics System Uptime xcore_uptime_minutes Total uptime of the system in minutes.
Radio Metrics eNodeB Radio Count xcore_privateradio_count, xcore_q_mme_procedures_s1_instances Number of private radios connected to the xCore.
Component Metrics HSS/SGW/PGW/GGSN Count xcore_sgw_count, xcore_pgw_count, xcore_hss_active, xcore_ggsn_count Counts of various network components in use.
Sync Metrics Sync Errors xcore_sync_mismatch, xcore_sync_missing, xcore_sync_extra Tracks synchronization mismatches, missing syncs, or extra syncs.
REST API Metrics REST Errors xcore_rest_5xx_responses_total Tracks total 5xx responses from the REST API.
Version Metrics Software Version xcore_version Tracks the current software version.
Log Metrics Error Logs log_metrics_error_total, log_metrics_fatal_total Tracks error and fatal log counts.

 

List of All Available xCore Metrics⚓︎

The following xcore- prefixed metrics can be used in PromQL expressions to create custom alerts for your xCore installation.

Client and Throughput Metrics⚓︎

  • xcore_clients: Number of clients connected to the xCore.
  • xcore_download_bytes_total: Total bytes downloaded through the xCore.
  • xcore_upload_bytes_total: Total bytes uploaded through the xCore.

Authentication Metrics⚓︎

  • xcore_q_hlr_map_c_cs_send_auth_FailMsgSent_total: Number of failed MAP authentication messages sent.
  • xcore_q_hlr_map_c_cs_send_auth_RqRcvd_total: Number of MAP authentication requests received.
  • xcore_q_hlr_map_c_cs_send_auth_RspSent_total: Number of MAP authentication responses sent.
  • xcore_q_hss_s6a_auth_retrieval_FailMsgSent_total: Number of failed S6A authentication messages sent.
  • xcore_q_hss_s6a_auth_retrieval_RqRcvd_total: Number of S6A authentication requests received.
  • xcore_q_hss_s6a_auth_retrieval_RspSent_total: Number of S6A authentication responses sent.

Session Metrics⚓︎

  • xcore_q_mme_s1_s1ap_initialCtx_setup_Rq_total: Total number of S1 initial context setup requests.
  • xcore_q_pgw_s5_create_session_ReqRcvd_total: Number of S5/S8 session requests received.
  • xcore_q_pgw_s5_create_session_RespSentFail_total: Number of failed responses for S5/S8 session requests.

Node and Component Metrics⚓︎

  • xcore_privateradio_count: Number of private radios connected to the xCore.
  • xcore_q_mme_procedures_s1_instances: Instances of S1 procedures in MME.
  • xcore_sgw_count: Count of SGW components in use.
  • xcore_pgw_count: Count of PGW components in use.
  • xcore_hss_active: Number of active HSS instances.
  • xcore_ggsn_count: Count of GGSN components in use.

Error Metrics⚓︎

  • xcore_license_error: Tracks license-related errors in the system.
  • xcore_sync_mismatch: Number of synchronization mismatches detected.
  • xcore_sync_missing: Number of missing synchronization events detected.
  • xcore_sync_extra: Number of extra synchronization events detected.

REST API Metrics⚓︎

  • xcore_rest_5xx_responses_total: Total number of 5xx errors from the REST API.
  • xcore_rest_2xx_responses_total: Total number of 2xx successful responses from the REST API.
  • xcore_rest_404_responses_total: Total number of 404 errors from the REST API.

Uptime and Version Metrics⚓︎

  • xcore_uptime_minutes: Total system uptime in minutes.
  • xcore_version: Current version of the xCore software.

Queue and Performance Metrics⚓︎

  • xcore_queue_status: Status of the xCore queue system.
  • xcore_quortus_version: Version information for Quortus.

Logging Metrics⚓︎

  • log_metrics_error_total: Total number of error-level log entries.
  • log_metrics_fatal_total: Total number of fatal-level log entries.

Miscellaneous Metrics⚓︎

  • xcore_epc_connections: Number of EPC connections established.
  • xcore_unhandledevents_total: Total number of unhandled events.

For further details, refer to the Prometheus Node Exporter documentation for system-level metrics and exporter configurations.

 

Node Metrics⚓︎

Prometheus node exporters provide insights into system-level metrics. Below are some commonly used metrics for monitoring the health of the system.

Category Metric Description
Disk Metrics node_filesystem_avail_bytes Available disk space in bytes.
CPU Metrics node_cpu_seconds_total Total CPU usage in seconds.
Network Metrics node_network_transmit_bytes_total Total transmitted network bytes.
node_network_receive_bytes_total Total received network bytes.
Memory Metrics node_memory_MemTotal_bytes Total system memory in bytes.
node_memory_MemFree_bytes Free system memory in bytes.
node_memory_Cached_bytes Cached memory usage in bytes.

Many more metrics are available. For a comprehensive list, refer to the Prometheus Node Exporter documentation.

 

Metric Exporters⚓︎

Metric exporters collect and send metrics from the xCore to the Prometheus master. Each exporter focuses on specific categories of metrics.

Exporter Name Prometheus Job Name Notes
Node Exporter job="node" Provides VM node metrics and server health.
**Docker Exporter ** job="docker" Collects metrics about Docker containers.
Prometheus job="prometheus" Collects metrics about Prometheus exporters.
xAgent Exporter job="xAgent" Provides metrics about the xCore host site.