Eseguire la migrazione dalle chiavi di strumentazione di Application Insights alle stringhe di connessione
Questo articolo illustra la migrazione dalle chiavi di strumentazione alle stringhe di connessione.
Prerequisiti
- Una versione di 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 le indicazioni in Come impostare le stringhe di connessione.
Importante
Non usare entrambe, stringa di connessione e chiave di strumentazione. Quest'ultimo set sostituisce l'altro e potrebbe comportare la mancata visualizzazione dei dati di telemetria nel portale. Vedere 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, posizionare 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 in che modo è possibile includere automaticamente la stringa di connessione corretta con una distribuzione del Servizio app di Azure. Assicurarsi di includere qualsiasi altra impostazione 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')]"
}
}
]
}
Nuove funzionalità
Le stringhe di connessione forniscono una singola impostazione di configurazione ed eliminano la necessità di più impostazioni proxy.
- Affidabilità: rimuovendo le dipendenze dagli endpoint di inserimento globali, le stringhe di connessione rendono più affidabile l'inserimento dei dati di telemetria.
- Sicurezza: grazie all'autenticazione di Microsoft Entra per Application Insights, le stringhe di connessione consentono l'inserimento di dati di telemetria autenticati.
- Endpoint personalizzati (ambienti cloud sovrani o ibridi): le impostazioni degli endpoint consentono l'invio di dati a un'area specifica di Azure per enti pubblici. (vedere gli esempi).
- Privacy (endpoint regionali): le stringhe di connessione semplificano i problemi di privacy inviando dati agli endpoint regionali, assicurando che i dati non lascino un'area geografica.
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 le soluzioni per la risoluzione dei problemi.
Avviso: "Transizione all'uso di stringhe di connessione per l'inserimento dati"
Per risolvere l'avviso, seguire i passi per la migrazione descritti in questo articolo.
Dati mancanti
- Confermare di usare una versione dell'SDK supportata. Se si usa l'integrazione di Application Insights in un'altra offerta di prodotto Azure, controllare nella relativa documentazione 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 imposta come hardcoded una chiave di strumentazione nel codice dell'applicazione, tale programmazione potrebbe 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à delle risorse di Resource Manager per la risorsa di Application Insights, sotto il nome del campo ConnectionString.
In che modo questo influisce sulla strumentazione automatica?
Gli scenari di strumentazione automatica non ne sono interessati.
È possibile usare l'autenticazione di Microsoft Entra con la strumentazione automatica?
Non è possibile abilitare Autenticazione di Microsoft Entra per gli scenari di strumentazione automatica. L'intenzione è di risolvere questa limitazione in futuro.
Qual è la differenza tra inserimento 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 durante l'elaborazione e l'archiviazione i dati rimangano all'interno di un'area specifica.
In che modo le stringhe di connessione influiscono sulla fatturazione?
La fatturazione non ne è interessata.
Microsoft Q&A
Pubblicare domande nel forum delle risposte.