Migrazione a risorse di Application Insights basate sull'area di lavoro
Questo articolo illustra la migrazione di una risorsa classica di Application Insights a una risorsa basata sull'area di lavoro.
Risorse basate sull'area di lavoro:
- Supportare l'integrazione completa tra Application Insights e Log Analytics.
- Inviare Application Insights Telemetry a un'area di lavoro Log Analytics comune.
- Consente di accedere alle funzionalità più recenti di Monitoraggio di Azure mantenendo i log dell'applicazione, dell'infrastruttura e della piattaforma in una posizione consolidata.
- Abilitare il controllo degli accessi in base al ruolo di Azure comune tra le risorse.
- Eliminare la necessità di query tra app/aree di lavoro.
- Sono disponibili in tutte le aree commerciali e in Azure US Government.
- Non richiedere la modifica delle chiavi di strumentazione dopo la migrazione da una risorsa classica.
Nuove funzionalità
Le risorse di Application Insights basate sull'area di lavoro consentono di sfruttare le funzionalità più recenti di Monitoraggio di Azure e Log Analytics:
- Le chiavi gestite dal cliente forniscono la crittografia dei dati inattivi con chiavi di crittografia a cui ha accesso solo l'utente.
- Il collegamento privato di Azure consente di collegare in modo sicuro la piattaforma distribuita come servizio (PaaS) di Azure alla rete virtuale usando endpoint privati.
- BYOS (Bring Your Own Storage) di Profiler e Snapshot Debugger offre il controllo completo su:
- Criteri di crittografia dei dati inattivi.
- Criteri di gestione della durata.
- Accesso di rete per tutti i dati associati ad Application Insights Profiler e Snapshot Debugger.
- I livelli di impegno consentono di risparmiare fino al 30% rispetto al prezzo con pagamento in base al consumo. Altrimenti, la fatturazione per l'inserimento dati e la conservazione dati con pagamento in base al consumo in Log Analytics è simile alla fatturazione in Application Insights.
- I dati vengono inseriti più velocemente tramite l'inserimento del flusso di Log Analytics.
Nota
Dopo la migrazione a una risorsa di Application Insights basata sull'area di lavoro, i dati di telemetria di più risorse di Application Insights potrebbero essere archiviati in un'area di lavoro Log Analytics comune. È comunque possibile eseguire il pull dei dati da una risorsa specifica di Application Insights, come descritto nella sezione Informazioni sulle query di log.
Processo di migrazione
Quando si esegue la migrazione a una risorsa basata sull'area di lavoro, non vengono trasferiti dati dalla risorsa di archiviazione classica alla nuova risorsa di archiviazione basata sull'area di lavoro. La scelta di eseguire la migrazione comporta la modifica della posizione in cui vengono scritti nuovi dati in un'area di lavoro Log Analytics e allo stesso tempo mantiene l'accesso ai dati delle risorse classiche.
I dati delle risorse classiche vengono mantenuti e sono soggetti alle impostazioni di conservazione nella risorsa classica di Application Insights. Tutti i nuovi dati inseriti dopo la migrazione sono soggetti alle impostazioni di conservazione dell'area di lavoro Log Analytics associata, che supporta anche impostazioni di conservazione diverse per tipo di dati.
Il processo di migrazione è permanente e non può essere invertito. Dopo aver eseguito la migrazione di una risorsa ad Application Insights basato sull'area di lavoro, la risorsa sarà sempre basata sull'area di lavoro. Dopo la migrazione, è possibile modificare l'area di lavoro di destinazione con la frequenza necessaria.
Se non è necessario eseguire la migrazione di una risorsa esistente e si vuole creare una nuova risorsa di Application Insights basata sull'area di lavoro, vedere la Guida alla creazione di risorse basate sull'area di lavoro.
Nota
Il processo di migrazione non deve introdurre tempi di inattività o riavvii dell'applicazione né modificare la chiave di strumentazione o la stringa di connessione esistente.
Prerequisiti
Un'area di lavoro Log Analytics con la modalità di controllo di accesso impostata sull'impostazione "Usa le autorizzazioni della risorsa o dell'area di lavoro":
- Le risorse di Application Insights basate sull'area di lavoro non sono compatibili con le aree di lavoro con l'impostazione delle autorizzazioni basate sull'area di lavoro dedicate. Per altre informazioni sul controllo di accesso dell'area di lavoro Log Analytics, vedere il materiale sussidiario sulla modalità di controllo di accesso.
- Se non si dispone di un'area di lavoro Log Analytics esistente, vedere la documentazione relativa alla creazione dell'area di lavoro Log Analytics.
L'esportazione continua non è compatibile con le risorse basate sull'area di lavoro e deve essere disabilitata. Al termine della migrazione, è possibile usare le impostazioni di diagnostica per configurare l'archiviazione dei dati in un account di archiviazione o flusso in Hub eventi di Azure.
Attenzione
- Le impostazioni di diagnostica usano uno schema/un formato di esportazione diverso rispetto all'esportazione continua. La migrazione interrompe eventuali integrazioni esistenti con l'Analisi di flusso di Azure.
- L'esportazione delle impostazioni di diagnostica potrebbe aumentare i costi. Per altre informazioni, vedere Esportare la telemetria da Application Insights.
Controllare le impostazioni di conservazione correnti in Impostazioni>Utilizzo e costi stimati>Conservazione dei dati per l'area di lavoro Log Analytics. Questa impostazione influisce sul tempo di archiviazione dei nuovi dati inseriti dopo la migrazione della risorsa di Application Insights.
Nota
- Se attualmente si archiviano i dati di Application Insights oltre i 90 giorni predefiniti e si vuole mantenere questo periodo di conservazione più lungo dopo la migrazione, modificare le impostazioni di conservazione dell'area di lavoro.
- Se è stata selezionata la conservazione dei dati per più di 90 giorni sui dati inseriti nella risorsa classica di Application Insights prima della migrazione, la conservazione dei dati continua a essere fatturata tramite tale risorsa di Application Insights fino a quando i dati superano il periodo di conservazione.
- Se l'impostazione di conservazione per l'istanza di Application Insights è abilitata in Configura>Utilizzo e costi stimati>Conservazione dati, usare questa impostazione per controllare i giorni di conservazione per i dati di telemetria ancora salvati nell'archiviazione della risorsa classica.
Informazioni sull'utilizzo e sui costi di Application Insights basato sull'area di lavoro.
Trovare le risorse classiche di Application Insights
Per trovare le risorse classiche di Application Insights all'interno della sottoscrizione, è possibile usare i metodi seguenti:
Risorsa di Application Insights nel portale di Azure
Nella Panoramica di una risorsa di Application Insights, le risorse classiche di Application Insights non hanno un'area di lavoro collegata e viene visualizzato il banner di avviso di ritiro di Application Insights classico. Le risorse basate sull'area di lavoro hanno un'area di lavoro collegata all'interno della sezione Panoramica
Risorse basate sull'area di lavoro:
Azure Resource Graph
È possibile usare Azure Resource Graph (ARG) Explorer ed eseguire una query nella tabella 'resources' per eseguire il pull di queste informazioni:
resources
| where subscriptionId == 'Replace with your own subscription ID'
| where type contains 'microsoft.insights/components'
| distinct resourceGroup, name, tostring(properties['IngestionMode']), tostring(properties['WorkspaceResourceId'])
Nota
Le risorse classiche sono identificate da valori 'ApplicationInsights', 'N/A' o Empty.
Interfaccia della riga di comando di Azure:
Eseguire lo script seguente da Cloud Shell nel portale in cui l'autenticazione è incorporata o in qualsiasi altra posizione dopo l'autenticazione tramite az login
:
$resources = az resource list --resource-type 'microsoft.insights/components' | ConvertFrom-Json
$resources | Sort-Object -Property Name | Format-Table -Property @{Label="App Insights Resource"; Expression={$_.name}; width = 35}, @{Label="Ingestion Mode"; Expression={$mode = az resource show --name $_.name --resource-group $_.resourceGroup --resource-type microsoft.insights/components --query "properties.IngestionMode" -o tsv; $mode}; width = 45}
Nota
Le risorse classiche sono identificate da valori 'ApplicationInsights', 'N/A' o Empty. Lo script di PowerShell seguente può essere eseguito dall'interfaccia della riga di comando di Azure:
$subscription = "SUBSCRIPTION ID GOES HERE"
$token = (Get-AZAccessToken).Token
$header = @{Authorization = "Bearer $token"}
$uri = "https://management.azure.com/subscriptions/$subscription/providers/Microsoft.Insights/components?api-version=2015-05-01"
$RestResult=""
$RestResult = Invoke-RestMethod -Method GET -Uri $uri -Headers $header -ContentType "application/json" -ErrorAction Stop -Verbose
$list=@()
$ClassicList=@()
foreach ($app in $RestResult.value)
{
#"processing: " + $app.properties.WorkspaceResourceId ## Classic Application Insights do not have a workspace.
if ($app.properties.WorkspaceResourceId)
{
$Obj = New-Object -TypeName PSObject
#$app.properties.WorkspaceResourceId
$Obj | Add-Member -Type NoteProperty -Name Name -Value $app.name
$Obj | Add-Member -Type NoteProperty -Name WorkspaceResourceId -Value $app.properties.WorkspaceResourceId
$list += $Obj
}
else
{
$Obj = New-Object -TypeName PSObject
$app.properties.WorkspaceResourceId
$Obj | Add-Member -Type NoteProperty -Name Name -Value $app.name
$ClassicList += $Obj
}
}
$list |Format-Table -Property Name, WorkspaceResourceId -Wrap
"";"Classic:"
$ClassicList | FT
Eseguire la migrazione della risorsa
Per eseguire la migrazione di una risorsa di Application Insights classica a una risorsa basata sull'area di lavoro:
Dalla risorsa di Application Insights selezionare "Proprietà" sotto l'intestazione "Configura" nel menu a sinistra.
Selezionare Esegui la migrazione alla modalità basata su area di lavoro.
Selezionare l'area di lavoro Log Analytics in cui archiviare tutti gli Application Insights Telemetry inseriti in futuro. Può trattarsi di un'area di lavoro Log Analytics nella stessa sottoscrizione o in una sottoscrizione diversa che condivide lo stesso tenant di Microsoft Entra. L'area di lavoro Log Analytics non deve trovarsi nello stesso gruppo di risorse della risorsa di Application Insights.
Nota
La migrazione a una risorsa basata sull'area di lavoro può richiedere fino a 24 ore, ma il processo è in genere più veloce. Fare affidamento sull'accesso ai dati tramite la risorsa di Application Insights mentre si attende il completamento del processo di migrazione. Al termine, verranno visualizzati nuovi dati archiviati nelle tabelle dell'area di lavoro Log Analytics.
Dopo la migrazione della risorsa, verranno visualizzate le informazioni corrispondenti sull'area di lavoro nel riquadro Panoramica.
Selezionando il testo del collegamento in blu viene visualizzata l'area di lavoro Log Analytics associata in cui è possibile sfruttare il nuovo ambiente di query unificato dell'area di lavoro.
Suggerimento
Dopo la migrazione a una risorsa di Application Insights basata sull'area di lavoro, usare il limite giornaliero dell'area di lavoro per limitare l'inserimento e i costi anziché il limite in Application Insights.
Informazioni sulle query di log
È disponibile la completa compatibilità con le versioni precedenti per le query, le cartelle di lavoro e gli avvisi basati su log delle risorse classiche di Application Insights all'interno dell'esperienza di Application Insights.
Per scrivere query sulla nuova struttura o schema di tabella basati sull'area di lavoro è prima necessario passare all'area di lavoro Log Analytics.
Per assicurarsi che le query vengano eseguite correttamente, verificare che i campi della query siano in linea con i nuovi campi dello schema.
Potrebbero essere presenti più risorse di Application Insights che archiviano i dati di telemetria in un'area di lavoro Log Analytics, ma si vogliono eseguire query sui dati da una risorsa specifica di Application Insights. è possibile procedere in due modi:
- Passare alla risorsa di Application Insights e selezionare la scheda Log. Tutte le query da questa scheda eseguono automaticamente il pull dei dati dalla risorsa di Application Insights selezionata.
- Passare all'area di lavoro Log Analytics configurata come destinazione per gli Application Insights Telemetry e selezionare la scheda Log. Per eseguire query sui dati da una risorsa specifica di Application Insights, filtrare la proprietà predefinita
_ResourceId
disponibile in tutte le tabelle specifiche dell'applicazione.
Quando si esegue una query direttamente dall'area di lavoro Log Analytics, vengono visualizzati solo i dati inseriti dopo la migrazione. Per visualizzare sia i dati classici di Application Insights che i nuovi dati inseriti dopo la migrazione in un'esperienza di query unificata, usare la scheda Log dall'interno della risorsa di Application Insights migrata.
Nota
Se si rinomina la risorsa di Application Insights dopo la migrazione al modello basato sull'area di lavoro, la scheda Log di Application Insights non visualizza più i dati di telemetria raccolti prima della ridenominazione. È possibile visualizzare tutti i dati precedenti e nuovi nella scheda Log della risorsa di Log Analytics associata.
Identificazione delle risorse di Application Insights in base al tipo di inserimento
Usare lo script seguente per identificare le risorse di Application Insights in base al tipo di inserimento.
Esempio
Get-AzApplicationInsights -SubscriptionId 'Your Subscription ID' | Format-Table -Property Name, IngestionMode, Id, @{label='Type';expression={
if ([string]::IsNullOrEmpty($_.IngestionMode)) {
'Unknown'
} elseif ($_.IngestionMode -eq 'LogAnalytics') {
'Workspace-based'
} elseif ($_.IngestionMode -eq 'ApplicationInsights' -or $_.IngestionMode -eq 'ApplicationInsightsWithDiagnosticSettings') {
'Classic'
} else {
'Unknown'
}
}}
Migrazione programmatica di risorse
Questa sezione consente di eseguire la migrazione delle risorse.
Interfaccia della riga di comando di Azure
Per accedere all'anteprima dell'interfaccia della riga di comando di Azure di Application Insights, è prima necessario eseguire:
az extension add -n application-insights
Se non si esegue il comando az extension add
, viene visualizzato un messaggio di errore che indica az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.
A questo punto è possibile eseguire il codice seguente per creare la risorsa di Application Insights:
az monitor app-insights component update --app
--resource-group
[--ingestion-access {Disabled, Enabled}]
[--kind]
[--query-access {Disabled, Enabled}]
[--retention-time]
[--workspace]
Esempio
az monitor app-insights component update --app your-app-insights-resource-name -g your_resource_group --workspace "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"
Per informazioni dettagliate su questo comando, vedere la documentazione dell'interfaccia della riga di comando di Azure.
Azure PowerShell
A partire dalla versione 8.0 o successiva di Azure PowerShell, è possibile usare il comando Update-AzApplicationInsights
PowerShell per eseguire la migrazione di una risorsa classica di Application Insights all'area di lavoro.
Per usare questo cmdlet, è necessario specificare il nome e il gruppo di risorse della risorsa di Application Insights da aggiornare. Usare i parametri IngestionMode
e WorkspaceResoruceId
per eseguire la migrazione dell'istanza classica al modello basato sull'area di lavoro. Per altre informazioni sui parametri e sulla sintassi di questo cmdlet, vedere Update-AzApplicationInsights.
Esempio
# Get the resource ID of the Log Analytics workspace
$workspaceResourceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName "rgName" -Name "laName").ResourceId
# Update the Application Insights resource with the workspace parameter
Update-AzApplicationInsights -Name "aiName" -ResourceGroupName "rgName" -IngestionMode LogAnalytics -WorkspaceResourceId $workspaceResourceId
Modelli di Gestione risorse di Azure
In questa sezione vengono forniti i modelli.
Attenzione
Assicurarsi di aver rimosso tutte le impostazioni di esportazione continua dalla risorsa prima di eseguire i modelli di migrazione. Vedere Prerequisiti
File del modello
{
"$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"regionId": {
"type": "string"
},
"tagsArray": {
"type": "object"
},
"requestSource": {
"type": "string"
},
"workspaceResourceId": {
"type": "string"
}
},
"resources": [
{
"name": "[parameters('name')]",
"type": "microsoft.insights/components",
"location": "[parameters('regionId')]",
"tags": "[parameters('tagsArray')]",
"apiVersion": "2020-02-02-preview",
"properties": {
"ApplicationId": "[parameters('name')]",
"Application_Type": "[parameters('type')]",
"Flow_Type": "Redfield",
"Request_Source": "[parameters('requestSource')]",
"WorkspaceResourceId": "[parameters('workspaceResourceId')]"
}
}
]
}
File dei parametri
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"type": {
"value": "web"
},
"name": {
"value": "customresourcename"
},
"regionId": {
"value": "eastus"
},
"tagsArray": {
"value": {}
},
"requestSource": {
"value": "Custom"
},
"workspaceResourceId": {
"value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my_resource_group/providers/microsoft.operationalinsights/workspaces/myworkspacename"
}
}
}
Modificare l'area di lavoro associata
Dopo aver creato una risorsa di Application Insights basata sull'area di lavoro, è possibile modificare l'area di lavoro Log Analytics associata.
Dal riquadro della risorsa di Application Insights selezionare Proprietà>Cambia l'area di lavoro>Aree di lavoro di Log Analytics.
Domande frequenti
Questa sezione fornisce le risposte alle domande comuni.
Cosa accade se non si esegue la migrazione della risorsa classica di Application Insights a una risorsa basata sull'area di lavoro?
Microsoft ha iniziato un processo graduale di migrazione dalle risorse classiche alle risorse basate sull'area di lavoro dal maggio 2024 e questa migrazione sarà in corso per diversi mesi. Non è possibile fornire date approssimative in cui verrà eseguita la migrazione di risorse, sottoscrizioni o aree specifiche.
È consigliabile eseguire la migrazione manuale alle risorse basate sull'area di lavoro. Questo processo viene avviato selezionando il banner di avviso di ritiro. È possibile trovarlo nel riquadro Panoramica della risorsa classica di Application Insights nel portale di Azure. Questo processo prevede in genere un unico passaggio per scegliere l'area di lavoro Log Analytics usata per archiviare i dati dell'applicazione. Se si usa l'esportazione continua, è necessario eseguire anche la migrazione alle impostazioni di diagnostica o disabilitare prima la funzionalità.
Se si preferisce che non venga eseguita la migrazione automatica della risorsa classica a una risorsa basata sull'area di lavoro, è possibile eliminarla o eseguire manualmente la migrazione della risorsa.
La migrazione ha implicazioni sui costi?
In genere non c'è differenza, con due eccezioni.
- Le risorse di Application Insights che ricevono gratuitamente 1 GB al mese tramite il modello di prezzi legacy di Application Insights non riceveranno i dati gratuiti.
- Le risorse di Application Insights che erano incluse nel piano tariffario di base prima di aprile 2018 continueranno a essere fatturate allo stesso punto di prezzo non a livello di area applicato prima di aprile 2018. Le risorse di Application Insights create in una data successiva o le risorse convertite al modello basato sull'area di lavoro riceveranno i prezzi correnti a livello di area. Per i prezzi correnti nella valuta e nell'area locali, consultare Prezzi di Application Insights.
La migrazione ad Application Insights basato sull'area di lavoro offre molte opzioni per ottimizzare ulteriormente i costi, inclusi i livelli di impegno di Log Analytics, i cluster dedicati e i log di base e ausiliari.
Come funzionerà il limite di telemetria?
È possibile impostare un limite giornaliero nell'area di lavoro di Log Analytics.
Non è disponibile un limite di fatturazione rigido.
Come funzionerà il campionamento basato sull'inserimento?
Non sono state apportate modifiche al campionamento basato sull'inserimento.
Sono presenti lacune nei dati raccolti durante la migrazione?
No. I dati vengono uniti durante la query.
Le query di log precedenti continuano a funzionare?
Sì, continuano a funzionare.
I dashboard con i grafici delle metriche e dei log aggiunti continueranno a funzionare dopo la migrazione?
Sì, continuano a funzionare.
La migrazione influisce sull'API AppInsights che accede ai dati?
No. La migrazione non influisce sull'accesso dell'API esistente ai dati. Dopo la migrazione, è possibile accedere ai dati direttamente da un'area di lavoro usando uno schema leggermente diverso.
C'è un impatto sulle metriche live o su altre esperienze di monitoraggio?
No. Non c'è alcun impatto sulle metriche live né su altre esperienze di monitoraggio.
Cosa accade con l'esportazione continua dopo la migrazione?
Per continuare con le esportazioni automatizzate, è necessario eseguire la migrazione alle impostazioni di diagnostica prima della migrazione alla risorsa basata sull'area di lavoro. L'impostazione di diagnostica viene mantenuta nella migrazione ad Application Insights basato sull'area di lavoro.
Come si garantisce una migrazione corretta della risorsa di App Insights usando Terraform?
Se si usa Terraform per gestire le risorse di Azure, è importante usare la versione più recente del provider AzureRM Terraform prima di tentare di aggiornare la risorsa di App Insights. L'uso di una versione precedente del provider, ad esempio la versione 3.12, può comportare l'eliminazione della risorsa classica prima che venga creata quella sostitutiva di Application Insights basata sull'area di lavoro. Ciò può causare la perdita di dati precedenti e può richiedere l'aggiornamento delle configurazioni nelle app monitorate con nuovi valori di stringa di connessione e chiave di strumentazione.
Per evitare questo problema, assicurarsi di usare la versione più recente del provider AzureRM Terraform, versione 3.89 o successiva. In questo modo, vengono eseguiti i passaggi di migrazione adeguati inviando la chiamata di Azure Resource Manager (ARM) appropriata per aggiornare la risorsa classica di App Insights a una risorsa basata sull'area di lavoro, mantenendo al tempo stesso tutti i dati precedenti e i valori di stringa di connessione/chiave di strumentazione.
È comunque possibile usare l'API precedente per creare risorse di Application Insights a livello di codice?
Per garantire la compatibilità con le versioni precedenti, le chiamate all'API precedente per la creazione di risorse di Application Insights continuano a funzionare. Ognuna di queste chiamate crea sia una risorsa di Application Insights basata sull'area di lavoro che un'area di lavoro Log Analytics per archiviare i dati.
È consigliabile eseguire l'aggiornamento alla nuova API per un migliore controllo sulla creazione di risorse.
È consigliabile eseguire la migrazione delle impostazioni di diagnostica in Application Insights classico prima di passare a un'intelligenza artificiale basata sull'area di lavoro?
Sì, è consigliabile eseguire la migrazione delle impostazioni di diagnostica nelle risorse classiche di Application Insights prima di passare ad Application Insights basato sull'area di lavoro. Ciò garantisce la continuità e la compatibilità delle impostazioni di diagnostica.
Risoluzione dei problemi
In questa sezione vengono forniti suggerimenti per la risoluzione dei problemi.
Modalità di accesso
Messaggio di errore: "L'area di lavoro selezionata è configurata con la modalità di accesso basata sull'area di lavoro. Alcune funzionalità di monitoraggio delle prestazioni applicative (APM) possono risentirne. Selezionare un'altra area di lavoro o consentire l'accesso basato sulle risorse nelle impostazioni dell'area di lavoro. È possibile eseguire l'override di questo errore usando l'interfaccia della riga di comando".
Affinché la risorsa di Application Insights basata sull'area di lavoro funzioni correttamente, è necessario modificare la modalità di controllo di accesso dell'area di lavoro Log Analytics di destinazione impostando Autorizzazioni della risorsa o dell'area di lavoro. Questa impostazione si trova nell'interfaccia utente dell'area di lavoro Log Analytics in Proprietà>Modalità di controllo di accesso. Per istruzioni, vedere le linee guida per configurare la modalità di controllo di accesso in Log Analytics. Se la modalità di controllo di accesso è impostata sull'impostazione esclusiva Richiedi autorizzazioni dell'area di lavoro, la migrazione tramite l'esperienza del portale rimane bloccata.
Se non è possibile modificare la modalità di controllo di accesso per motivi di sicurezza per l'area di lavoro di destinazione corrente, creare una nuova area di lavoro Log Analytics da usare per la migrazione.
Esportazione continua
Messaggio di errore: "L'esportazione continua deve essere disabilitata prima di continuare. Dopo la migrazione, usare le impostazioni di diagnostica per l'esportazione".
La funzionalità di esportazione continua legacy non è supportata per le risorse basate sull'area di lavoro. Prima di eseguire la migrazione, è necessario abilitare le impostazioni di diagnostica e disabilitare l'esportazione continua.
Abilitare le impostazioni di diagnostica nella risorsa classica di Application Insights.
Nella visualizzazione delle risorse di Application Insights, sotto l'intestazione "Configura", selezionare "Esportazione continua".
Seleziona Disabilita.
Dopo aver selezionato Disabilita, è possibile tornare all'interfaccia utente di migrazione. Se la pagina Modifica esportazione continua richiede che le impostazioni non vengano salvate, selezionare OK. Questa richiesta non riguarda la disabilitazione o l'abilitazione dell'esportazione continua.
Dopo la migrazione della risorsa di Application Insights, è possibile usare le impostazioni di diagnostica per sostituire la funzionalità fornita in precedenza dall'esportazione continua. Selezionare Impostazioni di diagnostica> Aggiungi impostazione di diagnostica nella risorsa di Application Insights. È possibile selezionare tutte le tabelle o un subset di tabelle da archiviare in un account di archiviazione o di cui eseguire lo streaming in Hub eventi di Azure. Per altre informazioni sulle impostazioni di diagnostica, vedere il materiale sussidiario sulle impostazioni di diagnostica di Monitoraggio di Azure.
Impostazioni di conservazione
Messaggio di avviso: "Le impostazioni di conservazione personalizzate di Application Insights non si applicano ai dati inviati all'area di lavoro. È necessario riconfigurarle separatamente".
Non è necessario apportare modifiche prima della migrazione. Questo messaggio avvisa che le impostazioni di conservazione correnti di Application Insights non sono impostate sul periodo di conservazione predefinito di 90 giorni. Questo messaggio di avviso indica che potrebbe essere necessario modificare le impostazioni di conservazione per l'area di lavoro Log Analytics prima di eseguire la migrazione e iniziare a inserire nuovi dati.
È possibile controllare le impostazioni di conservazione correnti per Log Analytics in Impostazioni>Utilizzo e costi stimati>Conservazione dei dati nell'interfaccia utente di Log Analytics. Questa impostazione influisce sul tempo di archiviazione dei nuovi dati inseriti dopo la migrazione della risorsa di Application Insights.
Modifiche alle risorse basate sull'area di lavoro
Prima dell'introduzione delle risorse di Application Insights basate sull'area di lavoro, i dati di Application Insights venivano archiviati separatamente da altri dati di log in Monitoraggio di Azure. Entrambi si basano su Esplora dati di Azure e usano lo stesso linguaggio di query Kusto (KQL). I dati delle risorse di Application Insights basate sull'area di lavoro vengono archiviati in un'area di lavoro Log Analytics, insieme ad altri dati di monitoraggio e dati applicazione. Questa disposizione semplifica la configurazione. È possibile analizzare i dati in più soluzioni più facilmente e usare le funzionalità delle aree di lavoro.
Struttura dei dati classica
La struttura di un'area di lavoro Log Analytics è descritta in Panoramica dell'area di lavoro Log Analytics. Per un'applicazione classica, i dati non vengono archiviati in un'area di lavoro Log Analytics. Usa lo stesso linguaggio di query. Le query vengono create ed eseguite usando lo stesso strumento di Log Analytics nel portale di Azure. Gli elementi di dati per le applicazioni classiche vengono archiviati separatamente l'uno dall'altro. La struttura generale è identica a quella delle applicazioni basate sull'area di lavoro, anche se i nomi di tabella e colonna sono diversi.
Nota
L'esperienza classica di Application Insights include la compatibilità con le versioni precedenti per le query, le cartelle di lavoro e gli avvisi basati su log delle risorse. Per eseguire query o visualizzare la nuova struttura o schema di tabella basati sull'area di lavoro, passare prima all'area di lavoro Log Analytics. Durante l'anteprima, selezionare Log nel riquadro di Application Insights per accedere all'esperienza di query classica di Application Insights. Per altre informazioni, vedere Ambito query.
Struttura della tabella
Nome tabella legacy | Nuovo nome tabella | Descrizione |
---|---|---|
availabilityResults | AppAvailabilityResults | Dati di riepilogo da test di disponibilità. |
browserTimings | AppBrowserTimings | Dati sulle prestazioni del client, ad esempio il tempo impiegato per elaborare i dati in ingresso. |
dipendenze | AppDependencies | Chiamate dall'applicazione ad altri componenti (inclusi i componenti esterni) registrate tramite TrackDependency() . Gli esempi sono chiamate all'API REST o al database o a un file system. |
customEvents | AppEvents | Eventi personalizzati creati dall'applicazione. |
customMetrics | AppMetrics | Metriche personalizzate create dall'applicazione. |
pageViews | AppPageViews | Dati relativi a ogni visualizzazione del sito Web con le informazioni del browser. |
performanceCounters | AppPerformanceCounters | Misurazioni delle prestazioni dalle risorse di calcolo che supportano l'applicazione. Un esempio è rappresentato dai contatori delle prestazioni di Windows. |
requests | AppRequests | Richieste ricevute dall'applicazione. Ad esempio, viene registrato un record di richiesta separato per ogni richiesta HTTP ricevuta dall'app Web. |
exceptions | AppExceptions | Eccezioni generate da Application Runtime. Acquisisce le eccezioni lato server e lato client (browser). |
traces | AppTraces | Log dettagliati (traces) emessi tramite codice dell'applicazione/framework di registrazione registrati tramite TrackTrace() . |
Attenzione
Attendere nuovi dati di telemetria in Log Analytics prima di basarsi su di essi. Dopo aver avviato la migrazione, i dati di telemetria passano prima ad Application Insights classico. L'inserimento dei dati di telemetria passa a Log Analytics entro 24 ore. Al termine, Log Analytics acquisisce esclusivamente nuovi dati di telemetria.
Schemi di tabella
Le sezioni seguenti illustrano il mapping tra i nomi delle proprietà classiche e i nuovi nomi delle proprietà di Application Insights basate sull'area di lavoro. Usare queste informazioni per convertire qualsiasi query usando le tabelle legacy.
La maggior parte delle colonne ha lo stesso nome con maiuscole e minuscole diverse. KQL fa distinzione tra maiuscole e minuscole, pertanto è necessario modificare ogni nome di colonna insieme ai nomi delle tabelle nelle query esistenti. Le colonne con altre modifiche oltre a quelle relative a maiuscole/minuscole sono evidenziate. È comunque possibile usare le query classiche di Application Insights all'interno del riquadro Log della risorsa di Application Insights, anche se si tratta di una risorsa basata sull'area di lavoro. I nuovi nomi di proprietà sono necessari quando si esegue una query dall'interno del contesto dell'esperienza dell'area di lavoro Log Analytics.
AppAvailabilityResults
Tabella legacy: availabilityResults
ApplicationInsights | Type | LogAnalytics | Type |
---|---|---|---|
IDapp | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (rimosso) | |
client_Browser | string | ClientBrowser | string |
client_City | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dynamic | Proprietà | Dinamico |
customMeasurements | dynamic | Misure | Dinamico |
duration | real | DurationMs | real |
id |
string | Id |
string |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (rimosso) | |
itemType | string | Type | String |
location | string | Ufficio | string |
messaggio | string | Message | string |
name | string | Nome | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
performanceBucket | string | PerformanceBucket | string |
sdkVersion | string | VersioneSDK | string |
session_Id | string | SessionId | string |
size | real | Dimensione | real |
esito positivo | string | Success | Bool |
timestamp | datetime | TimeGenerated | datetime |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | ID utente | string |
AppBrowserTimings
Tabella legacy: browserTimings
ApplicationInsights | Type | LogAnalytics | Type |
---|---|---|---|
IDapp | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (rimosso) | |
client_Browser | string | ClientBrowser | string |
client_City | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dynamic | Proprietà | Dinamico |
customMeasurements | dynamic | Misure | Dinamico |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (rimosso) | |
itemType | string | Type | string |
name | string | Nome | datetime |
networkDuration | real | NetworkDurationMs | real |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
performanceBucket | string | PerformanceBucket | string |
processingDuration | real | ProcessingDurationMs | real |
receiveDuration | real | ReceiveDurationMs | real |
sdkVersion | string | VersioneSDK | string |
sendDuration | real | SendDurationMs | real |
session_Id | string | SessionId | string |
timestamp | datetime | TimeGenerated | datetime |
totalDuration | real | TotalDurationMs | real |
URL. | string | Url | string |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | ID utente | string |
AppDependencies
Tabella legacy: dipendenze
ApplicationInsights | Type | LogAnalytics | Type |
---|---|---|---|
IDapp | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (rimosso) | |
client_Browser | string | ClientBrowser | string |
client_City | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dynamic | Proprietà | Dinamico |
customMeasurements | dynamic | Misure | Dinamico |
data | string | Dati | string |
duration | real | DurationMs | real |
id |
string | Id |
string |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (rimosso) | |
itemType | string | Type | String |
name | string | Nome | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
performanceBucket | string | PerformanceBucket | string |
resultCode | string | ResultCode | string |
sdkVersion | string | VersioneSDK | string |
session_Id | string | SessionId | string |
esito positivo | string | Success | Bool |
bersaglio | string | Destinazione | string |
timestamp | datetime | TimeGenerated | datetime |
type | string | DependencyType | string |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | ID utente | string |
AppEvents
Tabella legacy: customEvents
ApplicationInsights | Type | LogAnalytics | Type |
---|---|---|---|
IDapp | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (rimosso) | |
client_Browser | string | ClientBrowser | string |
client_City | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dynamic | Proprietà | Dinamico |
customMeasurements | dynamic | Misure | Dinamico |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (rimosso) | |
itemType | string | Type | string |
name | string | Nome | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
sdkVersion | string | VersioneSDK | string |
session_Id | string | SessionId | string |
timestamp | datetime | TimeGenerated | datetime |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | ID utente | string |
AppMetrics
Tabella legacy: customMetrics
ApplicationInsights | Type | LogAnalytics | Type |
---|---|---|---|
IDapp | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (rimosso) | |
client_Browser | string | ClientBrowser | string |
client_City | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dynamic | Proprietà | Dinamico |
iKey |
string | IKey |
string |
itemId | string | (rimosso) | |
itemType | string | Type | string |
name | string | Nome | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
sdkVersion | string | VersioneSDK | string |
session_Id | string | SessionId | string |
timestamp | datetime | TimeGenerated | datetime |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | ID utente | string |
value | real | (rimosso) | |
valueCount | int | ItemCount | int |
valueMax | real | Max | real |
valueMin | real | Min | real |
valueSum | real | Sum | real |
valueStdDev | real | (rimosso) |
Nota
Le versioni precedenti degli SDK di Application Insights vengono usate per segnalare la deviazione standard (valueStdDev
) nelle metriche pre-aggregazione. Poiché l'adozione nell'analisi delle metriche era leggera, il campo è stato rimosso e non è più aggregato in base agli SDK. Se il valore viene ricevuto dall'endpoint di raccolta dati di Application Insights, questo viene eliminato durante l'inserimento e non viene inviato all'area di lavoro Log Analytics. Se si vuole usare la deviazione standard nell'analisi, usare query sugli eventi non elaborati di Application Insights.
AppPageViews
Tabella legacy: pageViews
ApplicationInsights | Type | LogAnalytics | Type |
---|---|---|---|
IDapp | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (rimosso) | |
client_Browser | string | ClientBrowser | string |
client_City | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dynamic | Proprietà | Dinamico |
customMeasurements | dynamic | Misure | Dinamico |
duration | real | DurationMs | real |
id |
string | Id |
string |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (rimosso) | |
itemType | string | Type | String |
name | string | Nome | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
performanceBucket | string | PerformanceBucket | string |
sdkVersion | string | VersioneSDK | string |
session_Id | string | SessionId | string |
timestamp | datetime | TimeGenerated | datetime |
URL. | string | Url | string |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | ID utente | string |
AppPerformanceCounters
Tabella legacy: performanceCounters
ApplicationInsights | Type | LogAnalytics | Type |
---|---|---|---|
IDapp | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (rimosso) | |
category | string | Categoria | string |
client_Browser | string | ClientBrowser | string |
client_City | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
counter | string | (rimosso) | |
customDimensions | dynamic | Proprietà | Dinamico |
iKey |
string | IKey |
string |
instance | string | Istanza | string |
itemId | string | (rimosso) | |
itemType | string | Type | string |
name | string | Nome | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
sdkVersion | string | VersioneSDK | string |
session_Id | string | SessionId | string |
timestamp | datetime | TimeGenerated | datetime |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | ID utente | string |
value | real | Valore | real |
AppRequests
Tabella legacy: richieste
ApplicationInsights | Type | LogAnalytics | Type |
---|---|---|---|
IDapp | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (rimosso) | |
client_Browser | string | ClientBrowser | string |
client_City | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dynamic | Proprietà | Dinamico |
customMeasurements | dynamic | Misure | Dinamico |
duration | real | DurationMs | Reale |
id |
string | Id |
String |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (rimosso) | |
itemType | string | Type | String |
name | string | Nome | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
performanceBucket | string | PerformanceBucket | String |
resultCode | string | ResultCode | String |
sdkVersion | string | VersioneSDK | string |
session_Id | string | SessionId | string |
source | string | Origine | String |
esito positivo | string | Success | Bool |
timestamp | datetime | TimeGenerated | datetime |
URL. | string | Url | String |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | ID utente | string |
AppExceptions
Tabella legacy: eccezioni
ApplicationInsights | Type | LogAnalytics | Type |
---|---|---|---|
IDapp | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (rimosso) | |
assembly | string | Assemblaggio | string |
client_Browser | string | ClientBrowser | string |
client_City | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dynamic | Proprietà | dynamic |
customMeasurements | dynamic | Misure | dynamic |
dettagli | dynamic | Dettagli | dynamic |
handledAt | string | HandledAt | string |
iKey |
string | IKey |
string |
innermostAssembly | string | InnermostAssembly | string |
innermostMessage | string | InnermostMessage | string |
innermostMethod | string | InnermostMethod | string |
innermostType | string | InnermostType | string |
itemCount | int | ItemCount | int |
itemId | string | (rimosso) | |
itemType | string | Type | string |
messaggio | string | Message | string |
metodo | string | metodo | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
outerAssembly | string | OuterAssembly | string |
outerMessage | string | OuterMessage | string |
outerMethod | string | OuterMethod | string |
outerType | string | OuterType | string |
problemId | string | ProblemId | string |
sdkVersion | string | VersioneSDK | string |
session_Id | string | SessionId | string |
SeverityLevel | int | SeverityLevel | int |
timestamp | datetime | TimeGenerated | datetime |
type | string | ExceptionType | string |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | ID utente | string |
AppTraces
Tabella legacy: tracce
ApplicationInsights | Type | LogAnalytics | Type |
---|---|---|---|
IDapp | string | ResourceGUID | string |
application_Version | string | AppVersion | string |
appName | string | (rimosso) | |
client_Browser | string | ClientBrowser | string |
client_City | string | ClientCity | string |
client_CountryOrRegion | string | ClientCountryOrRegion | string |
client_IP | string | ClientIP | string |
client_Model | string | ClientModel | string |
client_OS | string | ClientOS | string |
client_StateOrProvince | string | ClientStateOrProvince | string |
client_Type | string | ClientType | string |
cloud_RoleInstance | string | AppRoleInstance | string |
cloud_RoleName | string | AppRoleName | string |
customDimensions | dynamic | Proprietà | dynamic |
customMeasurements | dynamic | Misure | dynamic |
iKey |
string | IKey |
string |
itemCount | int | ItemCount | int |
itemId | string | (rimosso) | |
itemType | string | Type | string |
messaggio | string | Message | string |
operation_Id | string | OperationId | string |
operation_Name | string | OperationName | string |
operation_ParentId | string | ParentId | string |
operation_SyntheticSource | string | SyntheticSource | string |
sdkVersion | string | VersioneSDK | string |
session_Id | string | SessionId | string |
SeverityLevel | int | SeverityLevel | int |
timestamp | datetime | TimeGenerated | datetime |
user_AccountId | string | UserAccountId | string |
user_AuthenticatedId | string | UserAuthenticatedId | string |
user_Id | string | ID utente | string |