Introduction to health maps

The health map provides a single place to visually monitor the health of all your apps and their related hosts, prioritized by health status. Customize the page by using different views, filters, and toggles to organize the map in a way most relevant to you or your team. Use the health map to monitor applications and hosts in real-time, and quickly track down problems as they occur.

Requirements

At a minimum, you must meet these requirements to access and use the health map:

Best practices

The health map pulls data together from several New Relic products. To get the most out of the health map, New Relic recommends using the following New Relic features to their fullest:

  • New Relic Infrastructure: Create robust filter sets to meaningfully categorize hosts.
  • APM agents: Create robust labels to meaningfully categorize your applications.
  • New Relic Alerts: Create robust alert policies that cover all your applications, hosts, and alerting scenarios.

The health map is also especially useful if you are using container-ized apps on hosts (many instances of apps per host).

Features

health-map-demo-ss.png

maps.newrelic.com: The health map combines New Relic APM, Infrastructure, and Alerts data to display your applications and hosts prioritized by health status so you can see the health of all your systems in one single view.

Health map features include:

Entities prioritized by health

The health map organizes the page by primary entity boxes. Primary entity boxes contain current (refreshes every two minutes), at-a-glance health and performance data, secondary entities related to it, and links to relevant APM or Infrastructure UI pages for detailed performance data.

health map entity box

Example of a health map primary entity box with secondary entities. The health map prioritizes entities based on the health status of primary then secondary entities.

The health status is determined using data from New Relic Alerts. The health map prioritizes the entities by first sorting the primary entities by health status, then sorting those by the health status of their secondary entities (related apps or hosts).

The health map supports red, yellow, green, light green (not targeted by any conditions), and gray (application stopped reporting data) statuses for applications.

The health map supports red, yellow, and green statuses for hosts.

If you have a host not targeted by any conditions, it appears green on the health map. If a host is not reporting data to New Relic, it does not display on the health map unless you create an Infrastructure host not reporting condition.

Entities are prioritized to the top based on this order:

Entity sort order criteria
  1. Primary entities that have critical (red) health status ordered by:

    1. Count of secondary entities with critical (red) health status
    2. Count of secondary entities with warning (yellow) health status
    3. Count of secondary entities with green health status
    4. Count of secondary entities with light green health status (host view only)
  2. Primary entities that have warning (yellow) health status ordered by:

    1. Count of secondary entities with critical (red) health status
    2. Count of secondary entities with warning (yellow) health status
    3. Count of secondary entities with green health status
    4. Count of secondary entities with light green health status (host view only)
  3. Primary entities that have green health status ordered by:

    1. Count of secondary entities with critical (red) health status
    2. Count of secondary entities with warning (yellow) health status
    3. Count of secondary entities with green health status
    4. Count of secondary entities with light green health status (host view only)
  4. Count of secondary entities
  5. Name of entity
Views, filters, toggles

Use the Views dropdown to see the health of your system organized by your applications or your hosts.

You can then filter those views by label (apps) or filter set (hosts) to only see data most relevant to you or your team.

Use the Show metrics/hosts toggles to show more/less information in the entity boxes.

View Description
Applications and related hosts

Organizes the map by application entities to display for each app:

  • Health status color
  • Condition violation information, if any
  • Summary metrics
  • Health of related hosts the application is running on as reported by New Relic Infrastructure

Map includes an optional app label filter.

Hosts and related applications

Organizes the map by host entities to display for each host:

  • Health status color
  • Condition violation information, if any
  • Summary metrics
  • Health of related applications running on the host reported by New Relic APM

Map includes an optional host filter.

Filter sets and related hosts

Uses data reported by New Relic Infrastructure to display:

  • Health of the hosts in each filter set in New Relic Infrastructure

View and use health maps

To get the most out of your health map, see health maps best practices.

The health map represents the current state of your system. The map refreshes every two minutes. To view the health map:

  1. Ensure you meet the requirements to access the health map.
  2. From the New Relic menu bar, select Maps.
  3. Select a view from the View dropdown to organize the map by application, host, or Infrastructure filter sets.
  4. If using the views Applications and related hosts or Hosts and related applications, use the Filter dropdown to only display entities most interesting to you or your team.
  5. Optional: Toggle Show metrics or Show hosts to display more or less entity data.
  6. Optional: Display the health map on a TV / wallboard in your operations center to see your system's current health at a glance.
  7. If entities start showing critical (red) or warning (yellow) health statuses, hover over the entity or the Related hosts/apps tiles for violation information to quickly ascertain the scope and scale of the problem.
  8. Click through to the relevant APM or Infrastructure pages to get detailed information to start troubleshooting.

Use cases

The health map is designed to help Operations and DevOps professionals, who are responsible for the health of large, complex environments, understand:

The system's current health at a glance

You like to have a view up on the TV wallboard in your network operations center (NOC) that represents the health of all systems. You may be focused on a task and not notice when an alert comes in.

With a wallboard you can feel assured that you can always glance up to see if anything is on fire. Conversely, even though something is alerting, you like to see the applications and hosts that are healthy to help keep things in perspective.

Scope of the problem: What else is broken?

You are responsible for many applications at your company. At any point in time, something is alerting and because there are many applications deployed across many hosts, it’s difficult for you to keep track of everything and know what is experiencing problems.

The health map gives you a single place to see the health and relationship between all applications and hosts. You can easily correlate the alerting host with applications deployed to it and easily answer the question: What else is broken right now?

Scale of the problem: Use context to find a noisy neighbor

With container orchestration deploying containerized applications across many hosts, it’s difficult for you to understand the scale of the problem when you receive an alert for a host or groups of hosts.

By using the application view of the health map, you can see the alerting host along with all the other hosts serving the application.

If the issue is isolated to a single host, you can change to the host view of the health map to see what other applications are deployed on that host. In that view, you see that the host has four applications running and one of the applications is alerting on higher than normal throughput.

For more help

Join the discussion about New Relic APM in the New Relic Online Technical Community! The Technical Community is a public platform to discuss and troubleshoot your New Relic toolset.

If you need additional help, get support at support.newrelic.com.