Help Docs

Install .NET agent in Azure Service Fabric

You can monitor .NET applications hosted in Azure Service Fabric using the Site24x7 APM Insight .NET agent.

Note

.NET applications from version 3.1 are supported.

You can install the agent using the steps below:

  1. Add the Nuget package Site24x7.APMInsight.Agent to your Azure Service Fabric .NET project using the Package Manager Console in Visual Studio.

    PM> Install-Package Site24x7.APMInsight.Agent
  2. Set the environment variables in your application's ServiceManifest.xml file, as shown below:

    <CodePackage> 
    ... <EntryPoint>
    <ExeHost>
    ...
    <!-- It is mandatory for the WorkingFolder to be set as CodePackage. -->
    <!-- This is because the environment variable to be persisted on the working folder to load the agent. -->

    <WorkingFolder>CodePackage</WorkingFolder>
    ...
    </ExeHost>
    </EntryPoint>
    ...
    <EnvironmentVariables>
    ...
    <EnvironmentVariable Name="CORECLR_ENABLE_PROFILING" Value="1"/>
    <EnvironmentVariable Name="CORECLR_PROFILER" Value="{9D363A5F-ED5F-4AAC-B456-75AFFA6AA0C8}"/>
    <EnvironmentVariable Name="CORECLR_PROFILER_PATH_64" Value=".\site24x7\core\x64\ClrProfilerAgent.dll"/>
    <EnvironmentVariable Name="CORECLR_PROFILER_PATH_32" Value=".\site24x7\core\x64\ClrProfilerAgent.dll"/>
    <EnvironmentVariable Name="CORECLR_SITE24X7_HOME" Value=".\site24x7\core"/>
    <EnvironmentVariable Name="DOTNET_ADDITIONAL_DEPS" Value=".\site24x7\core\additionalDeps"/>
    <EnvironmentVariable Name="DOTNET_SHARED_STORE" Value=".\site24x7\core\store"/>
    <EnvironmentVariable Name="S247_LICENSE_KEY" Value="xxxxxxxxxxxxxxxxxxxxxxxxx"/>
    ...
    </EnvironmentVariables>
    ...
    </CodePackage>
  3. Replace the license S247_LICENSE_KEY value with the Site24x7 license key copied from the portal.

  4. Publish the application in Azure Service Fabric.
  5. Perform transactions to start monitoring.

To view data, log in to your Site24x7 account, select APM Insight, and choose your application.

Note:

    1. Ensure that the agent files are within the Site24x7 folder in the root of the application to be published to Azure Service Fabric.
    2. Ensure that the environment variables are set correctly.

Was this document helpful?

Would you like to help us improve our documents? Tell us what you think we could do better.


We're sorry to hear that you're not satisfied with the document. We'd love to learn what we could do to improve the experience.


Thanks for taking the time to share your feedback. We'll use your feedback to improve our online help resources.

Shortlink has been copied!