Skip to main content
Metoro lets you control which traces are sent from your cluster for ingestion. Trace filters can include or exclude traces based on trace attributes, helping reduce noise and avoid sending telemetry you do not need.

Configuring Trace Filters

You can configure trace filters from the settings page under the Data Ingestion Settings -> Trace Filters tab. Each trace filter consists of:
  1. Include/Exclude Pattern: Choose whether to include or exclude traces that match your filter
  2. Attribute Filters: Select trace attributes and values that should match the rule
  3. Excluded Attribute Filters: Optionally exclude traces with specific attribute values
  4. Status: Keep the filter active, or pause it temporarily

Pausing Filters

Pause a trace filter when you want to temporarily stop applying it without deleting the rule. Paused filters remain visible in settings and can be resumed later. While paused, the filter is not sent to exporters and does not affect which traces leave your cluster.

Include Filters

Include filters specify which traces should be sent to Metoro. Only traces matching the configured attributes will be sent out of your cluster.

Exclude Filters

Exclude filters prevent matching traces from being sent to Metoro. This is useful for reducing high-volume noise, excluding unneeded service traffic, or limiting ingestion to traces that are useful for debugging and alerting.

Best Practices

  1. Start with narrow filters and confirm they match the intended traffic.
  2. Pause a filter before deleting it if you may need to restore the same configuration.
  3. Review filters periodically so trace ingestion still matches your observability goals.
  4. Update trace-based alerts and dashboards if ingestion filters change the data they depend on.