Searching for Span Information

Background

In a distributed architecture, the calls between microservices are increasingly complex. When the response to an external request is slow or some requests are abnormal, you need to quickly locate the exception. On the trace page, you can filter traces by trace ID or based on multiple criteria.

Querying Span Information Based on Traces

1. Log in to the APM console.
2. In the navigation pane, choose Application Monitoring > Tracing.
3. Enter the following search criteria and click Search Trace.
   Figure 1 Tracing search result
   

   Table 1 Search criteria of traces

   Search Criterion	Description	Mandatory
   Application	Application to which the trace belongs.	Yes
   Region	Region where the trace is located.	Yes
   Component	Component to which the trace belongs.	No
   Environment	Environment to which the trace belongs.	No
   Instance	Instance to which the trace belongs.	No
   URL	There are REST URLs and real URLs. A REST URL contains a variable name (Example: /apm/get/{id}). A real URL is an actual URL.	No
   Exact Search	Whether to perform exact match on URLs. If this option is selected, exact match is performed. If this option is not selected, fuzzy match is performed.	No
   Call Method	HTTP method of the trace.	No
   Status Code	HTTP status code returned by the trace.	No
   Response Time	Response time range of the trace. You can specify the minimum and maximum response time to search for traces or leave them empty.	No
   Exception or Not	Whether to filter the traces that are regarded as exceptions.	No
   Trace ID	ID of a trace. If you specify this parameter, other search criteria become invalid and the search will be performed based on the trace ID you specify.	No

4. Click Other search criteria. Custom Parameter, Global Trace ID, and Application Code are displayed.
   Figure 2 Other search criteria
   

   Table 2 Search criteria of traces

   Search Criterion	Description	Mandatory
   Custom Parameter	If you have configured Key for Header Value Interception, Key for Parameter Value Interception, and Key for Cookie Value Interception for URL monitoring, you can set key=value to search.	No
   Global Trace ID	Global ID of a trace. If you specify this parameter, other search criteria become invalid and the search will be performed based on the trace ID you specify.	No
   Application Code	If you have configured Service Code Length, Key for Service Code Interception, and Normal Service Code, corresponding application codes will be collected. You can search information based on the application codes.	No

   • Custom Parameter
     Usage Instructions

     1. Configure Key for Header Value Interception, Key for Parameter Value Interception, and Key for Cookie Value Interception for URL monitoring. For details, see Configuring the URL Monitoring Item.
     2. In the Custom Parameter text box, set the parameters and values.
     3. Click Search Trace. The results are displayed on the right.
        Figure 3 Results of querying traces based on the custom parameters
        
   • Global Trace ID
     Usage Instructions

     1. Click the icon next to the target trace to view the global trace ID.
        Figure 4 Obtaining the global trace ID
        
     2. In the Global Trace ID text box, enter the global trace ID.
     3. Click Search Trace. The results are displayed on the right.
        Figure 5 Results of querying traces based on the global trace ID
        
   • Application Code
     Usage Instructions

     1. Configure Service Code Length, Key for Service Code Interception, and Normal Service Code for URL monitoring. For details, see Configuring the URL Monitoring Item.
        Figure 6 URL monitoring
        
     2. In the navigation pane, choose Application Monitoring > Tracing.
     3. Click to view the value of the service code, which corresponds to the application code.
        Figure 7 Viewing the service code
        
     4. In the Application Code text box, enter the application code.
        Figure 8 Searching for the traces corresponding to the code
        
     5. Click Search Trace. The results are displayed on the right.