Notices: This section not yet converted to new layout. Download stats are rolling back out.

Microsoft Monitoring Agent

10.20.18011.0

Package test results are passing.

This package was approved by moderator Pauby on 8/20/2019.

For advanced monitoring where you need to do more than collect metrics and a subset of logs, the Log Analytics agent for Windows (also referred to as the Microsoft Monitoring Agent (MMA)) is required.

The Log Analytics agent was developed for comprehensive management across on-premises physical and virtual machines, computers monitored by System Center Operations Manager, and VMs in hosted in other clouds.

The Windows agents connect to a Log Analytics workspace in Azure Monitor to collect both monitoring solution-based data as well as custom data sources that you configure.

In order to monitor and manage virtual machines or physical computers in your local datacenter or other cloud environment with Azure Monitor, you need to deploy the Log Analytics agent (also referred to as the Microsoft Monitoring Agent (MMA)) and configure it to report to one or more Log Analytics workspaces. The agent also supports the Hybrid Runbook Worker role for Azure Automation.

On a monitored Windows computer, the agent is listed as the Microsoft Monitoring Agent service. The Microsoft Monitoring Agent service collects events from log files and Windows event log, performance data, and other telemetry. Even when the agent is unable to communicate with Azure Monitor it reports to, the agent continues to run and queues the collected data on the disk of the monitored computer. When the connection is restored, the Microsoft Monitoring Agent service sends collected data to the service.

Supported Windows operating systems

The following versions of the Windows operating system are officially supported for the Windows agent:

  • Windows Server 2019
  • Windows Server 2008 R2, 2012, 2012 R2, 2016, version 1709 and 1803
  • Windows 7 SP1, Windows 8 Enterprise and Pro, and Windows 10 Enterprise and Pro

Package Specific

Package Parameters

The following package parameters can be set:

  • /WorkspaceId: - Microsoft Azure Monitor workspace id (a GUID)
  • /workspaceKey: - Microsoft Azure Monitor workspace key

To pass parameters, use --params "''" (e.g. choco install packageID [other options] --params="'/ITEM:value /ITEM2:value2 /FLAG_BOOLEAN'").
To have choco remember parameters on upgrade, be sure to set choco feature enable -n=useRememberedArgumentsForUpgrades.

To install Microsoft Monitoring Agent, run the following command from the command line or from PowerShell:

C:\> choco install microsoft-monitoring-agent

To upgrade Microsoft Monitoring Agent, run the following command from the command line or from PowerShell:

C:\> choco upgrade microsoft-monitoring-agent

Files

Hide
  • tools\chocolateybeforemodify.ps1 Show
    Get-Service -Name HealthService -ErrorAction SilentlyContinue | Stop-Service
  • tools\chocolateyinstall.ps1 Show
    $ErrorActionPreference = 'Stop';
    $toolsDir     = "$(Split-Path -parent $MyInvocation.MyCommand.Definition)"
    
    $url32      = 'https://download.microsoft.com/download/A/E/7/AE709F7E-37F5-473F-A615-42D6F66AE32F/MMASetup-i386.exe'
    $checksum32 = '2986B39E819E2C16F524DB2AF318779E0E8EAC72819592227090C1BB4C8381CE'
    $url64      = 'https://download.microsoft.com/download/2/B/5/2B59B9A7-37CC-4FC5-BB4E-C7A69FE75DCF/MMASetup-AMD64.exe'
    $checksum64 = 'EFD6EB26A71FD32BCD5BEF15BC7C36F1CBB581CBAA158F930EFDA7692A23279F'
    
    # package parameters
    $pp = Get-PackageParameters
    
    if ($pp['WorkspaceId'] -and $pp['WorkspaceKey']) {
      $azureArgs = "ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_ID=$($pp['WorkspaceId']) OPINSIGHTS_WORKSPACE_KEY=$($pp['WorkspaceKey'])"
      Write-Verbose "Configuring with Azure Monitor workspace"
    } elseif ($pp['WorkspaceId'] -or $pp['WorkspaceKey']) {
      throw "Both WorkspaceId and WorkspaceKey package parameters must be supplied"
    } else {
      Write-Host "Installing agent, but configuration will need to be done via Control Panel app"
    }
    
    $packageArgs = @{
      packageName   = $env:ChocolateyPackageName
      softwareName  = 'Microsoft Monitoring Agent'
      fileType      = 'exe'
    
      # https://github.com/MicrosoftDocs/azure-docs/issues/29171
      # https://docs.microsoft.com/en-us/azure/azure-monitor/platform/agent-windows#install-the-agent-using-the-command-line
      silentArgs    = "/C:`"setup.exe /qn NOAPM=1 $azureArgs AcceptEndUserLicenseAgreement=1`""
      
      validExitCodes= @(0) #please insert other valid exit codes here
      url           = $url32
      checksum      = $checksum32
      checksumType  = 'sha256'
      url64bit      = $url64
      checksum64    = $checksum64
      checksumType64= 'sha256'
      destination   = $toolsDir
    }
    
    Install-ChocolateyPackage @packageArgs
    
  • tools\LICENSE.txt Show
    MICROSOFT SOFTWARE LICENSE TERMS
    MICROSOFT MONITORING AGENT 
    These license terms are an agreement between Microsoft Corporation (or based on where you live, one of its affiliates) and you. Please read them. They apply to the software named above, which includes the media on which you received it, if any. The terms also apply to any Microsoft
    ·	updates,
    ·	supplements,
    ·	Internet-based services, and
    ·	support services
    for this software, unless other terms accompany those items. If so, those terms apply.
    By using the software, you accept these terms. If you do not accept them, do not use the software.
    If you comply with these license terms, you have the perpetual rights below.
    1.	INSTALLATION AND USE RIGHTS. You may install and use any number of copies of the software on your devices.
    2.	KB959175. The software contains the Windows hotfix KB959175. This software programs is part of Windows. The license terms for Windows apply to your use of the Windows hotfix KB959175.
    3.	SCOPE OF LICENSE. The software is licensed, not sold. This agreement only gives you some rights to use the software. Microsoft reserves all other rights. Unless applicable law gives you more rights despite this limitation, you may use the software only as expressly permitted in this agreement. In doing so, you must comply with any technical limitations in the software that only allow you to use it in certain ways. You may not
    ·	disclose the results of any benchmark tests of the software to any third party without Microsoft’s prior written approval;
    ·	work around any technical limitations in the software;
    ·	reverse engineer, decompile or disassemble the software, except and only to the extent that applicable law expressly permits, despite this limitation;
    ·	make more copies of the software than specified in this agreement or allowed by applicable law, despite this limitation;
    ·	publish the software for others to copy;
    ·	rent, lease or lend the software;
    ·	transfer the software or this agreement to any third party; or
    ·	use the software for commercial software hosting services.
    4.	BACKUP COPY. You may make one backup copy of the software. You may use it only to reinstall the software.
    5.	DOCUMENTATION. Any person that has valid access to your computer or internal network may copy and use the documentation for your internal, reference purposes.
    6.	EXPORT RESTRICTIONS. The software is subject to United States export laws and regulations. You must comply with all domestic and international export laws and regulations that apply to the software. These laws include restrictions on destinations, end users and end use. For additional information, see www.microsoft.com/exporting.
    7.	SUPPORT SERVICES. Because this software is “as is,” we may not provide support services for it.
    8.	ENTIRE AGREEMENT. This agreement, and the terms for supplements, updates, Internet-based services and support services that you use, are the entire agreement for the software and support services.
    9.	APPLICABLE LAW.
    a.	United States. If you acquired the software in the United States, Washington state law governs the interpretation of this agreement and applies to claims for breach of it, regardless of conflict of laws principles. The laws of the state where you live govern all other claims, including claims under state consumer protection laws, unfair competition laws, and in tort.
    b.	Outside the United States. If you acquired the software in any other country, the laws of that country apply.
    10.	LEGAL EFFECT. This agreement describes certain legal rights. You may have other rights under the laws of your country. You may also have rights with respect to the party from whom you acquired the software. This agreement does not change your rights under the laws of your country if the laws of your country do not permit it to do so.
    11.	DISCLAIMER OF WARRANTY. The software is licensed “as-is.” You bear the risk of using it. Microsoft gives no express warranties, guarantees or conditions. You may have additional consumer rights or statutory guarantees under your local laws which this agreement cannot change. To the extent permitted under your local laws, Microsoft excludes the implied warranties of merchantability, fitness for a particular purpose and non-infringement.
    FOR AUSTRALIA - You have statutory guarantees under the Australian Consumer Law and nothing in these terms is intended to affect those rights.
    12.	LIMITATION ON AND EXCLUSION OF REMEDIES AND DAMAGES. You can recover from Microsoft and its suppliers only direct damages up to U.S. $5.00. You cannot recover any other damages, including consequential, lost profits, special, indirect or incidental damages.
    This limitation applies to
    ·	anything related to the software, services, content (including code) on third party Internet sites, or third party programs; and
    ·	claims for breach of contract, breach of warranty, guarantee or condition, strict liability, negligence, or other tort to the extent permitted by applicable law.
    It also applies even if Microsoft knew or should have known about the possibility of the damages. The above limitation or exclusion may not apply to you because your country may not allow the exclusion or limitation of incidental, consequential or other damages.
    Please note: As this software is distributed in Quebec, Canada, some of the clauses in this agreement are provided below in French.
    Remarque : Ce logiciel étant distribué au Québec, Canada, certaines des clauses dans ce contrat sont fournies ci-dessous en français.
    EXONÉRATION DE GARANTIE. Le logiciel visé par une licence est offert « tel quel ». Toute utilisation de ce logiciel est à votre seule risque et péril. Microsoft n’accorde aucune autre garantie expresse. Vous pouvez bénéficier de droits additionnels en vertu du droit local sur la protection dues consommateurs, que ce contrat ne peut modifier. La ou elles sont permises par le droit locale, les garanties implicites de qualité marchande, d’adéquation à un usage particulier et d’absence de contrefaçon sont exclues.
    LIMITATION DES DOMMAGES-INTÉRÊTS ET EXCLUSION DE RESPONSABILITÉ POUR LES DOMMAGES.  Vous pouvez obtenir de Microsoft et de ses fournisseurs une indemnisation en cas de dommages directs uniquement à hauteur de 5,00 $ US. Vous ne pouvez prétendre à aucune indemnisation pour les autres dommages, y compris les dommages spéciaux, indirects ou accessoires et pertes de bénéfices.
    Cette limitation concerne :
    tout  ce qui est relié au logiciel, aux services ou au contenu (y compris le code) figurant sur des sites Internet tiers ou dans des programmes tiers ; et
    les réclamations au titre de violation de contrat ou de garantie, ou au titre de responsabilité stricte, de négligence ou d’une autre faute dans la limite autorisée par la loi en vigueur.
    Elle s’applique également, même si Microsoft connaissait ou devrait connaître l’éventualité d’un tel dommage.  Si votre pays n’autorise pas l’exclusion ou la limitation de responsabilité pour les dommages indirects, accessoires ou de quelque nature que ce soit, il se peut que la limitation ou l’exclusion ci-dessus ne s’appliquera pas à votre égard.
    EFFET JURIDIQUE.  Le présent contrat décrit certains droits juridiques. Vous pourriez avoir d’autres droits prévus par les lois de votre pays.  Le présent contrat ne modifie pas les droits que vous confèrent les lois de votre pays si celles ci ne le permettent pas.
    
    

Virus Scan Results

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Dependencies

This package has no dependencies.

Package Maintainer(s)

Software Author(s)

  • Microsoft

Copyright

Microsoft Corp

Tags

Version History

Version Downloads Last updated Status

Discussion for the Microsoft Monitoring Agent Package

Ground rules:

  • This discussion is only about Microsoft Monitoring Agent and the Microsoft Monitoring Agent package. If you have feedback for Chocolatey, please contact the google group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or Microsoft Monitoring Agent, or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.

comments powered by Disqus
Chocolatey.org uses cookies to enhance the user experience of the site.
Ok