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
- and 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
Install the SDK
Complete the following steps manually, using Visual Studio or another integrated development environment (IDE).
- Download the
AppDynamics.AgentSDKNuGet package and copy it to a directory of your choice, such as
Update your build scripts to be able to access the AppDynamics SDK library files.
In your application directory, add the following lines to your Linux project:
- Then run
dotnet add package AppDynamics.AgentSDK_x64This extracts the files from the NuGet package into the application folder.
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 App iQ .NET Core for Linux SDK to reference and use:
- Proceed to Using .NET Core for Linux SDK for instructions on updating the AppDynamics.Config.json file and connecting the agent to the Controller.
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: