Migrar das chaves de instrumentação do software Application Insights para cadeias de conexão

O Application Insights está a mudar de pontos de extremidade de ingestão global para pontos de extremidade regionais que usam cadeias de conexão, que fornecem capacidades adicionais.

Cenários mais afetados por esta alteração:

• Exceções de firewall ou redirecionamentos de proxy - Nos casos em que o monitoramento do servidor Web da intranet é necessário, nossa solução anterior pedia que você adicionasse pontos de extremidade de serviço individuais à sua configuração. Para obter mais informações, consulte Posso monitorar um servidor Web de intranet?. As cadeias de conexão oferecem uma alternativa melhor, reduzindo esse esforço a uma única configuração. Um simples ajuste de prefixo e sufixo permite o preenchimento automático e o redirecionamento de todos os endpoints para os serviços certos.

• Ambientes de nuvem soberana ou híbrida - Os usuários podem enviar dados para uma região definida do Azure Government. Usando cadeias de conexão, você pode definir configurações de ponto de extremidade para seus servidores de intranet ou configurações de nuvem híbrida.

Este artigo descreve a migração de chaves de instrumentação para cadeias de conexão.

Pré-requisitos

Migração

1. Vá para o painel Visão geral do recurso do Application Insights.

2. Encontre sua Cadeia de Conexão exibida à direita.

3. Passe o cursor sobre a cadeia de conexão e selecione o ícone Copiar para a área de transferência.

4. Configure o SDK do Application Insights seguindo Como definir cadeias de conexão.

Migração à escala

Use variáveis de ambiente para passar uma cadeia de conexão para o SDK ou agente do Application Insights.

Para definir uma cadeia de conexão por meio de uma variável de ambiente, coloque o valor da cadeia de conexão em uma variável de ambiente chamada APPLICATIONINSIGHTS_CONNECTION_STRING.

Esse processo pode ser automatizado em suas implantações do Azure. Por exemplo, o modelo do Azure Resource Manager a seguir mostra como você pode incluir automaticamente a cadeia de conexão correta com uma implantação do Serviço de Aplicativo do Azure. Certifique-se de incluir quaisquer outras configurações de aplicativo que seu aplicativo exija:

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "appServiceName": {
            "type": "string",
            "metadata": {
                "description": "Name of the App Services resource"
            }
        },
        "appServiceLocation": {
            "type": "string",
            "metadata": {
                "description": "Location to deploy the App Services resource"
            }
        },
        "appInsightsName": {
            "type": "string",
            "metadata": {
                "description": "Name of the existing Application Insights resource to use with this App Service. Expected to be in the same Resource Group."
            }
        }
    },
    "resources": [
        {
            "apiVersion": "2016-03-01",
            "name": "[parameters('appServiceName')]",
            "type": "microsoft.web/sites",
            "location": "[parameters('appServiceLocation')]",
            "properties": {
                "siteConfig": {
                    "appSettings": [
                        {
                            "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
                            "value": "[reference(concat('microsoft.insights/components/', parameters('appInsightsName')), '2015-05-01').ConnectionString]"
                        }
                    ]
                },
                "name": "[parameters('appServiceName')]"
            }
        }
    ]
}

Versões do SDK suportadas

• .NET e .NET Core v2.12.0+
• Java v2.5.1 e Java 3.0+
• JavaScript v2.3.0+
• NodeJS v1.5.0+
• Python v1.0.0+

Solução de problemas

Esta seção fornece soluções de solução de problemas.

Alerta: "Transição para o uso de cadeias de conexão para ingestão de dados"

Siga as etapas de migração neste artigo para resolver esse alerta.

Dados em falta

• Confirme se você está usando uma versão compatível do SDK. Se você usar a integração do Application Insights em outra oferta de produto do Azure, verifique sua documentação sobre como configurar corretamente uma cadeia de conexão.
• Confirme que você não está definindo uma chave de instrumentação e uma cadeia de conexão ao mesmo tempo. As configurações de chave de instrumentação devem ser removidas da sua configuração.
• Confirme se sua cadeia de conexão é exatamente como fornecido no portal do Azure.

As variáveis de ambiente não estão funcionando

Se você codificar uma chave de instrumentação no código do aplicativo, essa programação poderá ter precedência antes das variáveis de ambiente.

Perguntas frequentes

Esta secção fornece respostas a perguntas comuns.

Onde mais posso encontrar minha cadeia de conexão?

A cadeia de conexão também está incluída nas propriedades do recurso do Gestor de Recursos para o recurso Application Insights, sob o nome do campo ConnectionString.

Como isso afeta a autoinstrumentação?

Os cenários de autoinstrumentação não são afetados.

Posso usar a autenticação do Microsoft Entra com autoinstrumentação?

Não é possível habilitar a autenticação do Microsoft Entra para cenários de autoinstrumentação . Temos planos para resolver esta limitação no futuro.

Qual é a diferença entre ingestão global e regional?

A ingestão global envia todos os dados de telemetria para um único endpoint, independentemente de onde esses dados serão armazenados. A ingestão regional permite definir pontos de extremidade específicos por região para a ingestão de dados. Esse recurso garante que os dados permaneçam em uma região específica durante o processamento e o armazenamento.

Como as cadeias de conexão afetam a cobrança?

A faturação não é afetada.

Perguntas e respostas da Microsoft

Poste perguntas no fórum de respostas.