Share via


Microsoft Monitoring Agent Setup

The Microsoft Monitoring Agent must be installed and configured on the data collection machine. It must also be installed on the Log Analytics Gateway if deploying that scenario.

For detailed information about the Microsoft Monitoring Agent including system requirements, network firewall configuration requirements, TLS 1.2 requirements, download, and installation instructions, see the Agent Windows article

The following information lists the proxy and firewall configuration information required for the Linux and Windows agent to communicate with Log Analytics within the Azure commercial cloud. For complete and up to date information on the networking requirements for the MMA as well as networking requirements for Azure Government or other sovereign Azure Log Analytics services, see Log Analytics agent overview - Firewall requirements.

Agent Resource Ports Direction Bypass HTTPS inspection
* .ods.opinsights.azure.com Port 443 Outbound Yes
* .oms.opinsights.azure.com Port 443 Outbound Yes
* .blob.core.windows.net Port 443 Outbound Yes
* .azure-automation.net Port 443 Outbound Yes

Download and install the Microsoft Monitoring Agent (MMA) setup file from Azure Log Analytics

On the designated data collection machine and Log Analytics Gateway (if using) complete the following steps. If Log Analytics Gateway scenario is being deployed, then install and configure the MMA on the gateway first.

Note

If the collection machine does not have an internet connection, perform the first 3 steps from an internet connected machine.

  1. In the Azure portal, go to Log Analytics, select your workspace and select the Advanced Settings Icon.

  2. Select Connected Sources, and then select Windows Servers.

    The Microsoft Azure window, which is showing the Connected Sources and Windows Servers commands are selected.

  3. Select the Download Windows Agent link that is applicable to your computer processor type to download the setup file. If the agent is downloaded on another machine, copy the Setup file over to the data collection machine or Log Analytics Gateway server.

    The  Microsoft Azure window, which is showing the Download Windows Agent links for 64 bit and 32 bit setup files.

    Note

    If a monitoring client was installed for System Center Operations Manager (SCOM), the setup only offers to Upgrade the agent, preserving existing settings. The upgrade for SCOM agent does not include any of the configuration steps following.

The next steps apply to installations where no monitoring client was installed for SCOM. Refer to the Microsoft Monitoring Agent Upgrade section in this document when you are performing an upgrade of the Monitoring Agent for SCOM.

  1. Run Setup to install the agent.

  2. On the Welcome page, select Next.

  3. On the License Terms page, read the license and then select I Agree.

  4. On the Destination Folder page, change or keep the default installation folder and then select Next.

  5. On the Agent Setup Options page, choose Connect the agent to Azure Log Analytics (OMS). Select Next.

    The Microsoft Monitoring Agent Setup window, which shows that Connect the agent to Azure Log Analytics O M S is selected.

  6. On the Overview, Settings Dashboard page, click Connected Sources, and then copy and paste the Workspace ID and Workspace Key (Primary Key) from the log analytics portal. (Hint: Select the copy button then paste in the corresponding Agent Setup box). Select Azure Commercial or if you are using an Azure US Government cloud select Azure US Government from the Azure Cloud drop down menu and select OK.

  7. If you are currently installing the agent on the data collection machine and using a Log Analytics Gateway deployment scenario, or if your company requires access through a proxy server, Select Advanced to provide HTTP proxy configuration. If you do not use any of these, select Next and go to step 12.

  8. Specify the fully qualified domain name (FQDN) or the IP address and port of the Log Analytics Gateway. If you use a proxy server instead of a Log Analytics Gateway, add the information for your proxy server and, if required, authentication credentials (not required for the Log Analytics Gateway), then select Next twice.

    The Microsoft Monitoring Agent Setup window, which shows the Proxy URL is filled in with the proxy server information.

  9. On the Microsoft Update page, optionally select Use Microsoft Update when I check for updates (recommended), then select Next.

  10. On the Ready to Install page, review your choices, and then select Install.

  11. On the Microsoft Monitoring Agent configuration completes successfully page, select Finish.

    The Microsoft Monitoring Agent Setup window, which shows the Finish button.

  12. When complete, the Microsoft Monitoring Agent appears in Control Panel. You can review your configuration there and verify that the agent is connected to Azure Log Analytics. When connected to Log Analytics, the agent displays a message stating: The Microsoft Monitoring Agent has successfully connected to the log analytics service.

    The Control Panel window, which shows the highlighted Microsoft Monitoring Agent in the settings list.

    The Microsoft Monitoring Agent Properties window, which shows the highlighted Azure Log Analytics tab and the successful connection.

Note

If you have been installing the Microsoft Monitoring Agent on the Log Analytics Gateway, you need to repeat the listed installation steps for the data collection machine.

After setting up the data collection machine, continue getting started with On-demand Assessments by selecting the Configure Microsoft On-demand Assessments article in the Table of Contents.

Microsoft Monitoring Agent Upgrade

If a monitoring agent is already installed, the Microsoft Monitoring Agent setup will only display the upgrade command. The upgrade will keep the existing configuration and adds a new command to configure a Log Analytics workspace.

Follow the steps to perform an upgrade and configure the agent for the Log Analytics Workspace.

  1. Run Setup to install the agent.

  2. On the Welcome page, select Next.

  3. On the License Terms page, read the license and then select I Agree.

  4. On the begin Upgrade page, select Upgrade.

  5. On the Completion page, select Finish.

  6. Once the agent installation completes, go to the Control Panel.

    The Control Panel window, which shows the highlighted Microsoft Monitoring Agent in the list of settings.

  7. Select Microsoft Monitoring Agent.

  8. If the Log Analytics Gateway scenario is chosen or a Proxy server is in place go to the Proxy Settings tab. When this scenario is not used go to Step 9.

    The Microsoft Monitoring Agent Properties window which shows the Use a proxy server option is checked.

    Select Use a proxy server and specify the fully qualified domain name (FQDN) or the IP address and port of the Log Analytics Gateway. If you use a proxy server instead of a Log Analytics Gateway, add the information for your proxy server and if required, authentication credentials (not required for the Log Analytics Gateway), then Select Apply.

  9. Select the Azure Log Analytics (OMS) tab and select Add.

    The Add a Log Analytics Workspace showing the Azure Commercial item is selected from the Azure Cloud dropdown menu.

  10. Copy and paste the Workspace ID and Workspace Key (Primary Key) from the log analytics portal. (Tip: Select the copy button then paste in the corresponding Agent Setup field). Select Azure Commercial or, if you are using an Azure US Government cloud select Azure US Government from the Azure Cloud drop down menu and select OK.

  11. An exclamation mark will be visible in the Workspaces pane. Select Apply. This will stop and start the agent, and the Workspaces pane should look like the following example after a few seconds.

    Status: The Microsoft Monitoring Agent has successfully connected.

  12. Select OK to finish.

  13. Select OK to finish the Microsoft Monitoring Agent upgrade for Log Analytics.

After setting up the data collection machine, continue getting started with On-demand Assessments by selecting the Configure Microsoft On-demand Assessments article in the Table of Contents.