Monitor Azure Private 5G Core Preview with Log Analytics
Log Analytics is a tool in the Azure portal used to edit and run log queries with data in Azure Monitor Logs. You can write queries to retrieve records or visualize data in charts, allowing you to monitor and analyze activity in your private mobile network.
Log Analytics currently can only be used to monitor private mobile networks that support 5G UEs. You can still monitor private mobile networks supporting 4G UEs from the local network using the packet core dashboards.
Enable Log Analytics
You'll need to carry out the steps in Enabling Log Analytics for Azure Private 5G Core before you can use Log Analytics with Azure Private 5G Core.
Log Analytics is part of Azure Monitor and is chargeable. Estimate costs provides information on estimating the cost of using Log Analytics to monitor your private mobile network. You shouldn't enable Log Analytics if you don't want to incur any costs. If you don't enable Log Analytics, you can still monitor your packet core instances from the local network using the packet core dashboards.
Access Log Analytics for a packet core instance
Once you've enabled Log Analytics, you can begin working with it in the Azure portal. Navigate to the Log Analytics workspace you assigned to the Kubernetes cluster on which a packet core instance is running. Select Logs from the left hand menu.
You'll then be shown the Log Analytics tool where you can enter your queries.
For detailed information on using the Log Analytics tool, see Overview of Log Analytics in Azure Monitor.
You can find a tutorial for writing queries using the Log Analytics tool at Get started with log queries in Azure Monitor. Each packet core instance streams the following logs to the Log Analytics tool. You can use these logs to construct queries that will allow you to monitor your private mobile network. You'll need to run all queries at the scope of the Kubernetes - Azure Arc resource that represents the Kubernetes cluster on which your packet core instance is running.
|subscribers_count||Number of successfully provisioned SIMs.|
|amf_registered_subscribers||Number of currently registered SIMs.|
|amf_connected_gnb||Number of gNodeBs that are currently connected to the Access and Mobility Management Function (AMF).|
|subgraph_counts||Number of active PDU sessions being handled by the User Plane Function (UPF).|
|cppe_bytes_total||Total number of bytes received or transmitted by the UPF at each interface since the UPF last restarted. The value is given as a 64-bit unsigned integer.|
|amfcc_mm_initial_registration_failure||Total number of failed initial registration attempts handled by the AMF.|
|amfcc_n1_auth_failure||Counter of Authentication Failure Non-Access Stratum (NAS) messages. The Authentication Failure NAS message is sent by the user equipment (UE) to the AMF to indicate that authentication of the network has failed.|
|amfcc_n1_auth_reject||Counter of Authentication Reject NAS messages. The Authentication Reject NAS message is sent by the AMF to the UE to indicate that the authentication procedure has failed and that the UE shall abort all activities.|
|amfn2_n2_pdu_session_resource_setup_request||Total number of PDU SESSION RESOURCE SETUP REQUEST Next Generation Application Protocol (NGAP) messages received by the AMF.|
|amfn2_n2_pdu_session_resource_setup_response||Total number of PDU SESSION RESOURCE SETUP RESPONSE NGAP messages received by the AMF.|
|amfn2_n2_pdu_session_resource_modify_request||Total number of PDU SESSION RESOURCE MODIFY REQUEST NGAP messages received by the AMF.|
|amfn2_n2_pdu_session_resource_modify_response||Total number of PDU SESSION RESOURCE MODIFY RESPONSE NGAP messages received by the AMF.|
|amfn2_n2_pdu_session_resource_release_command||Total number of PDU SESSION RESOURCE RELEASE COMMAND NGAP messages received by the AMF.|
|amfn2_n2_pdu_session_resource_release_response||Total number of PDU SESSION RESOURCE RELEASE RESPONSE NGAP messages received by the AMF.|
|amfcc_n1_service_reject||Total number of Service reject NAS messages received by the AMF.|
|amfn2_n2_pathswitch_request_failure||Total number of PATH SWITCH REQUEST FAILURE NGAP messages received by the AMF.|
|amfn2_n2_handover_failure||Total number of HANDOVER FAILURE NGAP messages received by the AMF.|
The following are some example queries you can run to retrieve logs relating to Key Performance Indicators (KPIs) for your private mobile network. You should run all of these queries at the scope of the Kubernetes - Azure Arc resource that represents the Kubernetes cluster on which your packet core instance is running.
InsightsMetrics | where Namespace == "prometheus" | where Name == "subgraph_counts" | summarize PduSessions=max(Val) by Time=TimeGenerated
let Time = InsightsMetrics | where Namespace == "prometheus" | summarize by Time=TimeGenerated; let RegisteredDevices = InsightsMetrics | where Namespace == "prometheus" | where Name == "amf_registered_subscribers" | summarize by RegisteredDevices=Val, Time=TimeGenerated; Time | join kind=leftouter (RegisteredDevices) on Time | project Time, RegisteredDevices
InsightsMetrics | where Namespace == "prometheus" | where Name == "amf_connected_gnb" | extend Time=TimeGenerated | extend GnBs=Val | project GnBs, Time
Log Analytics dashboards
Log Analytics dashboards can visualize all of your saved log queries, giving you the ability to find, correlate, and share data about your private mobile network.
You can find information on how to create a Log Analytics dashboard in Create and share dashboards of Log Analytics data.
You can also follow the steps in Create an overview Log Analytics dashboard using an ARM template to create an example overview dashboard. This dashboard includes charts to monitor important Key Performance Indicators (KPIs) for your private mobile network's operation, including throughput and the number of connected devices.
Log Analytics will ingest an average of 1.4 GB of data a day from each packet core instance. Monitor usage and estimated costs in Azure Monitor provides information on how to estimate the cost of using Log Analytics to monitor Azure Private 5G Core.