Skip to content

Commit f560dba

Browse files
chrisnasmaycmlee
andauthored
Update profiler features status for .NET 10 (#32001)
* Update profiler features status for .NET 10 * Update content/en/profiler/enabling/dotnet.md Co-authored-by: May Lee <may.lee@datadoghq.com> * Update content/en/profiler/enabling/dotnet.md Co-authored-by: May Lee <may.lee@datadoghq.com> * Update content/en/profiler/enabling/dotnet.md Co-authored-by: May Lee <may.lee@datadoghq.com> * Update content/en/profiler/profile_types.md Co-authored-by: May Lee <may.lee@datadoghq.com> * Update content/en/profiler/profile_types.md Co-authored-by: May Lee <may.lee@datadoghq.com> * Update content/en/profiler/profile_types.md Co-authored-by: May Lee <may.lee@datadoghq.com> --------- Co-authored-by: May Lee <may.lee@datadoghq.com>
1 parent c7a0f61 commit f560dba

File tree

2 files changed

+10
-9
lines changed

2 files changed

+10
-9
lines changed

content/en/profiler/enabling/dotnet.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,8 @@ Supported .NET runtimes (64-bit applications)
4545
.NET 6<br/>
4646
.NET 7<br/>
4747
.NET 8<br/>
48-
.NET 9
48+
.NET 9<br/>
49+
.NET 10
4950

5051
<div class="alert alert-warning">
5152
<strong>Note:</strong> For containers, <strong>more than one core</strong> is required. Read the <a href="/profiler/profiler_troubleshooting/dotnet#linux-containers">Troubleshooting documentation</a> for more details.
@@ -62,16 +63,16 @@ The following profiling features are available in the following minimum versions
6263
| CPU profiling | 2.15.0+ | All supported runtime versions. |
6364
| GC CPU consumption | 3.19.0+ | .NET 5+ |
6465
| Exceptions profiling | 2.31.0+ | All supported runtime versions. |
65-
| Allocations profiling beta | 3.12.0+ / 2.18.0+ | .NET Framework (requires Datadog Agent 7.51+ and 3.12.0+) / .NET 6+ (requires 2.18.0+) |
66+
| Allocations profiling | 3.12.0+ / 3.28.0+ | .NET Framework (requires Datadog Agent 7.51+ and 3.12.0+) / .NET 6+ (requires 2.18.0+ but Datadog recommends .NET10 with 3.28+). |
6667
| Lock Contention profiling | 2.49.0+ | .NET Framework (requires Datadog Agent 7.51+) and .NET 5+ |
67-
| Live heap profiling beta | 2.22.0+ | .NET 7+ |
68+
| Live heap profiling | 3.28.0+ | .NET 7+ but Datadog recommends .NET 10+. |
6869
| [Trace to Profiling integration][12] | 2.30.0+ | All supported runtime versions. |
6970
| [Endpoint Profiling][13] | 2.15.0+ | All supported runtime versions. |
7071
| Timeline | 2.30.0+ (and 3.19.0+ for outgoing HTTP requests longer than 50 ms in beta and thread start/end events) | All supported runtime versions (except .NET 5+ required for garbage collection details and .NET 7+ required for outgoing HTTP requests). |
7172

7273
- Allocations and Lock Contention profiling for .NET Framework requires that the Datadog Agent and the profiled applications are running on the same machine.
7374
- Due to a limitation of the .NET Framework, Allocations profiling does not show the size of the allocations. Instead, it only shows the count.
74-
- Allocations and Live Heap profiling are in beta until .NET 10 ships with the required changes for better statistical allocations sampling.
75+
- Allocations and Live Heap profiling are available in .NET 10. For other previous versions of .NET, the statistical distribution of allocations sampling might not be accurate, so expect larger objects to be represented more often
7576
- Continuous Profiler is not supported for AWS Lambda.
7677
- Continuous Profiler does not support ARM64.
7778

content/en/profiler/profile_types.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -204,18 +204,18 @@ CPU (v2.15+)
204204
Thrown Exceptions (v2.31+)
205205
: The number of caught or uncaught exceptions raised by each method, as well as their type and message.
206206

207-
Allocations (in beta, v2.18+)
207+
Allocations (v3.28+)
208208
: The number and size of allocated objects by each method, as well as their type.
209209
For .NET Framework, the size is not available.<br />
210-
_Requires: .NET Framework (with Datadog Agent 7.51+ and v3.2+) / .NET 6+_
210+
_Requires: .NET Framework (with Datadog Agent 7.51+ and v3.2+) / .NET 6+, but Datadog recommends .NET 10+ for more accurate sampling.
211211

212212
Lock (v2.49+)
213213
: The number of times threads are waiting for a lock and for how long.<br />
214214
_Requires: .NET Framework (requires Datadog Agent 7.51+) / .NET 5+_
215215

216-
Live Heap (in beta, v2.22+)
216+
Live Heap (v3.28+)
217217
: A subset of the allocated objects (with their class name) that are still in memory.<br />
218-
_Requires: .NET 7+_
218+
_Requires: .NET 7+ but Datadog recommends .NET 10+ for more accurate sampling.
219219

220220
Outgoing HTTP requests (in Timeline) (in beta v3.19+)
221221
: Start and end of outgoing HTTP requests with the duration of the different phases (DNS, security handshake, socket, request/response) and possible unexpected redirections.<br />
@@ -229,7 +229,7 @@ Garbage Collector CPU consumption (v3.19+)
229229
: The time garbage collector's threads spent running on the CPU.<br />
230230
_Requires: .NET Framework (with Datadog Agent 7.51+ and v3.2+) / .NET 5+_
231231

232-
Note: **Allocations** and **Live Heap** profiling are in beta until .NET 10, where required better statistical allocation sampling will be available.
232+
**Note**: Before .NET 10, **Allocations** and **Live Heap** profiling might show bigger objects more than smaller ones due to the sampling algorithm used by the .NET runtime. Datadog recommends using .NET 10+ for more statistically correct results.
233233

234234

235235
[1]: /profiler/enabling/dotnet/#requirements

0 commit comments

Comments
 (0)