.NET Agent v2.3.5

November 4, 2024

• New Added the User Transaction feature in .NET Core.

  • See the following example: If you do not need to monitor the number of users, enter an empty string in the user identification field.

    using System;
    
    class Program
    {
        static void Main(string[] args)
        {
            // Start tracing (domain, Url, user identification)
            WhatapDiagnostic.TraceStart("127.0.0.1", "/api/test", "user123");
    
            try
            {
                // Start step
                WhatapDiagnostic.StepStart("test Step");
    
                // User code area
    
                // End step
                WhatapDiagnostic.StepStop();
            }
            catch (Exception ex)
            {
                // Log exceptions in diagnostic information upon an exception
                WhatapDiagnostic.SetExceptionForTrace(ex);
            }
            finally
            {
                // End tracing
                WhatapDiagnostic.TraceStop();
            }
        }
    }
    

    Note

    Supporting the .NET Framework is in preparation.

  • The WhatapDiagnostic code is as follows. The format does not matter, as long as the content of diagnosticSource.Write(…) is correct.

    using System.Diagnostics;å
    
    public static class WhatapDiagnostic
    {
        private static readonly DiagnosticSource diagnosticSource = new DiagnosticListener("WhatapDiagnosticListener");
    
        public static void TraceStart(string host, string url, string userId)
        {
            if (diagnosticSource.IsEnabled("Whatap.Diagnostic.Trace.Start"))
            {
                diagnosticSource.Write("Whatap.Diagnostic.Trace.Start", new { Host = host, Url = url, UserId = userId });
                Console.WriteLine("Whatap.Diagnostic.Trace.Start!");
            }
        }
    
        public static void SetExceptionForTrace(Exception exception)
        {
            if (diagnosticSource.IsEnabled("Whatap.Diagnostic.Trace.Exception"))
            {
                diagnosticSource.Write("Whatap.Diagnostic.Trace.Exception", exception);
            }
        }
    
        public static void StepStart(string message)
        {
            diagnosticSource.Write("Whatap.Diagnostic.Step.Start", message);
        }
    
        public static void StepStop()
        {
            diagnosticSource.Write("Whatap.Diagnostic.Step.Stop", new { });
        }
    
        public static void TraceStop()
        {
            if (diagnosticSource.IsEnabled("Whatap.Diagnostic.Trace.Stop"))
            {
                diagnosticSource.Write("Whatap.Diagnostic.Trace.Stop", new { });
            }
        }
    
        public static void UserLog(string message)
        {
            if (diagnosticSource.IsEnabled("Whatap.Diagnostic.UserLog"))
            {
                diagnosticSource.Write("Whatap.Diagnostic.UserLog", message);
            }
        }
    }

• New Supported the Method hook.

  • You can monitor by specifying the method name. See the following configuration.

    hook_methods_enabled=true
    hook_methods_prefix=System.Net.Http.HttpClient., System.Net.WebRequest., System.Data., System.Net.Http.
    hook_methods_ignores=get,set

    • Set the value of the hook_methods_enabled option to true.

    • The value of the hook_methods_prefix option becomes the monitoring target when the first part of the option value matches. Separate with comma (,).

    • The value of the hook_methods_ignore option is excluded from monitoring when the first part of the value matches.

• New Added the feature to support the WebClient.DownloadString method monitoring.

• Changed Processed the response body option.

  • Added the enabling option instead of the default setting because the string encoding-related error was found.

  • The default value of the profile_http_response_body_enabled option is false.

  Note

  Support for string encoding is under development.

• Changed Changed the Redis output format for the .NET Framework version.

  • The decoration effect has been applied to match the output method of .Net Core.

• Deprecate Removed the trace_db_command_methods option.

  • This option is currently not required due to automatic processing of monitoring targets.

  • The methods excluded from monitoring can be processed using the Method hook.

    hook_methods_enabled=true
    hook_methods_prefix=System.Data., ...

Info

Download

.NET Agent download

• Windows Server 20012 is the minimum requirement.