Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,171 @@
---
title: "Infrastructure catalog"
tag:
- "Service Architecture Intelligence"
- "Infrastructure"
- "Catalog"
metaDescription: "Infrastructure catalog helps you manage your infrastructure resources in New Relic."
freshnessValidatedDate: never
---

<Callout variant="caution" title="Preview">
We're still working on this feature, but we'd love for you to try it out!

This feature is currently provided as part of a preview pursuant to our [pre-release policies](/docs/licenses/license-information/referenced-policies/new-relic-pre-release-policy/).
</Callout>

The Infrastructure Catalog provides a complete inventory of all your infrastructure entities. Use it to manage resources, accelerate root cause analysis, and identify observability gaps. The catalog displays key information for each resource, including high-level details, ownership, configuration data, and its relationships with other resources, applications, and services.

Data is populated automatically from New Relic infrastructure agents and cloud integrations.

## Key features [#key-features]

* **Centralized resource view:** Gain a high-level, cross-account view of your infrastructure resources. Filter and group by attributes like resource category, entity type, region, environment, or team to improve organization and visibility.

* **Application and service mapping:** See which applications and services are running on each compute resource to quickly assess impact and triage issues.

* **Clear ownership and accountability:** Easily identify owners for both infrastructure components and their dependent applications or services. This clarifies accountability when infrastructure issues arise.

* **Actionable resource insights:** Access insights into infrastructure activity—including health status, related incidents, scorecards, and more—to inform your resource optimization efforts.

* **Detailed resource configuration:** Quickly access current configuration data for each resource, enabling faster debugging and reducing context switching.

## Access the Infrastructure catalog [#access-infra-catalog]

The Infrastructure catalog is available in the New Relic platform, providing a comprehensive view of your infrastructure resources. You can use it to manage your resources, accelerate root cause analysis, and identify observability gaps.

**Prerequisites:**

* Enable the Catalogs in your New Relic account. For more information, refer [Enable the Catalogs](https://docs.newrelic.com/docs/service-architecture-intelligence/catalogs/catalogs/#enable-catalogs).
* (Recommended) Turn on [Autodiscovery](/docs/infrastructure/amazon-integrations/connect/set-up-auto-discovery-of-aws-entities/) to see how your applications connect to their underlying infrastructure resources. This helps you get more value from the Infrastructure catalog.

**To access the Infrastructure catalog inventory:**

1. Log in to your New Relic platform.
2. Go to the left navigation pane > Catalogs > Infrastructure catalog.

<img
title="Infra Catalog"
alt="Infrastructure Catalog view with infrastructure entities, hosts, and services organized in a searchable interface"
src="/images/infra-1.webp"
/>

The Infrastructure Catalog page displays multiple columns to present various information for an infra resource:

<table>
<thead>
<tr>
<th>UI</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Name</td>
<td>
The name of the infrastructure entity.
<ul>
<li>Click entity name to open its Entity Overview page.</li>
<li>Hover over the entity name to view additional details in a pop-up. You can also click links within this pop-up.</li>
</ul>
</td>
</tr>
<tr>
<td>Type</td>
<td>The type of the infrastructure resource. For example, `Host`, `KubernetesCluster`.</td>
</tr>
<tr>
<td>Category</td>
<td>
A high-level grouping of resources. Supported categories include:
<ul>
<li>`AI + ML`</li>
<li>`Analytics`</li>
<li>`Compute`</li>
<li>`Database`</li>
<li>`Networking`</li>
<li>`Other`</li>
<li>`Queues/Streams/Events`</li>
<li>`Security & Identity`</li>
<li>`Storage`</li>
</ul>
</td>
</tr>
<tr>
<td>Cloud</td>
<td>The cloud provider for the entity. It can be `AWS`, `Azure`, `GCP`, or any other. For `Hosts` and `Containers`, the cloud provider is determined by checking the `cloudProvider` tag. For all other entity types, the cloud is automatically identified.</td>
</tr>
<tr>
<td>Score</td>
<td>The percentage of scorecard rules passed by the entity. This value helps you measure how entities are performing against best practices defined in the Scorecards capability. Hover over the score to view a summary. For more information, refer [Scorecards](https://docs.newrelic.com/docs/service-architecture-intelligence/scorecards/getting-started/).</td>
</tr>
<tr>
<td>Team</td>
<td>
The team responsible for the entity.
<ul>
<li>Click a team name to navigate to that team's page.</li>
<li>Hover over a team name to view additional details.</li>
<li>If a team is not assigned, click Assign Team and select the responsible team.</li>
</ul>
For more information, refer [Teams](https://docs.newrelic.com/docs/service-architecture-intelligence/teams/teams/).
</td>
</tr>
<tr>
<td>Services</td>
<td>The number of related services and applications running on the infrastructure resource. This data is derived from New Relic entity relationships to help you understand service-to-infrastructure dependencies. Hover over the number to see a list of related services. You can click links in the pop-up to navigate to those services.</td>
</tr>
<tr>
<td>Alerts</td>
<td>The number of active alerts impacting the entity within the last 24 hours. Hover over the cell to see a summary of recent alerts. Click links in the pop-up to view details for each alert. For more information, refer [Alerts](https://docs.newrelic.com/docs/alerts/overview/) and [Issues](https://docs.newrelic.com/docs/alerts/incident-management/Issues-and-Incident-management-and-response/).</td>
</tr>
<tr>
<td>Region</td>
<td>The geographic location or cloud provider region where the resource is deployed. This helps you understand data locality, latency, and compliance. The Region value is populated automatically by checking for values across a prioritized list of metadata tags. The first non-empty value found is used, which ensures consistent classification even when naming conventions vary.
The following tags are checked in order:
<ul>
<li>`region`</li>
<li>`cloud.region`</li>
<li>`aws.region`</li>
<li>`awsRegion`</li>
<li>`azure.regionName`</li>
<li>`gcp.region`</li>
</ul>
</td>
</tr>
<tr>
<td>Availability Zone</td>
<td>The isolated location within a cloud region where the resource is deployed. This is used for fault tolerance and high availability by distributing resources across multiple zones. The first non-empty value found is used, which ensures consistent classification even when naming conventions vary.
The following tags are checked in order:
<ul>
<li>`availabilityZone`</li>
<li>`cloud.availability_Zone`</li>
<li>`aws.availabilityZone`</li>
<li>`awsAvailabilityZone`</li>
<li>`azure.availabilityZone`</li>
<li>`gcp.zone`</li>
</ul>
</td>
</tr>
<tr>
<td>Environment</td>
<td>The stage or purpose of the resource in the software lifecycle. For example, `development`, `staging`, or `production`. This helps teams manage stability, testing, and deployment workflows. The first non-empty value found is used, which ensures consistent classification even when naming conventions vary.
The following tags are checked in order:
<ul>
<li>`Environment`</li>
<li>`environment`</li>
<li>`env`</li>
</ul>
</td>
</tr>
</tbody>
</table>

### Add new data [#add-new-data]

To add additional data to your Infrastructure catalog click **+ Add Data button** at the top right. Follow the on screen instructions to add data to your Infrastructure catalog. For more information on New Relic supported integrations, refer [Integrations](https://newrelic.com/instant-observability/).


### Limitations [#limitations]

No support for sorting data in the Infrastructure catalog page.
4 changes: 3 additions & 1 deletion src/nav/service-architecture-intelligence.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,9 @@ pages:
- title: Applications catalog
path: /docs/service-architecture-intelligence/catalogs/applications-catalog
- title: Repository catalog
path: /docs/service-architecture-intelligence/catalogs/repositoryCatalog
path: /docs/service-architecture-intelligence/catalogs/repository-catalog
- title: Infrastructure catalog
path: /docs/service-architecture-intelligence/catalogs/infrastructure-catalog
- title: Scorecards
pages:
- title: Getting started with Scorecards
Expand Down
Binary file added static/images/infra-1.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/infracatalogs.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading