Application Insights para máquinas virtuais (VMs) do Azure e conjuntos de dimensionamento de máquinas virtuais

Habilitar o monitoramento do Azure MonitorApplication Insights por meio de autoinstrumentação para aplicativos ASP.NET e ASP.NET Core hospedados no Internet Information Server (IIS) em Máquinas Virtuais do Azure e Conjuntos de Dimensionamento de Máquinas Virtuais do Azure. Implantar o Agente do Application Insights com uma extensão de máquina virtual. O agente coleta automaticamente os mesmos sinais de dependência que o SDK. Usar o PowerShell para automatizar implantações em larga escala.

Para obter uma lista completa dos cenários de autoinstrumentação suportados, confira Ambientes, linguagens e provedores de recursos suportados.

Pré-requisitos

Antes de instalar a extensão do Application Insights Agent, você precisa de uma cadeia de conexão. Crie um novo recurso do Application Insights ou copie a cadeia de conexão de uma existente.

Habilitar o monitoramento de máquinas virtuais

Você pode usar o portal do Azure ou PowerShell para habilitar o monitoramento de VMs.

# define variables to match your environment before running
$ResourceGroup = "<myVmResourceGroup>"
$VMName = "<myVmName>"
$Location = "<myVmLocation>"
$ConnectionString = "<myAppInsightsResourceConnectionString>"

$publicCfgJsonString = @"
{
    "redfieldConfiguration": {
        "instrumentationKeyMap": {
        "filters": [
            {
            "appFilter": ".*",
            "machineFilter": ".*",
            "virtualPathFilter": ".*",
            "instrumentationSettings" : {
                "connectionString": "$ConnectionString"
            }
            }
        ]
        }
    }
    }
"@

$privateCfgJsonString = '{}'
	
Set-AzVMExtension -ResourceGroupName $ResourceGroup -VMName $VMName -Location $Location -Name "ApplicationMonitoringWindows" -Publisher "Microsoft.Azure.Diagnostics" -Type "ApplicationMonitoringWindows" -Version "2.8" -SettingString $publicCfgJsonString -ProtectedSettingString $privateCfgJsonString

Get-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Name ApplicationMonitoringWindows -Status

Get-AzResource -ResourceId "/subscriptions/<mySubscriptionId>/resourceGroups/<myVmResourceGroup>/providers/Microsoft.Compute/virtualMachines/<myVmName>/extensions"

Remove-AzVMExtension -ResourceGroupName "<myVmResourceGroup>" -VMName "<myVmName>" -Name "ApplicationMonitoring"

instrumentationKeyMap (configurações de extensão)

Como funciona a correspondência

• O mapa define uma lista ordenada de regras chamadas filters. A primeira regra correspondente entra em vigor. Coloque regras específicas primeiro e termine com uma regra abrangente.
• Cada regra pode atribuir um recurso diferente do Application Insights a aplicativos correspondentes. Prefira cadeias de conexão em cenários com suporte porque as chaves de instrumentação são herdadas.

Filtros disponíveis

• MachineFilter ou machineFilter: expressão regular C# que corresponde ao nome do computador ou da máquina virtual (VM). .* corresponde a todos os nomes.
• AppFilter ou appFilter: expressão regular C# que corresponde ao nome do site IIS (HostingEnvironment.SiteName). Este filtro é obrigatório quando VirtualPathFilter ou virtualPathFilter não são fornecidos.
• VirtualPathFilter ou virtualPathFilter: expressão regular C# que corresponde ao caminho virtual do IIS (HostingEnvironment.ApplicationVirtualPath). Use esse filtro para segmentar um único aplicativo em um site.

Mapeamento de terminologia

• Os cmdlets do PowerShell usam MachineFilter, AppFilter e VirtualPathFilter.
• A extensão JSON para VM e Conjuntos de Dimensionamento de Máquinas Virtuais do Azure usa machineFilter, appFilter e virtualPathFilter e define o recurso com instrumentationSettings.

Onde inserir para a extensão de VM e Conjuntos de Dimensionamento de Máquinas Virtuais

Coloque o mapa em redfieldConfiguration.instrumentationKeyMap.filters nas configurações públicas da extensão (-SettingString para VMs, -Setting para Conjuntos de Dimensionamento de Máquinas Virtuais). Os nomes das propriedades estão em minúsculas concatenadas. Defina o recurso de destino por regra com instrumentationSettings.connectionString.

{
  "redfieldConfiguration": {
    "instrumentationKeyMap": {
      "filters": [
        {
          "machineFilter": ".*",
          "appFilter": ".*",
          "instrumentationSettings": {
            "connectionString": "<your-APPLICATIONINSIGHTS_CONNECTION_STRING>"
          }
        }
      ]
    }
  }
}

Habilitar o monitoramento de conjuntos de dimensionamento de máquinas virtuais

Você pode usar o portal do Azure ou PowerShell para habilitar o monitoramento de conjuntos de dimensionamento de máquinas virtuais.

# Set resource group, vmss name, and connection string to reflect your environment
$ResourceGroup = "<myVmResourceGroup>"
$VMSSName = "<myVmName>"
$ConnectionString = "<myAppInsightsResourceConnectionString>"
$publicCfgHashtable =
@{
  "redfieldConfiguration"= @{
    "instrumentationKeyMap"= @{
      "filters"= @(
        @{
          "appFilter"= ".*";
          "machineFilter"= ".*";
          "virtualPathFilter"= ".*";
          "instrumentationSettings" = @{
            "connectionString"= "$ConnectionString"
          }
        }
      )
    }
  }
};
$privateCfgHashtable = @{};
$vmss = Get-AzVmss -ResourceGroupName $ResourceGroup -VMScaleSetName $VMSSName
Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name "ApplicationMonitoringWindows" -Publisher "Microsoft.Azure.Diagnostics" -Type "ApplicationMonitoringWindows" -TypeHandlerVersion "2.8" -Setting $publicCfgHashtable -ProtectedSetting $privateCfgHashtable
Update-AzVmss -ResourceGroupName $vmss.ResourceGroupName -Name $vmss
# Note: Depending on your update policy, you might need to run Update-AzVmssInstance for each instance

Get-AzResource -ResourceId "/subscriptions/<mySubscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/<myVmssName>/extensions"

# set resource group and vmss name to reflect your environment
$vmss = Get-AzVmss -ResourceGroupName "<myResourceGroup>" -VMScaleSetName "<myVmssName>"
Remove-AzVmssExtension -VirtualMachineScaleSet $vmss -Name "ApplicationMonitoringWindows"
Update-AzVmss -ResourceGroupName $vmss.ResourceGroupName -Name $vmss.Name -VirtualMachineScaleSet $vmss
# Note: Depending on your update policy, you might need to run Update-AzVmssInstance for each instance

Solução de problemas

Use estas dicas de solução de problemas para a extensão Agente de Monitoramento do Application Insights. As dicas se aplicam a aplicativos .NET em Máquinas Virtuais do Azure e Conjuntos de Dimensionamento de Máquinas Virtuais do Azure.

Se você tiver problemas para implantar a extensão, examine a saída de execução que a extensão registra em arquivos nos seguintes diretórios:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.ApplicationMonitoringWindows\<version>\

Se a extensão foi implantada com êxito, mas você não consegue ver a telemetria, isso pode ser devido a um dos problemas a seguir abordados em Solução de problemas do agente:

• Bibliotecas de vínculo dinâmico (DLLs) conflitantes no diretório bin de um aplicativo
• Conflito com a configuração compartilhada do IIS

Testar a conectividade entre o host do aplicativo e o serviço de ingestão

Os SDKs e os agentes do Application Insights enviam a telemetria para ser ingerida como chamadas REST para nossos pontos de extremidade de ingestão. Você pode testar a conectividade do servidor Web ou do computador host do aplicativo aos pontos de extremidade do serviço de ingestão usando clientes REST brutos do PowerShell ou comandos curl. Veja Solucionar problemas de telemetria de aplicativos ausente no Application Insights do Azure Monitor.

Notas sobre a versão

2.8.44

• Atualização do SDK do .NET/.NET Core do Application Insights para a 2.20.1 – Campo vermelho.
• Coleção de consulta SQL habilitada.
• Suporte à autenticação do Microsoft Entra foi habilitado.

2.8.42

Atualização do SDK do Application Insights .NET/.NET Core para 2.18.1 - campo vermelho.

2.8.41

Foi adicionado o recurso de instrumentação automática do ASP.NET Core.

Próximas etapas

• Para revisar perguntas frequentes (FAQ), consulte as perguntas frequentes sobre o Application Insights para VMs do Azure e conjuntos de dimensionamento de máquinas virtuais
• Implantar seu aplicativo em conjuntos de dimensionamento de máquinas virtuais.
• Testes de disponibilidade do Application Insights
• Monitorar dados do hóspede de máquina virtual