Remapping rules for inferred entities

Overview

In Datadog, you can remap inferred entities, including datastores and queues, to make them easier to identify and manage. Remapping rules let you override the peer.service tag on spans with custom names, or generate names dynamically using tags and regular expressions. This functionality applies across all of APM, not only in the Catalog. After a rule is created, the updated names appear consistently in service maps, Trace Explorer, monitors, dashboards, and any other APM view.

Remapping is useful when:

• The default name does not match your preferences or conventions.
• Services that you expect to appear as one are split into multiple inferred entities.
• Multiple components are grouped under one name, but you want them represented separately.

Note: This page describes inferred entity remapping only. To remap your instrumented (traced) services, Service Remapping Rules is available in preview.

Prerequisites

You must have the apm_service_renaming_write permission to create remapping rules. See Permissions for details on Datadog role-based access control.

Create a remapping rule

Step 1: Select remapping action and entities to target

1. In Datadog, navigate to APM > Catalog > Manage > Manage Remapping Rules and click + Add Rule.

   Alternatively, navigate to APM > Catalog and click on a service to open the service side panel. From there, click Service Page > Service Remapping.

2. Choose a remapping action you want to perform for your new remapping rule.

   You can select to split a single entity, rename an entity, merge multiple entities together, or remap several entities.

3. Use the search bar to select the entities you want to remap.

   • You can select one or more entities, but all must be of the same type (service, datastore, or queue).
   • As you select entities, a span query is built in the background. To edit the query, select Build Advanced Query.

Step 2: Specify new entity name

1. In the text box, enter a unique name for the selected entity (or entities). Alternatively, use tag values with the {{tagName}} syntax to remap based on an entity’s tags.
2. If tag values follow a pattern, apply a regular expression to extract only the portion you want in the name.

Step 3: Name your rule and review

1. Optionally, enter a descriptive name for the remapping rule so you can identify it later.
2. Review and save your remapping rule.

Further reading

Request a personalized demo