Overview

In Datadog, you can rename inferred entities, including datastores and queues, to make them easier to identify and manage. Renaming rules let you override the peer.service tag on spans with custom names, or generate names dynamically using tags and regular expressions.

Renaming 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: Renaming applies only to inferred entities, which are entities that Datadog identifies automatically.

Prerequisites

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

Create a renaming rule

Step 1: Select entities to rename

1. In Datadog, navigate to APM > Settings > Service Renaming and click + Add Rule.

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

2. Use the search bar to select the entities you want to rename.

   1. You can select one or more entities, but all must be of the same type (service, datastore, or queue).
   2. As you select entities, a span query is built in the background. To edit the query, select the code icon to the right of the search bar.

Step 2: Choose a rename method

1. In the text box, enter a unique name for the selected entity (or entities). Alternatively, use tag values with the {{tagName}} syntax to rename 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. Enter a descriptive name for the renaming rule so you can identify it later.
2. Review and save your renaming rule.

Note: Rules are processed at intake and applied to data as it comes in. Therefore, they are irreversible and should be created with caution.

Further reading

お役に立つドキュメント、リンクや記事:

Inferred servicesDOCUMENTATION