From 6fce9bedafd3da4705714352bb2990562ea519bf Mon Sep 17 00:00:00 2001 From: perzycharles <37419121+perzycharles@users.noreply.github.com> Date: Wed, 19 Feb 2025 15:52:43 +0900 Subject: [PATCH 1/2] Update TypeHandlerVersion to 7.0 for Windows command --- ...powershell-command-to-install-azure-datadog-extension.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/integrations/guide/powershell-command-to-install-azure-datadog-extension.md b/content/en/integrations/guide/powershell-command-to-install-azure-datadog-extension.md index b6d3bdf11bc80..f78784138e7d2 100644 --- a/content/en/integrations/guide/powershell-command-to-install-azure-datadog-extension.md +++ b/content/en/integrations/guide/powershell-command-to-install-azure-datadog-extension.md @@ -27,7 +27,7 @@ To run the Datadog Agent in your Azure instances as an extension, use the comman {{% tab "Windows" %}} {{< code-block lang="powershell" >}} -Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "5.0" -Settings @{"site" = ""; "agentVersion" = "latest"} -ProtectedSettings @{"api_key" = ""} -DisableAutoUpgradeMinorVersion +Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @{"site" = ""; "agentVersion" = "latest"} -ProtectedSettings @{"api_key" = ""} -DisableAutoUpgradeMinorVersion {{< /code-block >}} More information on the syntax to set Azure instance extensions can be found in the [Azure Extension Set-AzVMExtension documentation][1]. @@ -58,7 +58,7 @@ The Datadog Windows Agent Azure Extension will check that the `agentConfiguratio The Datataog Agent configuration should be created from the `%PROGRAMDATA%\Datadog` folder. {{< code-block lang="powershell" >}} -Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "5.0" -Settings @{"site" = ""; "agentConfiguration" = "https://.blob.core.windows.net/.zip"; "agentConfigurationChecksum" = ""} -DisableAutoUpgradeMinorVersion +Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @{"site" = ""; "agentConfiguration" = "https://.blob.core.windows.net/.zip"; "agentConfigurationChecksum" = ""} -DisableAutoUpgradeMinorVersion {{< /code-block >}} **Note**: Once the Datadog Agent is installed, the configuration can only be changed when upgrading to a newer version. @@ -69,7 +69,7 @@ This example shows how to specify a version of the Agent to install. By default **Note**: Downgrades are *not* supported, so it's not possible to install a *lower* version of the Datadog Agent than the one currently installed on the target machine. To install a lower version of the Datadog Agent, uninstall the previous version first by removing the Datadog Windows Agent Azure Extension on the target machine. Removing the Datadog Windows Agent Azure Extension does not remove the Datadog Agent configuration. {{< code-block lang="powershell" >}} -Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "5.0" -Settings @{"site" = ""; "agentVersion" = "latest"} -ProtectedSettings @{"api_key" = ""} -DisableAutoUpgradeMinorVersion +Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @{"site" = ""; "agentVersion" = "latest"} -ProtectedSettings @{"api_key" = ""} -DisableAutoUpgradeMinorVersion {{< /code-block >}} [1]: https://learn.microsoft.com/en-us/powershell/module/az.compute/set-azvmextension From b52bf6b1e76489fd6b3ffcc28844d009153a509e Mon Sep 17 00:00:00 2001 From: perzycharles <37419121+perzycharles@users.noreply.github.com> Date: Thu, 20 Feb 2025 14:07:22 +0900 Subject: [PATCH 2/2] add required parameters --- ...shell-command-to-install-azure-datadog-extension.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/en/integrations/guide/powershell-command-to-install-azure-datadog-extension.md b/content/en/integrations/guide/powershell-command-to-install-azure-datadog-extension.md index f78784138e7d2..e3265a68a3dbf 100644 --- a/content/en/integrations/guide/powershell-command-to-install-azure-datadog-extension.md +++ b/content/en/integrations/guide/powershell-command-to-install-azure-datadog-extension.md @@ -27,7 +27,7 @@ To run the Datadog Agent in your Azure instances as an extension, use the comman {{% tab "Windows" %}} {{< code-block lang="powershell" >}} -Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @{"site" = ""; "agentVersion" = "latest"} -ProtectedSettings @{"api_key" = ""} -DisableAutoUpgradeMinorVersion +Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @{"site" = ""; "agentVersion" = "latest"} -ProtectedSettings @{"api_key" = ""} -DisableAutoUpgradeMinorVersion -VMName and -ResourceGroupName {{< /code-block >}} More information on the syntax to set Azure instance extensions can be found in the [Azure Extension Set-AzVMExtension documentation][1]. @@ -58,7 +58,7 @@ The Datadog Windows Agent Azure Extension will check that the `agentConfiguratio The Datataog Agent configuration should be created from the `%PROGRAMDATA%\Datadog` folder. {{< code-block lang="powershell" >}} -Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @{"site" = ""; "agentConfiguration" = "https://.blob.core.windows.net/.zip"; "agentConfigurationChecksum" = ""} -DisableAutoUpgradeMinorVersion +Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @{"site" = ""; "agentConfiguration" = "https://.blob.core.windows.net/.zip"; "agentConfigurationChecksum" = ""} -DisableAutoUpgradeMinorVersion -VMName and -ResourceGroupName {{< /code-block >}} **Note**: Once the Datadog Agent is installed, the configuration can only be changed when upgrading to a newer version. @@ -69,7 +69,7 @@ This example shows how to specify a version of the Agent to install. By default **Note**: Downgrades are *not* supported, so it's not possible to install a *lower* version of the Datadog Agent than the one currently installed on the target machine. To install a lower version of the Datadog Agent, uninstall the previous version first by removing the Datadog Windows Agent Azure Extension on the target machine. Removing the Datadog Windows Agent Azure Extension does not remove the Datadog Agent configuration. {{< code-block lang="powershell" >}} -Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @{"site" = ""; "agentVersion" = "latest"} -ProtectedSettings @{"api_key" = ""} -DisableAutoUpgradeMinorVersion +Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "DatadogWindowsAgent" -TypeHandlerVersion "7.0" -Settings @{"site" = ""; "agentVersion" = "latest"} -ProtectedSettings @{"api_key" = ""} -DisableAutoUpgradeMinorVersion -VMName and -ResourceGroupName {{< /code-block >}} [1]: https://learn.microsoft.com/en-us/powershell/module/az.compute/set-azvmextension @@ -77,7 +77,7 @@ Set-AzVMExtension -Name "DatadogAgent" -Publisher "Datadog.Agent" -Type "Datadog {{% tab "Linux" %}} {{< code-block lang="bash" >}} -az vm extension set --publisher "Datadog.Agent" --name "DatadogLinuxAgent" --version 7.0 --settings '{"site":"datadoghq.com", "agentVersion":"latest"}' --protected-settings '{"api_key":""}' --no-auto-upgrade-minor-version +az vm extension set --publisher "Datadog.Agent" --name "DatadogLinuxAgent" --version 7.0 --settings '{"site":"datadoghq.com", "agentVersion":"latest"}' --protected-settings '{"api_key":""}' --no-auto-upgrade-minor-version --vm-name --resource-group {{< /code-block >}} More information on the syntax to set Azure instance extensions can be found in the [Azure Extension CLI reference][1]. @@ -107,7 +107,7 @@ This example shows how to specify a configuration for the Datadog Agent to use. - The Datataog Agent configuration should be created from the `/etc/datadog-agent/` folder. {{< code-block lang="bash" >}} -az vm extension set --publisher "Datadog.Agent" --name "DatadogLinuxAgent" --version 7.0 --settings '{"site":"datadoghq.com", "agentVersion":"latest", "agentConfiguration":"https://.blob.core.windows.net/.zip", "agentConfigurationChecksum":""}' --protected-settings '{"api_key":""}' --no-auto-upgrade-minor-version +az vm extension set --publisher "Datadog.Agent" --name "DatadogLinuxAgent" --version 7.0 --settings '{"site":"datadoghq.com", "agentVersion":"latest", "agentConfiguration":"https://.blob.core.windows.net/.zip", "agentConfigurationChecksum":""}' --protected-settings '{"api_key":""}' --no-auto-upgrade-minor-version --vm-name --resource-group {{< /code-block >}}