Skip to content
Draft
Show file tree
Hide file tree
Changes from 15 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
c877f1a
docs: Add Core Tracing documentation section
cbehera-newrelic Jan 6, 2026
4eae296
docs: Add Core Tracing to distributed tracing navigation
cbehera-newrelic Jan 6, 2026
b1dde90
docs: Correct Core Tracing intro based on product meeting
cbehera-newrelic Jan 6, 2026
6bab386
docs: update span configuration terminology (APM-only, Options 1-3)
cbehera-newrelic Jan 6, 2026
c28cd47
docs: complete terminology update - navigation and intro docs
cbehera-newrelic Jan 6, 2026
e8da743
docs: rewrite intro with user-first flow and concrete examples
cbehera-newrelic Jan 6, 2026
df74d6e
docs: reduce heading overload with bulleted lists
cbehera-newrelic Jan 6, 2026
09aea80
fixed mdx issue
cbehera-newrelic Jan 7, 2026
8df3f79
docs: address team feedback on Core Tracing documentation
cbehera-newrelic Jan 29, 2026
255d314
docs: add hybrid sampling strategy (Strategy 5)
tejaswaroop-nr Jan 30, 2026
0bf108f
Fix: Address review feedback for partial granularity docs
cbehera-newrelic Mar 12, 2026
fc127a6
wip
cbehera-newrelic Mar 17, 2026
79026aa
wip
cbehera-newrelic Mar 17, 2026
35a8272
wip
cbehera-newrelic Mar 17, 2026
d1dbb27
wip
cbehera-newrelic Mar 17, 2026
1a5e06a
Fix: Address PR #22633 review feedback from hmstepanek
cbehera-newrelic Mar 23, 2026
506539b
feat: Add comprehensive sampler configuration examples from PR #22986
cbehera-newrelic Mar 23, 2026
eeedac7
Apply suggestions from code review
cbehera-newrelic Mar 23, 2026
23bfe9c
Fix: Major conceptual rewrite of partial granularity configuration doc
cbehera-newrelic Mar 23, 2026
7e5d0e0
Enhance: Merge span filtering and attribute docs into comprehensive p…
cbehera-newrelic Mar 23, 2026
e0f35c6
Update navigation: Merge span filtering and attributes into single entry
cbehera-newrelic Mar 23, 2026
0768acc
Replace configure-minimal-spans-tracing.mdx with redirect page
cbehera-newrelic Mar 23, 2026
3533bd4
Refactor: Streamline cost optimization doc to focus on strategic plan…
cbehera-newrelic Mar 23, 2026
c67bd83
Merge branch 'docs/core-tracing-documentation' of https://github.com/…
cbehera-newrelic Mar 23, 2026
4d6e3dc
Fix: Revert unintended changes and remove misleading terminology
cbehera-newrelic Mar 23, 2026
0e454f6
New: Create comprehensive sampler documentation for controlling trace…
cbehera-newrelic Mar 23, 2026
05d1d71
Update cross-references to new sampler documentation
cbehera-newrelic Mar 23, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,24 @@ Distributed tracing collects data as requests travel from one service to another
Here is an example of a web transaction where agents measure the time spent in each service. Agents then send that timing information to New Relic as spans, and the spans are combined into one distributed trace.
</figcaption>

## Control your distributed tracing data ingestion with APM agent configuration [#span-configuration]

As you scale distributed tracing, you might want more control over data volume. Partial granularity distributed traces provide controlled ingestion, allowing you to capture data that really matters while managing data volumes effectively. APM agents provide configurable controls to ingest data in a controlled manner while maintaining the visibility you need.

APM agent configuration helps you:

* **Control ingestion** by configuring span volume and attributes
* **Fill instrumentation gaps** with lightweight traces from all services
* **Accelerate adoption** with controlled ingestion entry points for new services
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This item is not really part of core tracing and falls more under hybrid agent. What does fall under core tracing is configuring how many transaction to capture per minute so maybe we could change this to be:

Suggested change
* **Accelerate adoption** with controlled ingestion entry points for new services
* **Ingest control** with more options to configure how many transactions to sample per minute for a service


You get three configuration options for partial granularity distributed traces:

* **Option 1 (Span filtering):** Reduce span count by 50-80% by removing in-process spans
Copy link
Contributor

@hmstepanek hmstepanek Mar 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We often reference our documentation in contractual agreements and I worry putting actual percentages in here is going to legally bind us to guarantee those percentages. We should check with leadership on whether we actually want to include percentages in here or not. It's entirely possible that using any one of these options results in a reduction of 0% depending on the service the customer is running as we found with some of our internal teams that tested this feature.

* **Option 2 (Span filtering + attribute reduction):** Reduce data volume by 60-75% by removing in-process spans and limiting attributes
* **Option 3 (Maximum reduction):** Reduce data volume by 70-85% with span filtering, attribute reduction, and duplicate compression

These options work at the service level—you can use full distributed tracing for business-critical services while using span configuration for supporting services. For more information, see [Control distributed tracing data volume](/docs/distributed-tracing/core-tracing/introduction-core-tracing).

## Get started[#learn-more]

See these distributed tracing topics:
Expand Down
Loading
Loading