Eseguire la migrazione dalle chiavi di strumentazione di Application Insights alle stringhe di connessione

2024-10-10

Application Insights passa dagli endpoint di inserimento globali agli endpoint a livello di area che usano stringhe di connessione, che offrono funzionalità aggiuntive.

Gli scenari più interessati da questa modifica:

Eccezioni del firewall o reindirizzamenti proxy : nei casi in cui è necessario il monitoraggio per il server Web Intranet, la soluzione precedente richiede di aggiungere singoli endpoint di servizio alla configurazione. Per altre informazioni, vedere è possibile monitorare un server Web Intranet? Le stringhe di connessione offrono un'alternativa migliore riducendo questo sforzo a una singola impostazione. Una semplice modifica del prefisso o del suffisso consente il popolamento automatico e il reindirizzamento di tutti gli endpoint ai servizi corretti.
Ambienti cloud sovrani o ibridi : gli utenti possono inviare dati a un'area di Azure per enti pubblici definita. Usando le stringhe di connessione, è possibile definire le impostazioni dell'endpoint per i server Intranet o le impostazioni del cloud ibrido.

Questo articolo illustra la migrazione dalle chiavi di strumentazione alle stringhe di connessione.

Prerequisiti

Una versione dell'SDK supportata
Una risorsa di Application Insights esistente

Migrazione

Passare al riquadro Panoramica della risorsa di Application Insights.
Trovare la stringa di connessione visualizzata a destra.
Passare il puntatore del mouse sulla stringa di connessione e selezionare l'icona Copia negli Appunti.
Configurare Application Insights SDK seguendo come impostare le stringhe di connessione.

Importante

Non usare sia una stringa di connessione che una chiave di strumentazione. Quest'ultimo set sostituisce l'altro e potrebbe comportare la mancata visualizzazione dei dati di telemetria nel portale. Vedere i dati mancanti.

Migrazione su larga scala

Usare le variabili di ambiente per passare una stringa di connessione all'SDK o all'agente di Application Insights.

Per impostare una stringa di connessione tramite una variabile di ambiente, inserire il valore della stringa di connessione in una variabile di ambiente denominata APPLICATIONINSIGHTS_CONNECTION_STRING.

Questo processo può essere automatizzato nelle distribuzioni di Azure. Ad esempio, il modello di Azure Resource Manager seguente mostra come è possibile includere automaticamente la stringa di connessione corretta con una distribuzione del servizio app di Azure. Assicurarsi di includere qualsiasi altra impostazione dell'app richiesta dall'app:

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

Versioni di SDK supportate

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

Risoluzione dei problemi

In questa sezione vengono fornite soluzioni per la risoluzione dei problemi.

Avviso: "Transizione all'uso di stringhe di connessione per l'inserimento dati"

Per risolvere l'avviso, seguire la procedura di migrazione descritta in questo articolo.

Dati mancanti

Verificare di usare una versione dell'SDK supportata. Se si usa l'integrazione di Application Insights in un'altra offerta di prodotto Azure, vedere la relativa documentazione su come configurare correttamente una stringa di connessione.
Verificare che non si stia impostando contemporaneamente una chiave di strumentazione e una stringa di connessione. Le impostazioni della chiave di strumentazione devono essere rimosse dalla configurazione.
Verificare che la stringa di connessione sia esattamente come fornita nel portale di Azure.

Le variabili di ambiente non funzionano

Se si codifica una chiave di strumentazione nel codice dell'applicazione, tali istruzioni potrebbero avere la precedenza sulle variabili di ambiente.

Domande frequenti

Questa sezione fornisce le risposte alle domande comuni.

Dove è possibile trovare la stringa di connessione?

La stringa di connessione è inclusa anche nelle proprietà della risorsa del Resource Manager per la risorsa di Application Insights, sotto il nome del campo ConnectionString.

In che modo questo influisce sull'strumentazione automatica?

Gli scenari di strumentazione automatica non sono interessati.

È possibile usare l'autenticazione di Microsoft Entra con l'autoinstrumentazione?

Non è possibile abilitare l'autenticazione di Microsoft Entra per gli scenari di strumentazione automatica . Abbiamo intenzione di risolvere questa limitazione in futuro.

Qual è la differenza tra ingestione globale e regionale?

L'inserimento globale invia tutti i dati di telemetria a un singolo endpoint, indipendentemente dalla posizione in cui verranno archiviati questi dati. L'inserimento a livello di area consente di definire endpoint specifici per area per l'inserimento dati. Questa funzionalità garantisce che i dati rimangano all'interno di un'area specifica durante l'elaborazione e l'archiviazione.

In che modo le stringhe di connessione influiscono sulla fatturazione?

La fatturazione non è interessata.

Domande e risposte Microsoft

Pubblicare domande nel forum delle risposte.

Condividi tramite