Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This documents the steps necessary to configure SeaLights to run alongside any other profilers currently configured in your environment.

This is done by utilizing the Microsoft CLR Instrumentation profiler, designed to allow hosting multiple profilers simultaneously. 

Table of Contents

Configuring the Microsoft CLR Instrumentation Engine to run multiple profilers

...

  1. In the Contrast agent configuration YAML, the enable_chaining property must be set to 'true'. Refer to Contrast Security .NET Agent documentation for more information.
  2. Copy the following DLLs from the provided SeaLights installation to the folders specified below:
    • SL.DotNet.IpcLibrary-1.0.0.0_x64.DLL should be placed in c:\Windows\System32

    • SL.DotNet.IpcLibrary-1.0.0.0_x86.DLL should be placed in c:\Windows\SysWow64

  3. Ensure the COR_PROFILER environment variable has the SeaLights profiler CLS ID: {01CA2C22-DC03-4FF5-8350-59E32A3536BA}
  4. Once the above is completed and the service is restarted, it should start up with both profilers active.
  5. If the profilers were chained successfully, 4 additional environment variables will appear with the CONTRAST_CCC prefix:
    • CONTRAST_CCC_COR_PROFILER
    • CONTRAST_CCC_COR_PROFILER_PATH
    • CONTRAST_CCC_COR_PROFILER_PATH_32
    • CONTRAST_CCC_COR_PROFILER_PATH_64

...

Info
titleStandard SeaLights .NET Environment Variables
Cor_Profiler={01CA2C22-DC03-4FF5-8350-59E32A3536BA}
Cor_Enable_Profiling=1
Cor_Profiler_Path=<PATH TO SL.DotNet.ProfilerLib.dll>
COR_PROFILER_PATH_32=<PATH TO SL.DotNet.ProfilerLib_x86.dll>
COR_PROFILER_PATH_64=<PATH TO SL.DotNet.ProfilerLib_x64.dll>
SeaLights_CollectorId=GlobalCollector

...