Install - vFunction and OpenTelemetry Agents on Linux .NET Core Agent running on a Host

Overview

Microsoft .NET Applications have a limitation that only one Agent can be hooked into the Application at a time. To work around this limitation, the Datadog Multiplexer can be used as the Base Agent. This Datadog Multiplexer includes a configuration file that allows you to define two additional .NET Agents to run simultaneously on the Application without conflict.

At a high level, you’ll need to:

  1. Download and install the two .NET Agents you want to run simultaneously
  2. Download the Datadog Multiplexer
  3. Configure the Datadog Multiplexer for the two .NET Agents you want to run simultaneously
  4. Add the vendor-specific environment variables for the two .NET Agents you want to run
  5. Add the generic .NET Agent environment variables to run the Datadog Multiplexer
  6. Restart the Application

.NET Core Compatibility

vFunction supports C# .NET Core version 3.x and .NET 6.x, 7.x and 8.x applications.

Installation Wizard

To help with the installation process, vFunction offers an Installation Wizard. This Wizard provides additional information about the Prerequisites as well as steps for deploying the vFunction Agent to your environment.

Please contact support@vfunction.com or your vFunction Contact(s) for the password to start using this Wizard.

Installation Steps

  1. Ensure Prerequisites are met
  2. Download the vFunction Sudoless Controller Installation TGZ
  3. SSH to the Linux VM as the user who runs the Application
  4. Move the Installation TGZ to the location on the Linux VM where the vFunction Agent should run
  5. Extract the vFunction Installation Package
### Replace VERSION with the actual value
tar -xvzf vfunction-controller-sudo-less-installation.vVERSION.tgz
  1. Add Environment Variables for the vFunction Dynamic Agent
# See description in https://kb.vfunction.com/installations/configurable-settings/mono-dynamic-agent/dotnet/linux
export VF_CONTROLLER_DEFAULT_DOTNET_CONTROLLER_NAME="CHANGE_ME"
export VF_CONTROLLER_DEFAULT_DOTNET_CONTROLLER_HOST="CHANGE_ME"
export VF_CONTROLLER_DEFAULT_DOTNET_CONTROLLER_ORG_ID="CHANGE_ME"
export VF_CONTROLLER_DEFAULT_DOTNET_CONTROLLER_APP_ID="CHANGE_ME"
export VF_CONTROLLER_DEFAULT_DOTNET_CONTROLLER_CLIENT_ID="CHANGE_ME"
export VF_CONTROLLER_DEFAULT_DOTNET_CONTROLLER_CLIENT_SECRET="CHANGE_ME"
export VF_CONTROLLER_DEFAULT_DOTNET_CONTROLLER_INSTANCE_ID="CHANGE_ME"
  1. Run the vFunction Monolithic Agent installation script
### Replace the BASE_DIR with the actual value, such as /tmp/
bash BASE_DIR/vfunction/opt/vfunction/controller-installation/install.sh -i default-dotnet
  1. Download a script to run the Application with the vFunction and OpenTelemetry Agents hooked
  1. Download the Multiplexer Agent
  2. Download the Multiplexer’s Config File
  3. Rename the downloaded loader-otel-vf.conf to loader.conf
  4. Modify the loader.conf following the directions in the Comments
  5. Add the loader.conf and Multiplexer Agent to the Application’s file system in the same directory, e.g. /home/charlotteLee/
  6. Modify the run-app-multiplexer-otel-vf.sh following the directions in the Comments
  7. Start Learning in the VF Server UI for both the Monolithic and Distributed Applications
  8. Run the run-app-multiplexer-otel-vf.sh script
  9. Test the Application to confirm functionality and validate learning results
  10. If any issues arise:

Updated on 24 Mar 2025