New Relic monitoring is built around the concept of the entity. This document explains:
- What entities are
- How to find entity data
- How to organize them into groups for easier analysis
What is an entity?
From a New Relic perspective, entity is a broad concept. An entity is anything New Relic can identify that has data you can monitor.
"Entity" can refer to fundamental data-reporting components like applications, hosts, and database services, but it can also refer to larger groupings of those components. For example, to monitor a data center, you could aggregate those hosts in New Relic to be a workload (a custom grouping of entities). That workload is, itself, also an entity.
This conceptual definition of "entity" is important because New Relic's goal is to give you practical information about the status of your business-important entities (and not just give you an unhelpfully large stream of assorted metrics and data). Our focus on entities, and the relationships between them, helps us optimize monitoring and troubleshooting of complex, modern systems.
Find and explore entities
An entity is anything that reports data to New Relic, so you'll find your entities wherever you see your data reporting in New Relic.
Some tips for finding and understanding entity data:
- Every entity has a unique global identifier (GUID) reported with the attribute
entityGuid. You can query entities in New Relic One's chart builder or in Insights.
- In New Relic One:
- Explore entity data using New Relic NerdGraph and the NerdGraph GraphiQL explorer at api.newrelic.com/graphiql.
Group and organize entities
You can place entities into groups that reflect business-important relationships in your organization. For example, you might group all entities related to a specific team or department, or related to a specific service. Or you might group multiple hosts together to reflect their grouping in a data center.
To group your entities:
|If you're in...||To group entities...|
|New Relic One||Use tags.|
|New Relic APM and Synthetics||Use labels.|