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

Artigo
10/15/2024

Este artigo explica como você deve 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 sua 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 uma cadeia de conexão e uma chave de instrumentação. O último conjunto substitui o outro e pode resultar na não exibição de telemetria no portal. Veja os dados ausentes.

Migração em escala

Você pode usar variáveis de ambiente para passar uma cadeia de conexão para o SDK ou o 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')]"
            }
        }
    ]
}

Novos recursos

As cadeias de conexão fornecem um único parâmetro de configuração e eliminam a necessidade de várias configurações de proxy.

Confiabilidade: as cadeias de conexão tornam a ingestão de telemetria mais confiável removendo dependências de pontos de extremidade de ingestão global.
Segurança: as cadeias de conexão permitem a ingestão de telemetria autenticada usando a autenticação Microsoft Entra para Application Insights.
Pontos de extremidade personalizados (ambientes de nuvem híbrida ou soberana): as configurações de ponto de extremidade permitem enviar dados para uma região específica do Azure Governamental. (Veja exemplos.)
Privacidade (pontos de extremidade regionais): cadeias de conexão facilitam as preocupações de privacidade enviando dados para pontos de extremidade regionais, garantindo que os dados não saiam de uma região geográfica.

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+

Solução de problemas

Esta seção fornece soluções de resoluçã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 ausentes

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

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

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

Perguntas frequentes

Esta seção fornece respostas para perguntas comuns.

Onde mais posso encontrar minha cadeia de conexão?

A cadeia de conexão também está incluída nas propriedades de recurso do Azure Resource Manager para seu recurso do Application Insights, sob o campo chamado ConnectionString.

Como isso afeta a instrumentação automática?

Os cenários de instrumentação automática não são afetados.

Posso usar a autenticação Microsoft Entra com instrumentação automática?

Não é possível habilitar a autenticação do Microsoft Entra para cenários de autoinstrumentação. Pretendemos abordar essa limitação no futuro.

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

A ingestão global envia todos os dados de telemetria para um único ponto de extremidade, independentemente de 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?

A cobrança não é afetada.

Microsoft Q&A

Poste perguntas no Fórum de respostas.

Compartilhar via