Export, upload and share traces

Azure Private 5G Core offers a distributed tracing web GUI, which you can use to collect detailed traces for signaling flows involving packet core instances. You can export these traces and upload them to a storage account to allow your support representative to access them and provide troubleshooting assistance.

Prerequisites

Create a storage account and blob container in Azure

When uploading and sharing a trace for the first time, you'll need to create a storage account and a container resource to store your traces. You can skip this step if this has already been done.

  1. Create a storage account with the following additional configuration:
    1. In the Advanced tab, select Enable storage account key access. This will allow your support representative to download traces stored in this account using the URLs you share with them.
    2. In the Data protection tab, under Access control, select Enable version-level immutability support. This will allow you to specify a time-based retention policy for the account in the next step.
  2. If you would like the traces in your storage account to be automatically deleted after a period of time, configure a default time-based retention policy for your storage account.
  3. Create a container for your traces.

Export trace from the distributed tracing web GUI

In this step, you'll export the trace from the distributed tracing web GUI and save it locally.

  1. Sign in to the distributed tracing web GUI as described in Access the distributed tracing web GUI.

  2. In the Search tab, specify the SUPI and time for the event you're interested in and select Search.

    Screenshot of the Search display in the distributed tracing web G U I, showing the S U P I search field and date and time range options.

  3. Find the relevant trace in the Diagnostics Search Results tab and select it.

    Screenshot of search results on a specific S U P I in the distributed tracing web G U I. It shows matching Successful P D U Session Establishment records.

  4. Select Export and save the file locally.

    Screenshot of the Summary view of a specific trace in the distributed tracing web G U I, providing information on a Successful P D U Session Establishment record. The Export button in the top ribbon is highlighted.

Upload trace to your blob container

You can now upload the trace to the container you created in Create a storage account and blob container in Azure.

  1. Sign in to the Azure portal.

  2. Navigate to your Storage account resource.

  3. In the Resource menu, select Containers.

    Screenshot of the Azure portal showing the Containers option in the resource menu of a Storage account resource.

  4. Select the container you created for your traces.

  5. Select Upload. In the Upload blob window, search for the trace file you exported in the previous step and upload it.

    Screenshot of the Azure portal showing the Overview display of a Container resource. The Upload button is highlighted.

Create URL for sharing the trace

You'll now generate a shared access signature (SAS) URL for your trace. Once you create the URL, you can share it with your support representative for assistance with troubleshooting.

  1. Navigate to your Container resource.

    Screenshot of the Azure portal showing the Overview display of a Container resource.

  2. Select the trace you'd like to share.

  3. Select the Generate SAS tab.

    Screenshot of the Azure portal showing the container overview and the trace blob information window. The Generate S A S tab is highlighted.

  4. Fill out the fields with the following configuration:

    1. Under Signing method, select Account key. This means anyone with access to the URL you generate will be able to paste it into a browser and download the trace.
    2. Under Permissions, select Read.
    3. Under Start and expiry date/time, set an expiration window of 48 hours for your token and URL.
    4. If you know the IP address from which your support representative will download the trace, set it under Allowed IP addresses. Otherwise, you can leave this blank.
  5. Select Generate SAS token and URL.

    Screenshot of the Azure portal showing the Generate S A S tab in the trace blob information window. The Generate S A S token and U R L button is highlighted.

  6. Copy the contents of the Blob SAS URL field and share the URL with your support representative.

Delete trace

You should free up space in your blob storage by deleting the traces you'll no longer need. To delete a trace:

  1. Navigate to your Container resource.
  2. Choose the trace you want to delete.
  3. Select Delete.

Screenshot of the Azure portal showing the Overview display of a Container resource. The Delete button is highlighted.

Next steps