Nova versão da extensão Azure VM para soluções SAP

Há duas versões da extensão VM. Este artigo aborda a nova versão da extensão de VM do Azure para SAP. Para obter orientação sobre como instalar a versão padrão, consulte Versão padrão da extensão de VM do Azure para soluções SAP.

Pré-requisitos

Certifique-se de desinstalar a extensão padrão da VM antes de mudar para a nova versão da Extensão Azure para SAP.

Certifique-se de usar o SAP Host Agent 7.21 PL 47 ou posterior.

Certifique-se de que a máquina virtual (VM) onde a extensão está ativada tem acesso a management.azure.com.

O módulo Azure PowerShell ou Azure CLI deve ser instalado. Veja as seguintes instruções:

Azure PowerShell
CLI do Azure

Siga os passos descritos em Instalar o módulo Azure PowerShell.

Verifique frequentemente atualizações nos cmdlets do Azure PowerShell. Salvo indicação em contrário no SAP Note 1928533 ou no SAP Note 2015553, recomendamos que você trabalhe com a versão mais recente dos cmdlets do Azure PowerShell.

Para verificar a versão dos cmdlets Azure PowerShell instalados no seu computador, execute o seguinte comando:

(Get-Module Az.Compute).Version

Siga os passos descritos em Instalar a CLI Azure. Verifique frequentemente atualizações na CLI do Azure.

Para verificar a versão do Azure CLI instalada no seu computador, execute o seguinte comando:

az --version

Nota

Declaração geral de apoio:

O suporte para a Extensão do Azure para SAP é fornecido através dos canais de suporte SAP. Se precisar de ajuda com a extensão Azure VM para soluções SAP, abra um caso de suporte com o suporte SAP.

Configurar a extensão de VM do Azure para soluções SAP

Azure PowerShell
CLI do Azure

A nova Extensão de VM para SAP utiliza uma identidade gerida atribuída à VM para aceder aos dados de monitorização e configuração da VM. Para instalar a nova Extensão Azure para SAP usando Azure PowerShell, primeiro tem de atribuir essa identidade à VM e conceder a essa identidade acesso a todos os recursos que essa VM utiliza.

Nota

Os passos seguintes requerem privilégios de Proprietário sobre o grupo de recursos ou recursos individuais (VM, discos de dados, interfaces de rede, etc.).

Certifique-se de usar o SAP Host Agent 7.21 PL 47 ou superior.
Certifique-se de desinstalar a versão padrão do VM Extension for SAP. Instalar ambas as versões da Extensão de VM para SAP na mesma VM não é suportado.
Certifique-se de que a versão mais recente do cmdlet Azure PowerShell (pelo menos 4.3.0) está instalada.
Para uma lista de ambientes disponíveis, execute Get-AzEnvironment. Se você quiser usar o Azure global, seu ambiente é AzureCloud. Para o Microsoft Azure operado pela 21Vianet, selecione AzureChinaCloud.

A Extensão de VM para SAP dá suporte à configuração de um proxy que a extensão deve usar para se conectar a recursos externos, por exemplo, a API do Azure Resource Manager. Use o parâmetro -ProxyURI para definir o proxy.
```
$env = Get-AzEnvironment -Name <name of the environment>
Connect-AzAccount -Environment $env
Set-AzContext -SubscriptionName <subscription name>
Set-AzVMAEMExtension -ResourceGroupName <resource group name> -VMName <virtual machine name> -InstallNewExtension
```
Reiniciar o SAP Host Agent.

Inicia sessão na VM onde ativaste a VM Extension para SAP e reinicia o SAP Host Agent se já estivesse instalado. O SAP Host Agent não usa a Extensão da VM até a reiniciares. Atualmente, não é possível detetar que uma extensão foi instalada depois de ter sido iniciada.

A nova extensão de VM para SAP usa uma identidade gerenciada atribuída à VM para acessar dados de monitoramento e configuração da VM.

Nota

Os passos seguintes requerem privilégios de Proprietário sobre o grupo de recursos ou recursos individuais (VM, discos de dados, interfaces de rede, etc.).

Certifique-se de usar o SAP Host Agent 7.21 PL 47 ou posterior.
Certifique-se de desinstalar a versão atual da extensão de VM para SAP. Não é possível instalar ambas as versões da extensão de VM para SAP na mesma VM.
Instale a versão mais recente da CLI do Azure 2.0 (versão 2.19.1 ou posterior).
Entre com sua conta do Azure:
```
az login
```
Instale a extensão Azure Enhanced Monitoring (AEM). Certifique-se de usar a versão 0.2.2 ou posterior.
```
az extension add --name aem
```
Habilite a nova extensão:

A Extensão de VM para SAP dá suporte à configuração de um proxy que a extensão deve usar para se conectar a recursos externos, por exemplo, a API do Azure Resource Manager. Para definir o proxy, adicione --proxy-uri <my_proxy_uri>.
```
az vm aem set -g <resource-group-name> -n <vm name> --install-new-extension
```
Reiniciar o SAP Host Agent

Inicia sessão na VM onde ativaste a VM Extension para SAP e reinicia o SAP Host Agent se já estivesse instalado. O SAP Host Agent não usa a Extensão da VM até a reiniciares. Atualmente, não é possível detetar que uma extensão foi instalada depois de ter sido iniciada.

Configurar manualmente a extensão de VM do Azure para soluções SAP

Se quiseres usar o Azure Resource Manager, Terraform ou outras ferramentas para implementar a Extensão VM para SAP, também podes implementar manualmente a Extensão VM para SAP.

Antes de implementar a Extensão da VM para SAP, certifique-se de atribuir uma identidade gerida atribuída pelo utilizador ou sistema à VM. Para obter mais informações, leia os seguintes guias:

Após atribuir uma identidade à VM, dê-lhe acesso de leitura ao grupo de recursos ou aos recursos individuais associados à VM (interfaces de rede, discos do sistema operativo e discos de dados). Recomendamos que utilize o papel de Leitor incorporado para obter acesso a estes recursos. Também pode conceder este acesso adicionando a identidade da VM a um grupo Microsoft Entra que já tenha as permissões de leitura para os recursos necessários. Assim, já não é necessário ter privilégios de Proprietário ao implementar a Extensão da VM para SAP se usares uma identidade atribuída pelo utilizador que já tem as permissões necessárias.

Há diferentes maneiras de implantar a extensão de VM para SAP manualmente. A extensão atualmente suporta as seguintes chaves de configuração. No exemplo seguinte, o msi_res_id é mostrado.

msi_res_id: ID da identidade atribuída ao usuário que a extensão deve usar para obter as informações necessárias sobre a VM e seus recursos
proxy: URL do proxy que a extensão deve usar para se ligar à internet, por exemplo, para recuperar informações sobre a VM e os seus recursos.

O código a seguir contém quatro exemplos. Ele mostra como implantar a extensão no Windows e Linux, usando um sistema ou identidade atribuída pelo usuário. Certifica-te de substituir o nome do grupo de recursos, a localização e o nome da VM no exemplo.

# Windows VM - user assigned identity
Set-AzVMExtension -Publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" -ExtensionType "MonitorX64Windows" -ResourceGroupName "<rg name>" -VMName "<vm name>" `
   -Name "MonitorX64Windows" -TypeHandlerVersion "1.0" -Location "<location>" -SettingString '{"cfg":[{"key":"msi_res_id","value":"<user assigned resource id>"}]}'

# Windows VM - system assigned identity
Set-AzVMExtension -Publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" -ExtensionType "MonitorX64Windows" -ResourceGroupName "<rg name>" -VMName "<vm name>" `
   -Name "MonitorX64Windows" -TypeHandlerVersion "1.0" -Location "<location>" -SettingString '{"cfg":[]}'

# Linux VM - user assigned identity
Set-AzVMExtension -Publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" -ExtensionType "MonitorX64Linux" -ResourceGroupName "<rg name>" -VMName "<vm name>" `
   -Name "MonitorX64Linux" -TypeHandlerVersion "1.0" -Location "<location>" -SettingString '{"cfg":[{"key":"msi_res_id","value":"<user assigned resource id>"}]}'

# Linux VM - system assigned identity
Set-AzVMExtension -Publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" -ExtensionType "MonitorX64Linux" -ResourceGroupName "<rg name>" -VMName "<vm name>" `
   -Name "MonitorX64Linux" -TypeHandlerVersion "1.0" -Location "<location>" -SettingString '{"cfg":[]}'

# Windows VM - user assigned identity
az vm extension set --publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" --name "MonitorX64Windows" --resource-group "<rg name>" --vm-name "<vm name>" \
   --extension-instance-name "MonitorX64Windows" --settings '{"cfg":[{"key":"msi_res_id","value":"<user assigned resource id>"}]}'

# Windows VM - system assigned identity
az vm extension set --publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" --name "MonitorX64Windows" --resource-group "<rg name>" --vm-name "<vm name>" \
   --extension-instance-name "MonitorX64Windows" --settings '{"cfg":[]}'

# Linux VM - user assigned identity
az vm extension set --publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" --name "MonitorX64Linux" --resource-group "<rg name>" --vm-name "<vm name>" \
   --extension-instance-name "MonitorX64Linux" --settings '{"cfg":[{"key":"msi_res_id","value":"<user assigned resource id>"}]}'

# Linux VM - system assigned identity
az vm extension set --publisher "Microsoft.AzureCAT.AzureEnhancedMonitoring" --name "MonitorX64Linux" --resource-group "<rg name>" --vm-name "<vm name>" \
   --extension-instance-name "MonitorX64Linux" --settings '{"cfg":[]}'

O manifesto a seguir contém quatro exemplos. Ele mostra como implantar a extensão no Windows e Linux, usando um sistema ou identidade atribuída pelo usuário. Certifique-se de substituir a ID da VM e a ID da identidade atribuída ao usuário no exemplo.

# Windows VM - user assigned identity

resource "azurerm_virtual_machine_extension" "example" {
  name                 = "MonitorX64Windows"
  virtual_machine_id   = "<vm id>"
  publisher            = "Microsoft.AzureCAT.AzureEnhancedMonitoring"
  type                 = "MonitorX64Windows"
  type_handler_version = "1.0"
  auto_upgrade_minor_version = true

  settings = <<SETTINGS
{
    "cfg":[
        {
            "key":"msi_res_id",
            "value":"<user assigned resource id>"
        }
    ]
}
SETTINGS
}

# Windows VM - system assigned identity

resource "azurerm_virtual_machine_extension" "example" {
  name                 = "MonitorX64Windows"
  virtual_machine_id   = "<vm id>"
  publisher            = "Microsoft.AzureCAT.AzureEnhancedMonitoring"
  type                 = "MonitorX64Windows"
  type_handler_version = "1.0"
  auto_upgrade_minor_version = true

  settings = <<SETTINGS
{
    "cfg":[
    ]
}
SETTINGS
}

# Linux VM - user assigned identity

resource "azurerm_virtual_machine_extension" "example" {
  name                 = "MonitorX64Linux"
  virtual_machine_id   = "<vm id>"
  publisher            = "Microsoft.AzureCAT.AzureEnhancedMonitoring"
  type                 = "MonitorX64Linux"
  type_handler_version = "1.0"
  auto_upgrade_minor_version = true

  settings = <<SETTINGS
{
    "cfg":[
        {
            "key":"msi_res_id",
            "value":"<user assigned resource id>"
        }
    ]
}
SETTINGS
}

# Linux VM - system assigned identity

resource "azurerm_virtual_machine_extension" "example" {
  name                 = "MonitorX64Linux"
  virtual_machine_id   = "<vm id>"
  publisher            = "Microsoft.AzureCAT.AzureEnhancedMonitoring"
  type                 = "MonitorX64Linux"
  type_handler_version = "1.0"
  auto_upgrade_minor_version = true

  settings = <<SETTINGS
{
    "cfg":[
    ]
}
SETTINGS
}

Versões da extensão VM para SAP

Se quiser desabilitar as atualizações automáticas para a extensão VM ou implantar uma versão específica da extensão, você poderá recuperar as versões disponíveis com a CLI do Azure ou o Azure PowerShell.

Azure PowerShell
CLI do Azure

# Windows
Get-AzVMExtensionImage -Location westeurope -PublisherName Microsoft.AzureCAT.AzureEnhancedMonitoring -Type MonitorX64Windows

# Linux
Get-AzVMExtensionImage -Location westeurope -PublisherName Microsoft.AzureCAT.AzureEnhancedMonitoring -Type MonitorX64Linux

# Windows
az vm extension image list --location westeurope --publisher Microsoft.AzureCAT.AzureEnhancedMonitoring --name MonitorX64Windows

# Linux
az vm extension image list --location westeurope --publisher Microsoft.AzureCAT.AzureEnhancedMonitoring --name MonitorX64Linux

Verificação da preparação

Essa verificação garante que todas as métricas de desempenho que aparecem dentro do seu aplicativo SAP sejam fornecidas pela Extensão do Azure para SAP subjacente.

Windows VM
Máquina virtual Linux

Inicia sessão na VM do Azure (não é necessário usar uma conta de administrador).
Abra um browser e navegue para http://127.0.0.1:11812/azure4sap/metrics.
O navegador deve mostrar ou descarregar um ficheiro XML que contenha os dados de monitorização da sua VM. Se esse não for o caso, verifique se a Extensão do Azure para SAP está instalada.
Verifique o conteúdo do arquivo XML. O ficheiro XML que pode aceder em http://127.0.0.1:11812/azure4sap/metrics contém todos os contadores de desempenho do Azure preenchidos para o SAP. Ele também contém um resumo e um indicador de integridade do status do Azure Extension for SAP.
Verifique o valor do elemento Descrição da Integridade do Provedor. Se o valor não for aceitável, siga as instruções .

Liga-te à VM Azure usando SSH.
Verifique a saída do seguinte comando:
```
curl http://127.0.0.1:11812/azure4sap/metrics
```
Resultado esperado: Retorna um documento XML que contém a informação de monitorização da VM, dos seus discos e interfaces de rede.

Se a verificação anterior não tiver sido bem-sucedida, execute estas verificações extra:

Certifica-te de que está waagent instalado e ativado.

Executar:
```
sudo ls -al /var/lib/waagent/
```
Resultado esperado: Lista o conteúdo do waagent diretório.

Executar:
```
ps -ax | grep waagent
```
Resultado esperado: Exibe uma entrada semelhante a: python /usr/sbin/waagent -daemon
Certifique-se de que a Extensão do Azure para SAP está instalada e em execução.

Executar:
```
sudo sh -c 'ls -al /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-*/'`
```
Resultado esperado: lista o conteúdo do diretório Azure Extension for SAP.

Executar:
```
ps -ax | grep AzureEnhanced
```
Resultado esperado: Exibe uma entrada semelhante a: /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-1.0.0.82/AzureEnhancedMonitoring -monitor
Instale o SAP Host Agent conforme descrito na Nota 1031096 do SAP e verifique a saída do saposcol.

Executar:
```
/usr/sap/hostctrl/exe/saposcol -d
```
Executar:
```
dump ccm
```
Verifique se a métrica Virtualization_Configuration\Enhanced Monitoring Access é true.

Se já tiver instalado um servidor de aplicações SAP NetWeaver Advanced Business Application Programming (ABAP), abra a transação ST06 e verifique se a monitorização está ativada.

Se alguma dessas verificações falhar e para obter informações detalhadas sobre como reimplantar a extensão, consulte Solução de problemas

Controlos sanitários

Se alguns dos dados da infraestrutura não forem entregues corretamente, conforme indicado pelos testes descritos em [Readiness check][vm-extension-for-sap-new.md#readiness-check], execute as verificações de integridade descritas neste artigo. Estas verificações verificam se a infraestrutura Azure e a Extensão Azure para SAP estão configuradas corretamente.

Azure PowerShell
CLI do Azure

Certifique-se de que a versão mais recente do módulo Azure PowerShell (pelo menos 4.3.0) está instalada.

Para obter uma lista de ambientes disponíveis, execute o cmdlet Get-AzEnvironment. Para usar o Azure global, selecione o ambiente AzureCloud . Para o Microsoft Azure operado pela 21Vianet, selecione AzureChinaCloud.

$env = Get-AzEnvironment -Name <name of the environment>
Connect-AzAccount -Environment $env
Set-AzContext -SubscriptionName <subscription name>
Test-AzVMAEMExtension -ResourceGroupName <resource group name> -VMName <virtual machine name>

O script testa a configuração da VM que selecionaste.

Certifique-se de que todos os resultados da verificação de saúde estão OK. Se algumas verificações não mostrarem OK, execute o cmdlet de atualização conforme descrito em Configurar a extensão VM Azure para soluções SAP. Repita as verificações descritas em [Readiness check][vm-extension-for-sap-new.md#readiness-check] e nesta secção. Se as verificações ainda indicarem um problema com alguns ou todos os contadores, consulte Solução de problemas.

Para executar a verificação de saúde da Extensão Azure VM para SAP usando Azure CLI, execute os seguintes comandos:

Instale a CLI 2.0 do Azure. Certifique-se de usar pelo menos a versão 2.19.1 ou posterior (use a versão mais recente).
Entre com sua conta do Azure:
```
az login
```
Instale a extensão do Azure CLI AEM. Certifique-se de usar a versão 0.2.2 ou posterior.
```
az extension add --name aem
```

Verifique a instalação da extensão:

az vm aem verify -g <resource-group-name> -n <vm name>

O script testa a configuração da VM que selecionas.

Próximos passos

Comentários

Esta página foi útil?

Last updated on 2026-03-11

Partilhar via

Nova versão da extensão Azure VM para soluções SAP

Pré-requisitos

Configurar a extensão de VM do Azure para soluções SAP

Configurar manualmente a extensão de VM do Azure para soluções SAP

Versões da extensão VM para SAP

Verificação da preparação

Controlos sanitários

Próximos passos

Comentários

Recursos adicionais