Proxies Tab

This guide will walk you through how to access and use the feature effectively. It includes step-by-step instructions for navigating the interface, interpreting visual indicators, filtering the data, and understanding each field shown in the proxy detection tab.

In this guide, you will learn:

Feature Description

AGILITY’s Proxy Detection feature enriches network diagnostics by automatically identifying and classifying DIAMETER and HTTP/2 proxy components within network traces, including Diameter Routing Agents (DRA) and Service Communication Proxies (SCPs).

With this feature, you will have the capability to:

Identify proxy hops and quantify their impact on latency and packet routing, ensuring no “black box” in your transport layer analysis.
Understand end‑to‑end transport behaviors more thoroughly and accelerate troubleshooting.

Core Capabilities

Proxied Message Detection
Parses your DIAMETER Attribute‑Value Pairs and HTTP/2 headers to pinpoint every proxied transaction within a callflow.
Latency Measurement & Visualization
Calculates relay times for each proxy hop and displays them directly on sequence diagrams and in the Proxy Diagnostics tab.
Threshold‑Based Flagging
Automatically highlights any proxy hop whose relay time exceeds 100 ms, drawing immediate attention to potential bottlenecks.

🚪 Accessing the Proxies Tab

After completing your analysis, you can view proxy-related information (if available) by following these steps:

Select the relevant call flow from your results
Scroll down to the Core Features section, under the Flow Details page
Click on the Proxies tab to open the proxy detection view

Accessing the Proxies tab

Understanding the Proxies Table

This section provides detailed explanations for each column and data field in the Proxies table, helping you understand the meaning and purpose behind every value. The interface presents data organized by proxy sessions at the top level. Each session can be expanded to reveal a detailed, hop-by-hop breakdown of the exchanged messages.

We will explain the fields according to their level in the table — session-level fields first, followed by hop-level fields:

Session-Level Rows

These main rows display information organized at the session level. By default, rows are collapsed. You can expand the corresponding row to view detailed information about each session's hops.

Session-Level Rows: Default View

Pro Tip: Sessions are collapsed by default. To view all session details at once, click the "Expand All" button in the top-right corner. You can collapse them again anytime by clicking "Collapse All", which resets the view.

Column & Fields Descriptions

Field	Description	Actions

Field	Description	Actions
End-to-End ID	A unique session identifier used to track messages across the full communication path. For Diameter/DRA: based on the End-to-End Identifier AVP. For HTTP2/SCP: built by combining the interface name with a session number (e.g., `HTTP_API-1`).	Free Text Filter: Type to search Hyperlink: Opens the Packet Viewer with session attributes pre-filtered.
Protocol	Indicates the communication protocol used by the proxy. Supported values are HTTP2/SCP and Diameter/DRA.	Free Text Filter: Type to search
Interface	Specifies the telecommunications interface where the message was exchanged. This defines the type of connection between network components.	Free Text Filter: Type to search
Protocol Procedure	Describes the operation or service being performed: – For Diameter/DRA, this typically refers to an application like Credit Control. – For HTTP2/SCP, it indicates the specific service being accessed.	Free Text Filter: Type to search
Session Time (ms)	The cumulative duration of the entire proxy session, calculated by summing the time taken for each hop. This value reflects the total time it took for the request to travel through all proxy layers from start to finish.	N/A
Warnings	Chips indicate warning flags within the sessions. The session receives a warning whenever any response code change occurs, including changes between different success codes. Click here to check the icon meanings	N/A

Hop-Level Rows

These nested rows display hop-level information. Expand a session to view detailed data for each hop.

Hop-Level Rows: Default View

Column & Fields Descriptions

Field	Description	Actions

Field	Description	Actions
Hop & ID	This column displays both the Hop number and its corresponding ID. The hop indicates the order of the message within a specific communication hop. Useful for tracing message progression. The ID is a message-tracking identifier used between adjacent network peers (or proxies) to match incoming responses to the specific requests it sent over that connection. Format: `Hop - Hop by Hop ID` This detail is only available when using Diameter or DRA protocols.	Filter: Type to search
Message	Displays the message name, whether it's a request or a response. For response messages, the associated status or result code is shown when available. This column displays a warning whenever the response code changes.	Filter: Type to search
Time (ms)	The time delay (in milliseconds) between related messages. Helps identify latency or processing delays. Formula: Time difference between the current packet and the previous visible packet in the packet list. A warning appears when the time surpasses the configurable threshold. As an admin, you can adjust it in the application settings. Click here to learn how to adjust thresholds.	N/A
Source → Destination	This column displays more information about the location of proxies within a flow. You will see the frame number, its source and destination IP addresses. The frame number is the unique identifier for the packet frame containing the message. The source IP is the IP address of the system that sent the message. The destination IP is the IP address of the system that received the message. Format: `[Frame number]: Source IP → Destination IP` If a name is defined in AGILITY Settings under Hosts IP & Network Elements Mapping, it will be shown instead of the IP address. This feature is only available to admin users. Click here to learn how to adjust Hosts IPs & Network Elements.	Filter: Type to search
Diameter DRA Origin Host	Displays the fully qualified domain name (FQDN) of the Diameter client that initiated the request. This value uniquely identifies the originator of the message.	Filter: Type to search Copy: Hover to show the icon, then click to copy the content.
Diameter DRA Route Record	Appears in Answer messages to record the identity of each Diameter proxy that forwarded the original request, helping to trace the request path.	Filter: Type to search Copy: Hover to show the icon, then click to copy the content.
Diameter DRA Destination Host	Indicates the specific Diameter peer (typically a server) designated to handle the request. This ensures the message is routed directly to the intended recipient.	Filter: Type to search Copy: Hover to show the icon, then click to copy the content.
HTTP2 SCP Autority	Represents the authority component of the request URL, typically including the hostname and, optionally, the port number.	Filter: Type to search Copy: Hover to show the icon, then click to copy the content.
HTTP2 SCP Via	Lists the intermediate protocols and recipients (such as proxies or gateways) that the request or response has passed through, providing a trace of the message’s route.	Filter: Type to search Copy: Hover to show the icon, then click to copy the content.

Protocol attributes are not available in every message. They appear in the table only when the information is present in the data.

Icons and Chips Indicators in the Proxies Tab

The Proxies table uses visual icons and color-coded chips to help you quickly identify key issues or anomalies within message flows. Below are the current indicators and their meanings:

🕒 Clock Icon – High Delta Time Chip

Warning Chips: High Delta Time

This icon appears when the delta time (the time difference between related messages) exceeds the defined threshold, indicating a potential delay in message processing or transmission.

When you expand the session rows, delta times requiring your attention will be highlighted in yellow.

The threshold is currently fixed at 100 milliseconds, but admin users can configure this value under Application Settings.

⚠️ Warning Icon – Response Code Changed Chip

Warning Chips: Response Code Changed

This icon appears when the response code changes, signaling a potential issue or unexpected behavior in the communication flow.

When you expand the session rows, messages requiring your attention will be highlighted in yellow.

Hover over each icon in the UI for a tooltip with additional context.

Warning Scenarios for Response Code Changes

Success to Non-Success (2xxx → 3xxx, 4xxx, 5xxx): The first message with the error code is flagged.
Non-Success to Different Non-Success: The message with the new error code is flagged.
Non-Success to Success: The previous message with the error code is flagged (the success message is not flagged).
Success to Another Success: No message is flagged.
Session-Level Warning

Update Delta Time Thresholds (Admin Only)

Admin users can update the Delta Time thresholds on the Application Settings page within AGILITY:

From the main navigation sidebar, click Applications.

Main Navigation Menu: Application
At the top of the list, locate the Feature Enablement card.
Click on the Edit button to open the feature page.

Applications Settings: Feature Enablement

Edit the Proxy Warning Threshold (ms)

Complete the previous step to ensure the feature is accessible.
Click the Edit (✏️) button located near the dropdown menu under the Feature Enablement page.

Proxy Warning Threshold: Edit Button
Enter the desired value in the free text field.
Proxy Warning Threshold: Enter Value
Click "Save" to apply your changes.
1. Or, click "Cancel" if you don’t want to make any changes.
  Proxy Warning Threshold: Action buttons
When you save, a successful message will appear to confirm your action.
Proxy Warning Threshold: Successful Message

This change will apply the updated delta time threshold to all users across the system.

🔍 Filtering Data in the Proxies Table

The Proxies table supports interactive filtering to help you focus on the data that matters most. Here's how you can use the filtering features:

How to Filter Columns

Click on the column header by which you want to filter.
Enter a value that appears in the input field (text format).
The table will automatically update to show only rows that match your input.

The example below demonstrates how to filter for a specific frame by entering a value in the Frame column.
Example of how to filter a specific frame number

Sorting Time (ms)

The Time (ms) column supports sorting only, not text filtering.
Click the column header to sort the values in ascending or descending order.

Important Notes

Currently, only the HTTP2/SCP and Diameter/DRA protocols are supported.
The delta time warning threshold is system-defined at 100 ms by default.
Threshold values can only be modified by users with Admin privileges.