The AppDynamics .NET Core for Linux SDK lets you monitor the performance of .NET Core applications running on Linux.
The SDK supports the following features:
- Business transaction registration and error reporting
- Exit call with correlation and error reporting
- Snapshots with user properties but without callgraphs
Together, these tools give you visibility on application load and response times, and any custom metrics you define.
You monitor .NET Core applications by deploying the .NET Core for Linux SDK to your application directory and project.
Once running, the agent registers business transactions with the AppDynamics Controller. You can then see your application flow map and .
Before You Begin
- Confirm you have access to a compatible Controller. See Agent and Controller Compatibility
- Confirm the connection settings to the Controller where your agent will report data:
- If you use a SaaS Controller, AppDynamics sent you the Controller host in your Welcome Email. Use port 443 for HTTPS or port 80 for HTTP.
- If you use an on-premises Controller, you supplied the host and port at install time.
- Verify you have access the machine where the application runs as a user account with privileges to install the agent software and restart the application.
- Verify that the machine where the application runs can connect to the Controller. Proxies or firewalls on the network between the agent and Controller may require additional configuration.
Prepare to Install
Ensure you have the following:
- .NET Core SDK
- .NET Core application running on Linux
- AppDynamics.AgentSDK NuGet package
- Visual Studio or other IDE
- The .NET Core command-line interface (CLI)
Install the SDK
Complete the following steps manually, using Visual Studio or another integrated development environment (IDE).
To add the
AppDynamics.AgentSDKNuGet package in the project, from the command line enter
Once the command is run, there's a compatibility check to ensure the package is compatible with the frameworks in the project. If the check passes, a <
PackageReference> element is added to the project file and
dotnet restoreis run implicitly.
Modify your project to use the AppDynamics SDK. See .NET Core for Linux SDK Reference
Add the SDK namespace and SDK code to the application. For example:
dotnet publish.A warning message appears stating the AppDynamics configuration has not been updated. This is normal.
dotnet buildadds the following AppDynamics configuration file to your application:
dotnet publishrenames the AppDynamicsConfig.json file and copies it to the publish directory for the .NET Core for Linux SDK to reference and use:
- Proceed to Using .NET Core for Linux SDK for instructions on updating the
AppDynamics.Config.jsonfile and connecting the agent to the Controller.
The requirement to disable loading of native images (NGEN) for self-contained apps compiled with .NET Core 2.0
Due to a bug in the .NET Core runtime (see https://github.com/dotnet/coreclr/issues/13021), the command the .NET Core for Linux SDK profiler sends to the runtime to disable loading of native images is ignored. This prevents AppDynamics from instrumenting any methods in these assemblies which include most of the .NET Standard libraries.
A workaround for this bug is to disable using native images by setting the following environment variable: