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

Artigo
09/13/2024

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

Pré-requisitos

Uma versão SDK suportada
Um recurso existente do Application Insights

Migração

Vá para o painel Visão geral do recurso do Application Insights.
Encontre sua Cadeia de Conexão exibida à direita.
Passe o cursor 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. Este último conjunto substitui o outro, e pode resultar em telemetria não aparecendo no portal. Ver dados em falta.

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')]"
            }
        }
    ]
}

Novas capacidades

As cadeias de conexão fornecem uma única definição 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 em 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 do Microsoft Entra para Application Insights.
Pontos de extremidade personalizados (ambientes de nuvem soberana ou híbrida): as configurações de ponto de extremidade permitem enviar dados para uma região específica do Azure Government. (Ver exemplos.)
Privacidade (pontos de extremidade regionais): as 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 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+

Resoluçã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 mais 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 Gerenciador de Recursos para o recurso do Application Insights, sob o nome ConnectionStringdo campo .

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 ponto de extremidade, não importa 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.

Microsoft Q&A

Poste perguntas no fórum de respostas.

Partilhar via