Automap for troubleshooting entities

The New Relic automap feature displays entity-centric maps that help you troubleshoot incidents that cascade through interconnected services. With automap, you can pinpoint when and where an issue began by viewing the relationships around your affected entity.

To use automap, you need a New Relic account. If you don't already have one, you can sign up here for a free account.

How it works

Automap displays relationships between entities in your architecture based on direct calls between services. For example, services are represented as nodes on the map and direct calls are represented as arrows. The direction of the arrow shows you the direction of the call being made.

With automap, you get deeper insight into the upstream and downstream relationships surrounding your chosen entity. One feature of automap, for example, is the ability to adjust relationship depth so you can see just how far an incident has cascaded. In the following screenshot, you can see an automap view with the relationship depth set to One:

Automap shows relationships between entities, letting you navigate around your system architecture to track down issues.

Compare how automap expands outward from the source entity an additional level when the depth is set to Three.

To understand entities and relationships, as well as how the entity platform synthesizes both from telemetry data, see entities and relationships. To learn more about how automap fits in with our other maps experiences, see Maps in context


Automap auto-expand logic relies on the health status of an entity, which is largely determined by the alert status of that entity. For optimal troubleshooting with automap, ensure that your alerts are properly configured.

Open automap

You can access automap whenever you're in an omnimap-powered maps experience, such as service maps or workloads maps. The simplest way to access automap is by using the entity tooltip:

  1. Go to, then select either APM & services, Mobile, or Browser.
  2. Choose your source entity.
  3. Select Service map under the Monitor category.
  4. Hover your cursor over the entity, then click Map from this entity in the tooltip. An automap pane will open.

Automap is available for the following types of entities:

Entity type




Application service instrumented with a New Relic APM agent


Browser application instrumented with New Relic Browser agent


Services instrumented with OpenTelemetry, including Pixie-instrumented services


Mobile app instrumented with a New Relic agent




Synthetic monitor

Timewarp cursor: Go back in time

You can use the timewarp feature to explore changes between your entities from the last three hours. Simply move the Timewarp cursor to see health status changes.

Controls: See only what you need to see

De-emphasize certain entities on the map with Health Status, or hide entities entirely with Entity types. Keep in mind that toggling Health status will not remove nodes from your map. Instead, it'll remove the entity health outline around the nodes.

Map symbols

Here's a table showing the various health status icons:

Health status




Not alerting

Not configured