Skip to content

Commit 50ee245

Browse files
jeff-coluccijeff-colucci
authored
Merge pull request newrelic#18728 from newrelic/fixing-links-in-compatibility-req-doc
fix(.NET): fixing links in compatibility doc
2 parents a19612a + 4807c12 commit 50ee245

File tree

1 file changed

+47
-40
lines changed

1 file changed

+47
-40
lines changed

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

Lines changed: 47 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -28,17 +28,17 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
2828

2929
<Tabs>
3030
<TabsBar>
31-
<TabsBarItem id="1">
31+
<TabsBarItem id="core">
3232
.NET Core
3333
</TabsBarItem>
34-
<TabsBarItem id="2">
34+
<TabsBarItem id="framework">
3535
.NET Framework
3636
</TabsBarItem>
3737
</TabsBar>
3838

3939

4040
<TabsPages>
41-
<TabsPageItem id="1">
41+
<TabsPageItem id="core">
4242
## Requirements [#requirements]
4343

4444
Before you install the New Relic .NET agent on Windows or Linux, make sure your system meets these requirements:
@@ -121,7 +121,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
121121

122122
<Collapser
123123
className="freq-link"
124-
id="app-web-servers"
124+
id="app-web-servers-core"
125125
title="App/web servers"
126126
>
127127
Ensure you use one of these app/web servers:
@@ -135,30 +135,31 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
135135
</Collapser>
136136

137137
<Collapser
138-
id="aws-elastic-beanstalk"
138+
id="aws-elastic-beanstalk-core"
139139
title="AWS Elastic Beanstalk"
140140
>
141141
For [AWS Elastic Beanstalk](https://aws.amazon.com/elasticbeanstalk) installation instructions, see the [.NET installation guide](/install/dotnet/).
142142
</Collapser>
143143

144144

145145
<Collapser
146-
id="azure"
146+
id="azure-core"
147147
title="Microsoft Azure"
148148
>
149149
For Azure-specific installation instructions, see the [.NET installation guide](/install/dotnet/).
150150
</Collapser>
151151

152152
<Collapser
153153
className="freq-link"
154+
id="net-requirements-core"
154155
title="Network requirements"
155156
>
156157
The agent requires your firewall to allow outgoing connections to specific [networks and ports](/docs/apm/new-relic-apm/getting-started/networks).
157158
</Collapser>
158159

159160
<Collapser
160161
className="freq-link"
161-
id="operating-system"
162+
id="operating-system-core"
162163
title="Operating system"
163164
>
164165
The agent has been verified to work with the following operating systems:
@@ -221,7 +222,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
221222

222223
<Collapser
223224
className="freq-link"
224-
id="user-rights"
225+
id="user-rights-core"
225226
title="Permissions"
226227
>
227228
Installing and running the .NET agent requires these permissions:
@@ -280,15 +281,15 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
280281

281282
<Collapser
282283
className="freq-link"
283-
id="security-requirements"
284+
id="security-requirements-core"
284285
title="Security requirements"
285286
>
286287
As a standard [security measure for data collection](/docs/accounts-partnerships/accounts/security/data-security), your app server must support SHA-2 (256-bit). SHA-1 is not supported.
287288
</Collapser>
288289

289290
<Collapser
290291
className="freq-link"
291-
id="target-framework"
292+
id="target-framework-core"
292293
title="Target framework version"
293294
>
294295
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.
@@ -348,7 +349,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
348349

349350
<Collapser
350351
className="freq-link"
351-
id="database"
352+
id="database-core"
352353
title="Datastores"
353354
>
354355
The .NET agent automatically instruments the performance of .NET application calls to these datastores:
@@ -572,7 +573,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
572573

573574
<Collapser
574575
className="freq-link"
575-
id="additional-frameworks"
576+
id="additional-frameworks-core"
576577
title="External call libraries"
577578
>
578579
The .NET agent automatically instruments these external call libraries :
@@ -663,7 +664,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
663664

664665
<Collapser
665666
className="freq-link"
666-
id="logging-frameworks"
667+
id="logging-frameworks-core"
667668
title="Logging frameworks"
668669
>
669670
The .NET agent [can be configured](/docs/apm/agents/net-agent/configuration/net-agent-configuration/#application_logging) to automatically instrument these logging frameworks for automatic logs-in-context with [agent forwarding](/docs/logs/logs-context/net-configure-logs-context-all#1-agent) and [local log decoration](/docs/logs/logs-context/net-configure-logs-context-all#2-decorate):
@@ -756,7 +757,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
756757

757758
<Collapser
758759
className="freq-link"
759-
id="messaging"
760+
id="messaging-core"
760761
title="Messaging"
761762
>
762763
The agent automatically instruments these message systems:
@@ -867,15 +868,15 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
867868

868869
</CollapserGroup>
869870

870-
## Unavailable features [#unavailable]
871+
## Unavailable features [#unavailable-core]
871872

872873
The following features are not available for the .NET agent:
873874

874875
* The .NET agent does not support [trim self-contained deployments and executables](https://docs.microsoft.com/en-us/dotnet/core/deploying/trim-self-contained), because the compiler can potentially trim assemblies that the agent depends on.
875876
* [Infinite Tracing](/docs/distributed-tracing/infinite-tracing/introduction-infinite-tracing) is not supported on Alpine Linux due to a [GRPC compatibility issue](https://github.com/grpc/grpc/issues/21446). See [this agent issue](https://github.com/newrelic/newrelic-dotnet-agent/issues/289) for more information.
876877
* The .NET agent doesn't support [Native Ahead of Time (AOT) deployment](https://learn.microsoft.com/en-us/dotnet/core/deploying/native-aot/?tabs=net8plus%2Cwindows) for .NET applications because just-in-time (JIT) compilation is required for the agent to function properly.
877878

878-
## Connect the agent to other New Relic products [#digital-intelligence-platform]
879+
## Connect the agent to other New Relic products [#digital-intelligence-platform-core]
879880

880881
In addition to [APM](/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm), the .NET agent integrates with other New Relic products to give you end-to-end visibility:
881882

@@ -930,7 +931,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
930931
</table>
931932

932933
</TabsPageItem>
933-
<TabsPageItem id="2">
934+
<TabsPageItem id="framework">
934935
## Requirements
935936

936937
Before you [install New Relic's .NET agent](/docs/apm/agents/net-agent/getting-started/introduction-new-relic-net/#installation), make sure your system meets these requirements:
@@ -948,14 +949,15 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
948949
<DNT>**The <DNT>.NET agent </DNT> doesn't support .NET Framework versions 4.5.1, 4.5.2, and 4.6.1**</DNT>
949950
</Collapser>
950951
<Collapser
951-
id="lifespan"
952+
className="freq-link"
953+
id="lifespan-framework"
952954
title="Application lifespan"
953955
>
954956
The .NET agent uploads data at the end of each [harvest cycle](/docs/new-relic-solutions/get-started/glossary/#harvest-cycle) (once per minute). If your .NET app doesn't run that long, you can set the `service element`'s `sendDataOnExit` attribute to `true` in the `newrelic.config` file.
955957
</Collapser>
956958
<Collapser
957959
className="freq-link"
958-
id="app-web-servers"
960+
id="app-web-servers-framework"
959961
title="App/web servers"
960962
>
961963
You must use one of these app/web servers:
@@ -970,39 +972,43 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
970972
The agent automatically creates transactions for apps hosted in IIS. If you self-host with WCF and OWIN version 3 or higher, the agent also automatically creates transactions. For other self-hosted services, you will need to [create transactions via custom instrumentation](/docs/apm/agents/net-agent/custom-instrumentation/introduction-net-custom-instrumentation/#new-existing).
971973
</Collapser>
972974
<Collapser
973-
id="aws-elastic-beanstalk"
975+
className="freq-link"
976+
id="aws-elastic-beanstalk-framework"
974977
title="AWS Elastic Beanstalk"
975978
>
976979
AWS [Elastic Beanstalk](https://aws.amazon.com/elasticbeanstalk) isn't a supported .NET environment.
977980
</Collapser>
978981

979982
<Collapser
980983
className="freq-link"
981-
id="clrs"
984+
id="clrs-framework"
982985
title="CLRs"
983986
>
984987
The agent requires CLR version 4.0. Legacy applications running on CLR 2.0 can be instrumented with agent versions lower than 7.0.
985988
</Collapser>
986989
<Collapser
987990
className="freq-link"
988-
id="code-access"
991+
id="code-access-framework"
989992
title="Code Access Security"
990993
>
991994
The use of [Code Access Security](https://docs.microsoft.com/en-us/dotnet/framework/misc/code-access-security) is compatible with the .NET agent only when Full Trust is provided. The agent isn't compatible with more restrictive trust levels.
992995
</Collapser>
993996
<Collapser
994997
className="freq-link"
995-
id="azure"
998+
id="azure-framework"
996999
title="Microsoft Azure"
9971000
>
9981001
For Azure-specific installation instructions, see the [.NET installation guide](/install/dotnet/).
9991002
</Collapser>
1000-
<Collapser title="Network requirements">
1003+
<Collapser
1004+
className="freq-link"
1005+
id="network-reqs-framework"
1006+
title="Network requirements">
10011007
The agent requires your firewall to allow outgoing connections to specific [networks and ports](/docs/new-relic-solutions/get-started/networks/).
10021008
</Collapser>
10031009
<Collapser
10041010
className="freq-link"
1005-
id="operating-system"
1011+
id="operating-system-framework"
10061012
title="Operating system"
10071013
>
10081014
The agent requires one of these operating systems:
@@ -1021,7 +1027,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
10211027
</Collapser>
10221028
<Collapser
10231029
className="freq-link"
1024-
id="user-rights"
1030+
id="user-rights-framework"
10251031
title="Permissions"
10261032
>
10271033
Installation requires elevated privileges (Administrator). For example, you can:
@@ -1050,21 +1056,21 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
10501056
</Collapser>
10511057
<Collapser
10521058
className="freq-link"
1053-
id="security-requirements"
1059+
id="security-requirements-framework"
10541060
title="Security requirements"
10551061
>
10561062
As a standard [security measure for data collection](/docs/security/security-privacy/data-privacy/security-controls-privacy/), your app server must support SHA-2 (256-bit). SHA-1 isn't supported.
10571063
</Collapser>
10581064

10591065
<Collapser
10601066
className="freq-link"
1061-
id="other-apm"
1067+
id="other-apm-framework"
10621068
title="Use of other monitoring software"
10631069
>
10641070
The .NET Common Language Runtime (CLR) only allows one profiler to access the profiling API of a process at any given time. Running our .NET agent alongside other monitoring software will result in a [profiler conflict](/docs/apm/agents/net-agent/troubleshooting/profiler-conflicts/). For more information, see [Errors while using other APM software](/docs/apm/new-relic-apm/troubleshooting/errors-while-using-other-apm-software).
10651071
</Collapser>
10661072
</CollapserGroup>
1067-
## Automatic instrumentation [#instrumented-features]
1073+
## Automatic instrumentation [#instrumented-features-framework]
10681074

10691075
If your application is hosted in ASP.NET or another [fully supported framework](#app-frameworks-framework), the .NET agent will automatically instrument your application after install. If your app isn't automatically instrumented, or if you want to add instrumentation, use [custom instrumentation](/docs/apm/agents/net-agent/custom-instrumentation/introduction-net-custom-instrumentation/).
10701076

@@ -1098,7 +1104,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
10981104

10991105
<Collapser
11001106
className="freq-link"
1101-
id="binding-types"
1107+
id="binding-types-framework"
11021108
title="Binding types"
11031109
>
11041110
WCF Instrumentation has been tested for the following common[binding types](https://docs.microsoft.com/en-us/dotnet/framework/wcf/system-provided-bindings) (both client and service). Varying levels of support are available for distributed tracing (DT) and cross application tracing (CAT):
@@ -1211,7 +1217,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
12111217

12121218
<Collapser
12131219
className="freq-link"
1214-
id="database"
1220+
id="database-framework"
12151221
title="Datastores"
12161222
>
12171223
Collecting [instance details](/docs/apm/applications-menu/features/analyze-database-instance-level-performance-issues) for supported datastores requires .NET agent version 6.5.29.0 or higher and is enabled by default. To request instance-level information from datastores not currently listed, get support at [New Relic support center](https://support.newrelic.com).
@@ -1518,7 +1524,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
15181524

15191525
<Collapser
15201526
className="freq-link"
1521-
id="additional-frameworks"
1527+
id="additional-frameworks-framework"
15221528
title="External call libraries"
15231529
>
15241530
The agent automatically instruments these external call libraries:
@@ -1597,7 +1603,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
15971603

15981604
<Collapser
15991605
className="freq-link"
1600-
id="hosting-models"
1606+
id="hosting-models-framework"
16011607
title="Hosting Models"
16021608
>
16031609
The following hosting models are fully supported:
@@ -1607,7 +1613,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
16071613

16081614
<Collapser
16091615
className="freq-link"
1610-
id="hosting-models"
1616+
id="hosting-models-framework"
16111617
title="Invocation models"
16121618
>
16131619
The following invocation methods (both client and service) are supported:
@@ -1666,7 +1672,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
16661672

16671673
<Collapser
16681674
className="freq-link"
1669-
id="logging-frameworks"
1675+
id="logging-frameworks-framework"
16701676
title="Logging frameworks"
16711677
>
16721678
The .NET agent [can be configured](/docs/apm/agents/net-agent/configuration/net-agent-configuration/#application_logging) to automatically instrument these logging frameworks for automatic logs-in-context with [agent forwarding](/docs/logs/logs-context/net-configure-logs-context-all/#1-agent) and [local log decoration](/docs/logs/logs-context/net-configure-logs-context-all/#2-decorate):
@@ -1759,7 +1765,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
17591765

17601766
<Collapser
17611767
className="freq-link"
1762-
id="messaging"
1768+
id="messaging-framework"
17631769
title="Messaging"
17641770
>
17651771
The agent automatically instruments these message systems:
@@ -1876,7 +1882,8 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
18761882
</table>
18771883
</Collapser>
18781884
<Collapser
1879-
id="technologies"
1885+
className="freq-link"
1886+
id="technologies-framework"
18801887
title="Supported .NET languages and technologies for dashboards"
18811888
>
18821889
The listed .NET languages and technologies are compatible with our [instant observability](https://newrelic.com/instant-observability/) dashboards. If you use any of these languages or technologies, you can view your data in a New Relic dashboard, right out of the box:
@@ -1940,7 +1947,7 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
19401947

19411948
<Collapser
19421949
className="freq-link"
1943-
id="unsupported-frameworks"
1950+
id="unsupported-frameworks-framework"
19441951
title="Unsupported frameworks"
19451952
>
19461953
These frameworks are **not fully supported:**
@@ -1951,11 +1958,11 @@ Want to try out our .NET agent? [Create a New Relic account](https://newrelic.co
19511958
* Sharepoint is <DNT>**not supported**</DNT>.
19521959
</Collapser>
19531960
</CollapserGroup>
1954-
### Unavailable features [#unavailable-features]
1961+
### Unavailable features [#unavailable-features-framework]
19551962

19561963
Just-in-time (JIT) compilation is a requirement for .NET agent functionality, so native images created with [Native Image Generator (NGEN)](https://docs.microsoft.com/en-us/dotnet/framework/tools/ngen-exe-native-image-generator) aren't supported by the .NET agent.
19571964

1958-
### Connect the agent to other New Relic products [#digital-intelligence-platform]
1965+
### Connect the agent to other New Relic products [#digital-intelligence-platform-framework]
19591966

19601967
In addition to [APM](/docs/apm/new-relic-apm/getting-started/introduction-apm/), the agent integrates with other New Relic products to give you end-to-end visibility:
19611968

0 commit comments

Comments
 (0)