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

2024-10-10

O Application Insights está mudando de pontos de extremidade de ingestão globais para pontos de extremidade regionais que usam cadeias de conexão, que fornecem recursos adicionais.

Cenários mais afetados por essa 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 solicitava que você adicionasse pontos de extremidade de serviço individuais à sua configuração. Para mais informações, confira Posso monitorar um servidor Web da intranet?. As cadeias de conexão oferecem uma alternativa melhor, reduzindo esse esforço para uma única configuração. Uma emenda simples de prefixo e sufixo permite a população automática e o redirecionamento de todos os pontos de extremidade para os serviços corretos.
Ambientes de nuvem soberana ou híbrida – os usuários podem enviar dados para uma região do Azure Governamental definida. Ao utilizar 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 explica como migrar de chaves de instrumentação para cadeias de conexão.

Pré-requisitos

Migração

Acesse o painel Visão geral do recurso Application Insights.
Localize a cadeia de conexão exibida à direita.
Passe o mouse sobre a cadeia de conexão e selecione o ícone Copiar para a área de transferência.
Configure o SDK do Application Insights seguindo Como definir cadeias de conexão.

Importante

Não use simultaneamente uma cadeia de conexão e uma chave de instrumentação. O último conjunto substitui o outro e pode resultar em telemetria não aparecendo no portal. Veja os dados ausentes.

Migração em 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 seguinte modelo do Azure Resource Manager 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 requer:

{
    "$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 com suporte SDK

.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+

Resolução de problemas

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

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

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

Dados ausentes

Confirme se você está usando uma versão do SDK com suporte. 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 se 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 de sua configuração.
Confirme se a cadeia de conexão é exatamente como fornecida 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 seção fornece respostas para perguntas comuns.

Onde mais posso encontrar minha string de conexão?

A cadeia de conexão também está incluída nas propriedades de recurso do Resource Manager para seu recurso do Application Insights, no nome ConnectionStringdo campo.

Como isso afeta a autoinstrumentação?

Cenários de autoinstrumentação não são afetados.

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

Você não pode habilitar a autenticação do Microsoft Entra para cenários de autoinstrumentação . Temos planos para resolver essa limitação no futuro.

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

A ingestão global envia todos os dados de telemetria para um destino único, sem importar onde esses dados serão armazenados. A ingestão regional permite definir pontos de extremidade específicos por região para ingestão de dados. Essa funcionalidade garante que os dados permaneçam dentro de uma região específica durante o processamento e o armazenamento.

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

O faturamento não é afetado.

Microsoft Q&A

Poste perguntas no fórum de respostas.

Compartilhar via