通过 .NET 代理 API 支持自定义参数

.NET 代理 API 有助于跟踪 Web 应用程序中用户定义的方法。它监视 Web 应用程序 DLL 中特定方法的性能以及指定方法的整个执行时间。

可以使用此 API 跟踪特定方法级别的参数值。这可以更深入地了解您自己的应用程序方法。 

为 .NET 应用程序配置 API:

要配置 API:

  1. 从 NuGet 包管理器下载包 Site24x7.DotNetAgent.Api
  2. 将对库 DotNetAgent.Api.dll的引用添加到您的 Web 应用程序项目中
  3. API 包含一个名为 CustomTracker的类 ,用于跟踪方法的性能
  4. AddCustomParameter(string, object)方法 在方法中跟踪参数的值
  5. 分别在字符串和对象中定义参数名称和值来跟踪参数值

例子:

以下方法说明了如何通过 API 跟踪参数

public int UserLogin(string email, string sessionKey, bool isExternal)


{

DotNetAgent.Api.CustomTracker.AddCustomParameter("ReportName", "Employee Report");
DotNetAgent.Api.CustomTracker.AddCustomParameter("reportId", 2452);

 
AccountBL objAdmin = new AccountBL();
string EmpName = string.Empty;
int retcode = objAdmin.LogIn(email, sessionKey, Session.SessionID, isExternal, out int EmpId, out EmpName);
 
if (retcode == 0)
{
Session["EmpName"] = EmpName;
Session["EmpId"] = EmpId;
Session["isAuthenticated"] = true;
}
}

添加的参数值将显示在 Trace details 选项卡的 Request parameters 部分下,如下所示:

 


为 .NET Core 应用程序配置 API

要配置 API:

  1. 将包Site24x7.DotNetCoreAgent.Api从 NuGet 包管理器添加到您的 Web 应用程序项目。
  2. API 包含一个名为 Site24x7.Agent.Api 的类,用于跟踪事务的自定义参数。
  3. AddCustomParameter(string, object) 方法在方法中跟踪参数的值。
  4. 分别在字符串和对象字段中定义参数名称和值,以跟踪参数值。 

例子:

以下方法说明了如何通过 API 跟踪参数

public int UserLogin(string email, string sessionKey, bool isExternal)


{

Site24x7.Agent.Api.AddCustomParameter("ReportName", "Employee Report");


Site24x7.Agent.Api.AddCustomParameter("reportId", 2452);


AccountBL objAdmin = new AccountBL();


string EmpName = string.Empty;


int retcode = objAdmin.LogIn(email, sessionKey, Session.SessionID, isExternal, out int EmpId, out EmpName);


if (retcode == 0)


{

Session["EmpName"] = EmpName;

Session["EmpId"] = EmpId;

Session["isAuthenticated"] = true;


}
}

添加的参数值的详细信息将显示在 Trace 选项卡的 Request Headers 部分下,如下所示: