Contact Us 1-800-596-4880

Examining Traces

On US and EU Cloud instances of Anypoint Platform, use Traces to track the flow of requests that travel through service pipelines. Get data from the Open Telemetry (OTEL) spans that form your traces. Troubleshoot requests with errors or slow response times, optimize your resource allocation, and track calls end-to-end. Monitor the performance of a specific transaction as it travels through services.

Span list in Traces Overview
1 Traces in Anypoint Monitoring
2 Environment selector for your deployments (such as Sandbox or Production)
3 Filter field for queries that narrow the list of logs to return
4 List of spans for the supported agents, brokers, MCP servers, and Mule apps
5 Lookback selector for the period of time to capture in the Span List (from the default of 15 minutes to the last seven days)
6 Auto-Refresh every 5, 15, or 30 minutes, every hour, or one time per day
7 Manual refresh button

In addition to reviewing traces in Anypoint Monitoring, you can use Telemetry Exporter to export traces to third-party observability and analytics platforms.

Supported Traces

Traces include spans for:

  • Agentic assets: Agents, brokers, and MCP servers

  • Flows: Mule flows for the selected task of the specific service

  • Events: Mule runtime events or user actions for the selected service

Hosts

Traces in Anypoint Monitoring displays spans from entities deployed to:

  • CloudHub 2.0

  • Anypoint Runtime Fabric (Limited Availabilty)

Sampling Rate

Trace data sampling rate:

  • 100%: Agents, brokers, and MCP servers

  • 10%: Mule apps and APIs

Before You Begin

For all types of traces, these prerequisites apply:

  • The Anypoint Integration Advanced package or a Titanium subscription to Anypoint Platform

  • Permission to view Mule apps, APIs, and agentic assets (agent, broker, and MCP server instances) in Anypoint Monitoring

For Mule app and API tracing, these prerequisites apply:

Get Traces from Traces Overview

View a list of spans from across entities (agents, brokers, MCP servers, and Mule apps) in Traces Overview in Anypoint Monitoring. Get high-level details on each root span in a trace. Use filters to narrow the scope of spans in the Spans List. Get additional detail on each span in the hierarchy of spans that form a trace (from root span to its descendants).

  1. Log in to Anypoint Platform with a user account that has permission to access Anypoint Monitoring content.

  2. Navigate to Anypoint Monitoring.

  3. In the Anypoint Monitoring sidebar, click Traces.

  4. Make sure you’re using the business group that contains the spans.

  5. Select up to the last seven days of spans (see item 5).

    15 minutes is the default.

  6. Select the environment that contains your spans.

  7. Optionally, provide a filter query to narrow the search results.

  8. Get trace details.

Find Traces for Agent Visualizer Nodes

Agent Visualizer links to traces for agentic assets (agent, broker, and MCP server instances).

  1. In Agent Visualizer, click a node to open its detail card.

  2. Click View Traces to navigate to the traces for the node in Trace Details (in Anypoint Monitoring).

  3. Get trace details.

For more information about nodes in Agent Visualizer, see Agent Visualizer Overview.

Get Trace Details

After navigating to Trace Details from Traces Overview in Anypoint Monitoring or from a node in Agent Visualizer, get information about the trace and its spans.

  1. Review information about the trace:

    Trace Details displays the selected instance’s traces in a span tree, starting from the root span for the instance.

    An instance’s spans in the Traces Details page
    1. Trace Details page for a span selected from Trace Overview or through a node in Agent Visualizer

    2. High-level data about the selected span:

      • Status Code: HTTP response status of the trace (for example, 0 No Response, 200 OK,500 Internal Server Error)

      • Span Start Time: The time the trace started, in UTC

      • Total Response Time: The time taken for the trace to execute

      • Root Span: The request or operation that initiated the trace

    3. Search for spans by full or partial matches to the span name

      The page displays matching spans.

    4. Trace hierarchy of spans, starting from the root span through its descendants

    5. Trace ID of the root span

  2. To get more information about a span in the details page, click the span:

    Details of a span in the Traces Details page
    1. Span Name: Name of the span.

    2. Span details

Filter Spans

To narrow the list of spans in Traces Overview, provide a filter query in the search field.

  1. Place your cursor within the search field and click to display a list of filters.

  2. Select a filter from the field’s dropdown.

    Filter Operators Description

    api_instance_id

    =

    Version of an API instance that’s associated with a span. You can find the instance’s ID in API Manager.

    correlation_id

    =

    Correlation ID associated with a span (see Correlation ID).

    entity_name

    =, IN

    Name of entities associated with spans.

    http_status_code

    =, IN

    HTTP status codes associated with span.

    span_id

    =

    ID of a span contained in traces.

    span_name

    =, IN

    Name of a span.

    trace_id

    =, IN

    ID associated with a span.

  3. Select an operator for the filter:

    • = accepts a single alphanumeric value.

    • IN accepts one or more comma-separated, alphanumeric values. The values get processed as logical ORs.

  4. Select a value from the search field’s Top Value list. If the value you’re looking for isn’t in the list, start typing a partial match to your value, and then select the value.

    Tip: If you’re providing search values to the IN operator (such as entity_name IN ['value1', 'value2']), manually adding a comma after a value before selecting another value from the Top Value list can help with valid query formation.

    Example:

    This example gets spans named my-span that have status code '404', '502', or '200':

    http_status_code IN [ '404', '502', '200' ] span_name = my-span

To edit or delete a filter, click the filter, and then click Edit Filter or Delete Filter from the Actions list for the filter. To avoid issues when editing, you can delete the filter and then add it back with the values you want.

Tips:

  • If no traces appear after applying a query, change your filters, the lookback setting, or business group.

  • Selecting multiple filters of the same type isn’t allowed.

  • Filters get processed as logical ANDs. If a span doesn’t match one of the filters, the query won’t return spans.

Span Details

Traces provide information about a root span and its descendants in dedicated Trace Details pages. Each span listed on the page links to details about that span:

  • Span Duration: Time the span took to execute

  • Span Status: Status of the span (OK, ERROR, Unset)

  • Span ID: ID of the span

  • Span Kind: Source of the span operation or request (Server, Internal, Client)

  • Span Start Time: Time that the span started, in UTC

  • Trace ID: ID of the trace in which the span occurred

  • Correlation ID: Unique identifier that’s generated before sending an event to the next processor in the Mule flow (see Correlation ID)

  • HTTP Status Code: HTTP status code of a span that is a request. Statuses include 0 No Response, 200 OK, and 500 Internal Server Error.

  • Entity Type: Type of entity associated with the trace. Types include App, API.

  • Entity Name: Name of the entity associated with the trace

  • Business Group that the span belongs to

  • Environment that the span belongs to

  • Parent Span ID: ID of a span that contains the selected span

    Parent spans don’t have a value in this field. Use the Trace ID to track this span.

  • View Logs: Find the root span in Anypoint Monitoring logs.

Environments

Select the environment containing the spans you want to review in Traces Overview.

Your organization administrator creates the environments that are available to you.

Anypoint Platform supports these types of environments:

  • Design

  • Production

  • Sandbox

Business Groups

If you work from the root organization level, you can query all spans across the entire organization. If you’re working from a business group that’s a descendant of the root, the query returns spans from that business group only.

To view or select a different business group, use the business group dropdown.

Business group menu
1 Business group that contains spans in the Span List
2 Selectable business groups

In the example, the root organization is active.