Skip to content

Commit 6fbf6fe

Browse files
Merge pull request #208362 from guywi-ms/patch-22
Update agent-manage.md
2 parents b5fcab5 + 6dadc98 commit 6fbf6fe

File tree

3 files changed

+12
-10
lines changed

3 files changed

+12
-10
lines changed

articles/azure-monitor/agents/agent-manage.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Managing the Azure Log Analytics agent
2+
title: Manage the Azure Log Analytics agent
33
description: This article describes the different management tasks that you will typically perform during the lifecycle of the Log Analytics Windows or Linux agent deployed on a machine.
44
ms.topic: conceptual
55
author: guywi-ms
@@ -8,17 +8,17 @@ ms.date: 04/06/2022
88
ms.reviewer: luki
99
---
1010

11-
# Managing and maintaining the Log Analytics agent for Windows and Linux
11+
# Manage and maintain the Log Analytics agent for Windows and Linux
1212

1313
After initial deployment of the Log Analytics Windows or Linux agent in Azure Monitor, you may need to reconfigure the agent, upgrade it, or remove it from the computer if it has reached the retirement stage in its lifecycle. You can easily manage these routine maintenance tasks manually or through automation, which reduces both operational error and expenses.
1414

1515
[!INCLUDE [Log Analytics agent deprecation](../../../includes/log-analytics-agent-deprecation.md)]
1616

17-
## Upgrading agent
17+
## Upgrade the agent
1818

19-
The Log Analytics agent for Windows and Linux can be upgraded to the latest release manually or automatically depending on the deployment scenario and environment the VM is running in. The following methods can be used to upgrade the agent.
19+
Upgrade to the latest release of the Log Analytics agent for Windows and Linux manually or automatically based on your deployment scenario and the environment the VM is running in:
2020

21-
| Environment | Installation Method | Upgrade method |
21+
| Environment | Installation method | Upgrade method |
2222
|--------|----------|-------------|
2323
| Azure VM | Log Analytics agent VM extension for Windows/Linux | Agent is automatically upgraded [after the VM model changes](../../virtual-machines/extensions/features-linux.md#how-agents-and-extensions-are-updated), unless you configured your Azure Resource Manager template to opt out by setting the property _autoUpgradeMinorVersion_ to **false**. Once deployed, however, the extension will not upgrade minor versions unless redeployed, even with this property set to true. Major version upgrade is always manual. See [VirtualMachineExtensionInner.AutoUpgradeMinorVersion Property](https://docs.azure.cn/dotnet/api/microsoft.azure.management.compute.fluent.models.virtualmachineextensioninner.autoupgrademinorversion?view=azure-dotnet). |
2424
| Custom Azure VM images | Manual install of Log Analytics agent for Windows/Linux | Updating VMs to the newest version of the agent needs to be performed from the command line running the Windows installer package or Linux self-extracting and installable shell script bundle.|
@@ -41,7 +41,7 @@ You can download the latest version of the Windows agent from your Log Analytics
4141
5. From the **Windows Servers** page, select the appropriate **Download Windows Agent** version to download depending on the processor architecture of the Windows operating system.
4242

4343
>[!NOTE]
44-
>During the upgrade of the Log Analytics agent for Windows, it does not support configuring or reconfiguring a workspace to report to. To configure the agent, you need to follow one of the supported methods listed under [Adding or removing a workspace](#adding-or-removing-a-workspace).
44+
>During the upgrade of the Log Analytics agent for Windows, it does not support configuring or reconfiguring a workspace to report to. To configure the agent, you need to follow one of the supported methods listed under [Add or remove a workspace](#add-or-remove-a-workspace).
4545
>
4646
4747
#### To upgrade using the Setup Wizard
@@ -80,7 +80,7 @@ Run the following command to upgrade the agent.
8080
8181
### Enable Auto-Update for the Linux Agent
8282
83-
The **recommendation** is to enable automatic update of the agent by enabling the [Automatic Extension Upgrade](../../virtual-machines/automatic-extension-upgrade.md) feature, using the following PowerShell commands.
83+
We recommend enabling [Automatic Extension Upgrade](../../virtual-machines/automatic-extension-upgrade.md) using these commands to update the agent automatically:
8484
8585
# [Powershell](#tab/PowerShellLinux)
8686
```powershell
@@ -109,7 +109,7 @@ az vm extension set \
109109
```
110110
---
111111

112-
## Adding or removing a workspace
112+
## Add or remove a workspace
113113

114114
### Windows agent
115115
The steps in this section are necessary when you want to not only reconfigure the Windows agent to report to a different workspace or to remove a workspace from its configuration, but also when you want to configure the agent to report to more than one workspace (commonly referred to as multi-homing). Configuring the Windows agent to report to multiple workspaces can only be performed after initial setup of the agent and using the methods described below.

articles/azure-monitor/agents/agent-windows.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@ title: Install Log Analytics agent on Windows computers
33
description: This article describes how to connect Windows computers hosted in other clouds or on-premises to Azure Monitor with the Log Analytics agent for Windows.
44
ms.topic: conceptual
55
ms.date: 03/31/2022
6+
author: guywi-ms
7+
ms.author: guywild
68
ms.reviewer: JeffWo
79

810
---
@@ -72,7 +74,7 @@ Regardless of the installation method used, you'll require the workspace ID and
7274
[![Screenshot that shows workspace details.](media/log-analytics-agent/workspace-details.png)](media/log-analytics-agent/workspace-details.png#lightbox)
7375

7476
> [!NOTE]
75-
> You can't configure the agent to report to more than one workspace during initial setup. [Add or remove a workspace](agent-manage.md#adding-or-removing-a-workspace) after installation by updating the settings from Control Panel or PowerShell.
77+
> You can't configure the agent to report to more than one workspace during initial setup. [Add or remove a workspace](agent-manage.md#add-or-remove-a-workspace) after installation by updating the settings from Control Panel or PowerShell.
7678
7779
## Install the agent
7880

articles/virtual-machines/extensions/oms-windows.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ The following JSON shows the schema for the Log Analytics agent extension. The e
105105
Azure VM extensions can be deployed with Azure Resource Manager templates. The JSON schema detailed in the previous section can be used in an Azure Resource Manager template to run the Log Analytics agent extension during an Azure Resource Manager template deployment. A sample template that includes the Log Analytics agent VM extension can be found on the [Azure Quickstart Gallery](https://github.com/Azure/azure-quickstart-templates/tree/master/demos/oms-extension-windows-vm).
106106

107107
>[!NOTE]
108-
>The template does not support specifying more than one workspace ID and workspace key when you want to configure the agent to report to multiple workspaces. To configure the agent to report to multiple workspaces, see [Adding or removing a workspace](../../azure-monitor/agents/agent-manage.md#adding-or-removing-a-workspace).
108+
>The template does not support specifying more than one workspace ID and workspace key when you want to configure the agent to report to multiple workspaces. To configure the agent to report to multiple workspaces, see [Add or remove a workspace](../../azure-monitor/agents/agent-manage.md#add-or-remove-a-workspace).
109109
110110
The JSON for a virtual machine extension can be nested inside the virtual machine resource, or placed at the root or top level of a Resource Manager JSON template. The placement of the JSON affects the value of the resource name and type. For more information, see [Set name and type for child resources](../../azure-resource-manager/templates/child-resource-name-type.md).
111111

0 commit comments

Comments
 (0)