Skip to content

Commit db06061

Browse files
Merge pull request #19283 from nr-ahemsath/chore/net-agent-announce-dotnet-9-support
chore: Announce support for .NET 9 in .NET Agent compatibility document
2 parents 5fb288e + 3e56e35 commit db06061

File tree

1 file changed

+24
-14
lines changed

1 file changed

+24
-14
lines changed

src/content/docs/apm/agents/net-agent/getting-started/net-agent-compatibility-requirements.mdx

+24-14
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,11 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
5050
title=".NET Core version"
5151
>
5252

53-
The .NET agent supports .NET Core version 3.1, and .NET 5.0, 6.0, and 8.0.
53+
The .NET agent is compatible with .NET Core version 3.1, and .NET 5.0, 6.0, 7.0, 8.0, and 9.0.
54+
55+
<Callout variant="important">
56+
The agent is only fully supported when instrumenting applications that target [.NET runtimes currently supported by Microsoft](https://dotnet.microsoft.com/en-us/platform/support/policy/dotnet-core). The agent is likely to work with the EOL'ed runtimes listed below, but we do not test new versions of the agent with EOL'ed runtimes.
57+
</Callout>
5458

5559
<table style={{ width: "500px" }}>
5660
<thead>
@@ -68,7 +72,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
6872
<tbody>
6973
<tr>
7074
<td>
71-
.NET Core 3.1
75+
.NET Core 3.1 (EOL)
7276
</td>
7377

7478
<td>
@@ -78,7 +82,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
7882

7983
<tr>
8084
<td>
81-
.NET 5.0
85+
.NET 5.0 (EOL)
8286
</td>
8387
<td>
8488
8.35.0 and higher
@@ -87,7 +91,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
8791

8892
<tr>
8993
<td>
90-
.NET 6.0
94+
.NET 6.0 (EOL)
9195
</td>
9296
<td>
9397
9.2.0 and higher
@@ -96,7 +100,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
96100

97101
<tr>
98102
<td>
99-
.NET 7.0
103+
.NET 7.0 (EOL)
100104
</td>
101105
<td>
102106
10.0.0 and higher
@@ -111,6 +115,14 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
111115
10.0.0 and higher
112116
</td>
113117
</tr>
118+
<tr>
119+
<td>
120+
.NET 9.0
121+
</td>
122+
<td>
123+
10.0.0 and higher
124+
</td>
125+
</tr>
114126
</tbody>
115127
</table>
116128

@@ -292,9 +304,9 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
292304
id="target-framework-core"
293305
title="Target framework version"
294306
>
295-
The .NET agent only supports applications targeting .NET Core 3.1, and .NET 5.0, 6.0, and 8.0. You can find the target framework in your `.csproj` file. Agent compatibility varies across different versions of .NET Core.
307+
The .NET agent is compatible with applications targeting .NET Core 3.1, and .NET 5.0, 6.0, 7.0, 8.0, and 9.0. You can find the target framework in your `.csproj` file. Agent compatibility varies across different versions of .NET Core.
296308

297-
Supported:
309+
Compatible:
298310

299311
```xml
300312
<TargetFramework>netcoreapp3.1</TargetFramework>
@@ -316,16 +328,14 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
316328
<TargetFramework>net8.0</TargetFramework>
317329
```
318330

331+
```xml
332+
<TargetFramework>net9.0</TargetFramework>
333+
```
334+
319335
<Callout variant="important">
320336
On Linux ARM64 platforms, the .NET agent <DNT>**only**</DNT> supports target frameworks of `net5.0` or higher.
321337
</Callout>
322338

323-
Unsupported:
324-
325-
```xml
326-
<TargetFramework>net452</TargetFramework>
327-
```
328-
329339
If you want to monitor an ASP.NET Core application targeting .NET Framework, ensure that you have enabled the .NET Framework support after installing the .NET agent.
330340
</Collapser>
331341

@@ -343,7 +353,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
343353
>
344354
The .NET agent automatically instruments these application frameworks:
345355

346-
* ASP.NET Core MVC 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, and 8.0 (includes Web API)
356+
* ASP.NET Core MVC 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, and 9.0 (includes Web API)
347357
* ASP.NET Core Razor Pages 6.0, 7.0, and 8.0 (starting with .NET agent version 10.19.0)
348358
</Collapser>
349359

0 commit comments

Comments
 (0)