Eseguire la migrazione dalle chiavi di strumentazione di Application Insights alle stringhe di connessione
Questo articolo illustra la migrazione dalle chiavi di strumentazione alle stringa 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 ion visualizzata a destra.
Passare il puntatore del mouse sul stringa di connessione e selezionare l'icona Copia negli Appunti.
Configurare Application Insights SDK seguendo come impostare stringa di connessione.
Importante
Non usare sia un 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 un stringa di connessione all'SDK o all'agente di Application Insights.
Per impostare un stringa di connessione tramite una variabile di ambiente, posizionare il valore del 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 il stringa di connessione corretto con una distribuzione del servizio app 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')]"
}
}
]
}
Nuove funzionalità
Connessione stringhe forniscono una singola impostazione di configurazione ed eliminano la necessità di più impostazioni proxy.
- Affidabilità: le stringhe di Connessione ion rendono più affidabile l'inserimento dei dati di telemetria rimuovendo le dipendenze dagli endpoint di inserimento globali.
- Sicurezza: le stringhe di Connessione ion consentono l'inserimento di dati di telemetria autenticati tramite l'autenticazione di Microsoft Entra per Application Insights.
- Endpoint personalizzati (ambienti cloud sovrani o ibridi): le impostazioni degli endpoint consentono l'invio di dati a un'area Azure per enti pubblici specifica. Vedere gli esempi.
- Privacy (endpoint internazionali): le stringhe di Connessione ion semplificano i problemi di privacy inviando dati agli endpoint a livello di area, assicurandosi 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 soluzioni per la risoluzione dei problemi.
Avviso: "Transizione all'uso di stringa 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 un stringa di connessione.
- Verificare che non si stia impostando sia una chiave di strumentazione che stringa di connessione contemporaneamente. Le impostazioni della chiave di strumentazione devono essere rimosse dalla configurazione.
- Verificare che il stringa di connessione sia esattamente come specificato nella portale di Azure.
Le variabili di ambiente non funzionano
Se si hardcoded una chiave di strumentazione nel codice dell'applicazione, tale programmazione potrebbe avere la precedenza prima delle variabili di ambiente.
Domande frequenti
Questa sezione fornisce le risposte alle domande comuni.
Dov'altro posso trovare il mio stringa di connessione?
Il stringa di connessione è incluso anche nelle proprietà delle risorse di Resource Manager per la risorsa di Application Insights, sotto il nome ConnectionStringdel campo .
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'installazione automatica?
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 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 i dati rimangano all'interno di un'area specifica durante l'elaborazione e l'archiviazione.
In che modo le stringa di connessione influiscono sulla fatturazione?
La fatturazione non è interessata.
Microsoft Q&A
Pubblicare domande nel forum delle risposte.