桌面计算机性能监控系统,监视 Windows 桌面应用的使用情况和性能 - Azure Monitor | Microsoft Docs...

您现在访问的是微软AZURE全球版技术文档网站，若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站，请访问 https://docs.azure.cn.

监视经典 Windows 桌面应用中的使用情况和性能

06/11/2020

本文内容

在 Azure 和其他云中本地托管的应用程序都可以利用 Application Insights。 唯一限制是需要允许与 Application Insights 服务通信。 若要监视通用 Windows 平台 (UWP) 应用程序，我们建议使用 Visual Studio App Center。

将遥测从经典 Windows 应用程序发送到 Application Insights

获取检测密钥的副本。

在 Visual Studio 中，编辑应用项目的 NuGet 包，并添加 Microsoft.ApplicationInsights.WindowsServer。 (或者，如果只需要基本 API，而无需标准遥测收集模块，则选择 Microsoft.ApplicationInsights。)

在代码中设置检测密钥：

TelemetryConfiguration.Active.InstrumentationKey = "你的密钥";

或在 ApplicationInsights.config 中设置检测密钥(如果已安装标准遥测包之一)：

你的密钥

如果使用 ApplicationInsights.config，请确保它在解决方案资源管理器中的属性设置为“生成操作”=“内容”、“复制到输出目录”=“复制”。

运行应用，并在 Azure 门户中创建的资源中查看遥测。

示例代码

using Microsoft.ApplicationInsights;

public partial class Form1 : Form

{

private TelemetryClient tc = new TelemetryClient();

...

private void Form1_Load(object sender, EventArgs e)

{

// Alternative to setting ikey in config file:

tc.InstrumentationKey = "key copied from portal";

// Set session data:

tc.Context.Session.Id = Guid.NewGuid().ToString();

tc.Context.Device.OperatingSystem = Environment.OSVersion.ToString();

// Log a page view:

tc.TrackPageView("Form1");

...

}

protected override void OnFormClosing(System.Windows.Forms.FormClosingEventArgs e)

{

if (tc != null)

{

tc.Flush(); // only for desktop apps

// Allow time for flushing:

System.Threading.Thread.Sleep(1000);

}

base.OnFormClosing(e);

}

...

替代计算机名称的存储

默认情况下，此 SDK 将收集并存储发出遥测的系统的计算机名称。

计算机名由 Application Insights 旧的企业(按节点)定价层用于内部计费。 默认情况下，如果使用遥测初始值设定项替代 telemetry.Context.Cloud.RoleInstance，则将发送一个单独的属性 ai.internal.nodeName，该属性仍将包含计算机名值。 此值不会与 Application Insights 遥测数据一起存储，而是在内部引入时使用，以允许向后兼容基于旧节点的计费模型。

如果你使用的是旧的企业(按节点)定价层，并且只需要替代计算机名的存储，请使用遥测初始值设定项：

按如下所示编写自定义 TelemetryInitializer。

using Microsoft.ApplicationInsights.Channel;

using Microsoft.ApplicationInsights.Extensibility;

namespace CustomInitializer.Telemetry

{

public class MyTelemetryInitializer : ITelemetryInitializer

{

public void Initialize(ITelemetry telemetry)

{

if (string.IsNullOrEmpty(telemetry.Context.Cloud.RoleInstance))

{

// Set custom role name here. Providing an empty string will result

// in the computer name still be sent via this property.

telemetry.Context.Cloud.RoleInstance = "Custom RoleInstance";

}

}

}

}

在以下设置检测密钥的 Program.cs Main() 方法中实例化初始化程序：

using Microsoft.ApplicationInsights.Extensibility;

using CustomInitializer.Telemetry;

static void Main()

{

TelemetryConfiguration.Active.InstrumentationKey = "{Instrumentation-key-here}";

TelemetryConfiguration.Active.TelemetryInitializers.Add(new MyTelemetryInitializer());

//...

}

替代计算机名的传输

如果你使用的不是旧的企业(按节点)定价层，并且想要完全阻止发送包含计算机名的任何遥测，则需要使用遥测处理器。

遥测处理器

using Microsoft.ApplicationInsights.Channel;

using Microsoft.ApplicationInsights.Extensibility;

namespace WindowsFormsApp2

{

public class CustomTelemetryProcessor : ITelemetryProcessor

{

private readonly ITelemetryProcessor _next;

public CustomTelemetryProcessor(ITelemetryProcessor next)

{

_next = next;

}

public void Process(ITelemetry item)

{

if (item != null)

{

item.Context.Cloud.RoleInstance = string.Empty;

}

_next.Process(item);

}

}

}

在以下设置检测密钥的 Program.cs Main() 方法中实例化遥测处理器：

using Microsoft.ApplicationInsights.Extensibility;

namespace WindowsFormsApp2

{

static class Program

{

static void Main()

{

TelemetryConfiguration.Active.InstrumentationKey = "{Instrumentation-key-here}";

var builder = TelemetryConfiguration.Active.DefaultTelemetrySink.TelemetryProcessorChainBuilder;

builder.Use((next) => new CustomTelemetryProcessor(next));

builder.Build();

//...

}

}

}

备注

尽管技术上你可以使用如上所述的遥测处理器(即使你使用的是旧的企业(按节点)定价层)，但这将由于无法针对每个节点定价区分节点而导致超额计费。

后续步骤