在 Windows 计算机上安装 Log Analytics 代理

以下步骤在计算机上使用代理的设置向导在由世纪互联运营的 Microsoft Azure 云中安装并配置 Log Analytics 代理。

1. 在 Log Analytics 工作区中，从先前导航到的“Windows 服务器”页，根据 Windows 操作系统的处理器体系结构选择相应的“下载 Windows 代理”版本。
2. 运行安装程序在计算机上安装该代理。
3. 在“欢迎”页面上，单击“下一步”。
4. 在“许可条款”页面上阅读许可协议，然后单击“我接受” 。
5. 在“目标文件夹”页面上更改或保留默认安装文件夹，然后单击“下一步” 。
6. 在“代理安装选项”页上，选择将代理连接到 Azure Log Analytics，单击“下一步”。
7. 在“Azure Log Analytics”页面上，执行以下操作：
   1. 粘贴前面复制的“工作区 ID”和“工作区密钥(主密钥)”。 如果计算机应向由世纪互联运营的 Microsoft Azure 云中的 Log Analytics 工作区报告，请从“Azure 云”下拉列表中选择“Azure 中国”。
   2. 如果计算机需要通过代理服务器来与 Log Analytics 通信，请单击“高级”并提供代理服务器的 URL 和端口号。 如果代理服务器要求身份验证，请键入用于在代理服务器上进行身份验证的用户名和密码，并单击“下一步”。
8. 提供必需的配置设置后，单击“下一步”。
   
   
9. 在“准备安装”页上检查所做的选择，并单击“安装”。
10. 在“配置已成功完成”页上，单击“完成”。

完成后，Microsoft Monitoring Agent 将显示在“控制面板”中。 要确认其正在向 Log Analytics 报告，请参阅验证代理与 Log Analytics 的连接。

下载的代理文件是自包含安装包。 代理和支持文件的安装程序包含在该包中，需要提取才能使用以下示例中所示的命令行正确安装。

下表突出显示了代理的安装程序支持的特定参数，包括使用 Automation DSC 进行部署的时间。

1. 要提取代理安装文件，请从提升的命令提示符运行 MMASetup-<platform>.exe /c。 系统会提示你输入将文件提取到的路径。 或者，可以通过传递参数 MMASetup-<platform>.exe /c /t:<Full Path> 来指定路径。

2. 要以无提示方式安装代理，并将其配置为向 Azure 商业版云中的工作区报告，请在提取安装文件的文件夹中输入：

   setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=0 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
   

   或者，为了将代理配置为向由世纪互联运营的 Microsoft Azure 云报告，请输入：

   setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=2 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
   

   注意

   需要将参数 OPINSIGHTS_WORKSPACE_ID 和 OPINSIGHTS_WORKSPACE_KEY 的字符串值封装在双引号中，以指示 Windows Installer 将其解释为包的有效选项。

可通过以下脚本示例，使用 Azure Automation DSC 安装代理。 如果没有自动化帐户，请在使用 Automation DSC 前查看 Azure 自动化入门，了解创建自动化账户的需求和步骤。 如果不熟悉 Automation DSC，请参阅 Automation DSC 入门。

下面的示例安装由 URI 值标识的 64 位代理。 还可通过替换 URI 值，使用 32 位版本。 这两个版本的 URI 分别是：

• Windows 64 位代理：https://go.microsoft.com/fwlink/?LinkId=828603
• Windows 32 位代理：https://go.microsoft.com/fwlink/?LinkId=828604

32 位和 64 位版本的代理包具有不同的产品代码，新发布的版本也具有唯一的产品代码。 产品代码是一个 GUID，它是应用程序或产品的主体标志，由 Windows Installer 的“ProductCode”属性表示。 MMAgent.ps1 脚本中的 ProductId 值必须与 32 位或 64 位代理安装程序包的产品代码匹配。

要直接从代理安装包检索产品代码，可使用适用于 Windows Installer 开发者的 Windows SDK 组件中的 Orca.exe，该组件是 Windows 软件开发工具包的一个组件，或按照 Microsoft 最有价值专家 (MVP) 编写的示例脚本来使用 PowerShell。 对于任一方法，你首先需要从 MMASetup 安装包中提取 MOMagent.msi 文件，如使用命令行安装代理的说明的第一步中所述。

1. 从 https://www.powershellgallery.com/packages/xPSDesiredStateConfiguration 将 xPSDesiredStateConfiguration DSC 模块导入到 Azure 自动化。

2. 为 OPSINSIGHTS_WS_ID 和 OPSINSIGHTS_WS_KEY 创建 Azure 自动化变量资产。 将 OPSINSIGHTS_WS_ID 设置为 Log Analytics 工作区 ID，将 OPSINSIGHTS_WS_KEY 设置为工作区的主键 。

3. 复制脚本，并将其另存为 MMAgent.ps1。

   Configuration MMAgent
   {
       $OIPackageLocalPath = "C:\Deploy\MMASetup-AMD64.exe"
       $OPSINSIGHTS_WS_ID = Get-AutomationVariable -Name "OPSINSIGHTS_WS_ID"
       $OPSINSIGHTS_WS_KEY = Get-AutomationVariable -Name "OPSINSIGHTS_WS_KEY"
   
       Import-DscResource -ModuleName xPSDesiredStateConfiguration
       Import-DscResource -ModuleName PSDesiredStateConfiguration
   
       Node OMSnode {
           Service OIService
           {
               Name = "HealthService"
               State = "Running"
               DependsOn = "[Package]OI"
           }
   
           xRemoteFile OIPackage {
               Uri = "https://go.microsoft.com/fwlink/?LinkId=828603"
               DestinationPath = $OIPackageLocalPath
           }
   
           Package OI {
               Ensure = "Present"
               Path  = $OIPackageLocalPath
               Name = "Microsoft Monitoring Agent"
               ProductId = "8A7F2C51-4C7D-4BFD-9014-91D11F24AAE2"
               Arguments = '/C:"setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_ID=' + $OPSINSIGHTS_WS_ID + ' OPINSIGHTS_WORKSPACE_KEY=' + $OPSINSIGHTS_WS_KEY + ' AcceptEndUserLicenseAgreement=1"'
               DependsOn = "[xRemoteFile]OIPackage"
           }
       }
   }
   
   

4. 按照先前建议的方法，使用从最新版本的代理安装包中提取的产品代码更新脚本中的 ProductId 值。

5. 将 MMAgent.ps1 配置脚本导入到自动化帐户。

6. 将 Windows 计算机或节点分配到配置。 15 分钟内，该节点会检查其配置，代理会被推送到该节点。