Configure business transaction rules

Create, apply, and view business transaction rules.

Note: This feature is only available in the Enterprise version.

Use business transaction rules to control which traces in a service are grouped as a business transaction.

You can configure the following rule actions:

  • Include: Create business transactions for traces that match this rule.

  • Exclude: Do not create business transactions for traces that match this rule.

After you set the rule action, you can configure the following types of business transaction rules:

  • Global tag rule: Creates a business transaction with traces that contain spans with a specified global tag value. Sets the business transaction name as the tag value.

    • This rule type is only supported for Include rule actions.

    • You can specify the environments that you want the rule to apply to.

  • Service rule: Creates a business transaction with traces that include a specified service or services.

    • Include rule actions support selecting 1 service, and Exclude rule actions support selecting multiple services.

    • The business transaction name can be set to the service:endpoint syntax using the service and endpoint name from the matched service span, the value of a specified tag from the matched service span, or a custom name.

    • You can specify the endpoints, environments, and root spans that you want the rule to apply to.

Splunk APM includes one default system-generated rule that can be turned off. For more information, see About the default business transaction rule.

Prerequisites

To configure business transaction rules, you must meet the following requirements:

Before you configure business transaction rules, you can optionally:

Create and apply a business transaction rule

Complete the following steps to create and apply a business transaction rule.

  1. From the Splunk Observability Cloud main menu, select Settings > APM business transactions.

  2. Select New Rule. Follow the on-screen instructions to create the rule.

  3. Select Create to save your changes and create the rule.

  4. In the Business Transaction Rules table, confirm that the toggle for the rule is enabled. If not, select the toggle to enable the rule.

  5. Adjust the priority of the new rule as needed. Rules are applied in the priority order defined by the table. By default, the newest rule has the highest priority.

  6. Select Save Changes to apply the new rule and priority order.

View the rule that generated a business transaction

A business transaction is automatically linked to the rule that generated it. Complete the following steps to view the rule that generated a business transaction.

  1. From the Splunk Observability Cloud main menu, select APM > Overview.

  2. Select the Business Transactions tab. In the table of business transactions, select the actions menu (...) for the business transaction.

  3. Select View associated business transaction rule.

    The Configure rule tab displays by default and shows the business transaction rule. You can also select the Business Transactions tab to see the list of business transactions generated by the rule that were active in the last hour.

View the business transactions generated by a rule

Complete the following steps to view the business transactions generated by a rule.

  1. From the Splunk Observability Cloud main menu, select Settings > APM business transactions.

  2. Select the edit icon for a business transaction.

  3. Select the Business Transactions tab. This tab displays the business transactions generated by the rule that were active in the past hour. To filter the list, enter a business transaction name in the search bar.

Next steps

After you create and apply a business transaction rule, you can monitor the new business transactions in the business transaction view. For more information, see: