RUM Custom Facets

Custom facets make custom attributes searchable and visible in the RUM sidebar, enabling you to filter and analyze RUM events based on your application-specific data.

Since creating Custom Facets impact indexing and query performance only an Admin user is currently allowed to add, modify, or delete them.

Overview

By default, custom attributes included in RUM events are stored but not immediately available for filtering in the RUM interface. Creating a custom facet indexes a custom attribute and adds it to the facet sidebar, allowing you to:

  • Filter RUM events by custom attribute values

  • Group and aggregate data by custom attributes in analytics

  • Create monitors and alerts based on custom attribute values

Create a Custom Facet

Custom facets are managed from RUM > Custom Facets, a dedicated page separate from the event explorer.

  1. Navigate to RUM > Custom Facets.

  2. Optionally, scope the list to one application using the Application filter at the top of the page (defaults to All Applications).

  3. Click Create custom facet.

  4. In the dialog, configure the facet:

    Application

    The application(s) this facet applies to, or All Applications.

    Friendly Name

    A user-friendly name for the facet that appears in the RUM sidebar, for example City.

    Attribute Path

    The dot-notation path to the custom attribute, for example context.work_city (only attributes under usr. or context. can be promoted to a custom facet).

  5. Click Create.

The custom facet appears in the RUM sidebar and becomes available for filtering and analysis within a minute.

Manage Custom Facets

Edit a Facet

To modify an existing custom facet’s friendly name:

  1. Navigate to RUM > Custom Facets.

  2. Find the facet you want to edit.

  3. Click the edit icon.

  4. Update the facet properties.

  5. Click Save.

Delete a Facet

To remove a custom facet:

  1. Navigate to RUM > Custom Facets.

  2. Find the facet you want to delete.

  3. Click the delete icon.

  4. Confirm the deletion.

Deleting a custom facet removes it from the RUM sidebar but does not delete the underlying custom attribute data from RUM events.

Considerations

  • Custom facets are available within a few minutes of creation

  • High-cardinality facets (attributes with many unique values) may impact query performance

  • All custom attribute values are stored and indexed as strings

  • Use low-cardinality values for optimal performance

Next Steps

  • RUM Custom Attributes: Learn how to add custom attributes to RUM events using the SDK

  • RUM Explorer: Use custom facets to filter and group RUM events in the Explorer