Here is information about how to use the current service maps feature. For help using the earlier service maps feature, see Legacy APM service maps.
Service maps helps you visualize dependencies quickly and easily across your environment. They help you see how all your entities work together across your system. You can use service maps to troubleshoot problems, see how your environment works together, and ensure that issues don’t have downstream repercussions.
Service maps also supports cross-account access so help you see relationships between entities for all your accounts.
Service maps work with distributed tracing to connect relationships between entities. Service maps are still functional if you have not enabled distributed tracing, but we recommend having distributed tracing enabled for all agents. This ensures a more consistent experience while using service maps.
For best results, update existing agents to the latest version. The required minimum agent versions for maps are:
To view service maps, from one.newrelic.com click Entity explorer. Once you select an entity to view, you can select service maps from the sidebar.
The map shows your upstream and downstream services: entities toward the left are upstream, entities toward the right are downstream. To add or remove connections to an entity:
- Hover over the entity in the map that you want to alter.
- Click add or remove more connections.
- In the connection list, keep boxes checked for the entities that you want to appear in the map. Unchecked entities will be removed from the map.
Each entity in a map displays a color dependent on its performance.
- Green: there are currently no violations for this entities performance.
- Yellow: there is an open warning violation for this entity.
- Red: there is an open critical violation for this entity.
- Gray: no alert conditions have been set for the entity
- White: agent not reporting. This means that the agent installed on the entity is not reporting any data. This is expected behavior for databases or externals.
one.newrelic.com > Dashboards: adding a service map to a dashboard provides context for the data being reported and where it's coming from.
You can add any service map to a dashboard. For example, if you have a dashboard showcasing performance metrics for several entities, adding a service map to the dashboard shows how all the entities are related and provides additional context about your system.
To add a service map to a dashboard:
- Go to one.newrelic.com and select the Entity explorer.
- Select an entity from the index.
- Click on Service map.
- Click Add to dashboard. Search for the dashboard you want to add the map to.
In the New Relic UI, your out-of-process services are referred to as web external or background external data. Externals and databases have slightly different features in service maps than other entity types:
- Unlike other entities that appear in service maps, externals are aggregates. Clicking on an external service in the map shows you the list of all the external services that are rolled up into the one external entity. This is to reduce map clutter, as some entities can have dozens of externals being reported.
- Databases are agentless. Because of this, alerts cannot be set for the database, as only see the service call is reported to New Relic.
If you are unable to view certain entities in New Relic One service maps, see Troubleshooting: Missing or obfuscated data in New Relic One.
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.