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 dati di telemetria di Application Insights a un'area di lavoro Log Analytics comune.
- Consente di accedere alle funzionalità più recenti di Monitoraggio di Azure mantenendo i log delle applicazioni, dell'infrastruttura e della piattaforma in una posizione consolidata.
- Abilitare il controllo comune degli accessi in base al ruolo di Azure 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.
Importante
Il 29 febbraio 2024, l'esportazione continua è stata ritirata come parte del ritiro della risorsa classica di Application Insights.
Le risorse di Application Insights basate sull'area di lavoro non sono compatibili con l'esportazione continua. È consigliabile eseguire la migrazione alle impostazioni di diagnostica nelle risorse classiche di Application Insights prima della transizione ad Application Insights basato sull'area di lavoro. In questo modo si garantisce la continuità e la compatibilità delle impostazioni di diagnostica.
L'esportazione delle impostazioni di diagnostica potrebbe aumentare i costi. Per altre informazioni, vedere Esportazione basata sulle impostazioni di diagnostica.
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 si ha accesso solo.
- collegamento privato di Azure consente di collegare in modo sicuro la piattaforma Azure distribuita come servizio (PaaS) alla rete virtuale usando endpoint privati.
- Bring Your Own Storage (BYOS) per Profiler e Snapshot Debugger offre il controllo completo su:
- Criteri di crittografia inattivi.
- Criteri di gestione della durata.
- Accesso di rete per tutti i dati associati a 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. In caso contrario, la fatturazione per l'inserimento dati con pagamento in base al consumo e la conservazione dei dati in Log Analytics è simile alla fatturazione in Application Insights.
- I dati vengono inseriti più velocemente tramite l'inserimento in streaming 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 basata sull'area di lavoro, sarà sempre una risorsa 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 esistente o stringa di connessione.
Prerequisiti
Un'area di lavoro Log Analytics con la modalità di controllo di accesso impostata sull'impostazione Usa autorizzazioni risorsa o area di lavoro:
- Le risorse di Application Insights basate sull'area di lavoro non sono compatibili con le aree di lavoro impostate sull'impostazione delle autorizzazioni dedicate basate sull'area di lavoro. 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 ha già un'area di lavoro Log Analytics esistente, vedere la documentazione sulla 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 in streaming per 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 per più di 90 giorni predefiniti e si vuole conservare 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 in Configura>utilizzo e costi>stimati è abilitata, 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 basati sull'area di lavoro.
Eseguire la migrazione della risorsa
Per eseguire la migrazione di una risorsa classica di Application Insights a una risorsa basata sull'area di lavoro:
Dalla risorsa di Application Insights selezionare Proprietà sotto l'intestazione Configura nel menu a sinistra.
Selezionare Migrate to Workspace-based (Esegui migrazione all'area di lavoro).
Selezionare l'area di lavoro Log Analytics in cui archiviare tutti i dati di telemetria di Application Insights inseriti in futuro. Può trattarsi di un'area di lavoro Log Analytics nella stessa sottoscrizione o di 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 blu si passa all'area di lavoro Log Analytics associata in cui è possibile sfruttare il nuovo ambiente di query dell'area di lavoro unificata.
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
La compatibilità con le versioni precedenti di Application Insights è completa per le query di risorse classiche, le cartelle di lavoro e gli avvisi basati su log all'interno dell'esperienza di Application Insights.
Per scrivere query sulla nuova struttura/schema di tabella basata 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 allineati ai 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 vuole 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 estraggono automaticamente i dati dalla risorsa di Application Insights selezionata.
- Passare all'area di lavoro Log Analytics configurata come destinazione per i dati di telemetria di Application Insights e selezionare la scheda Log . Per eseguire query sui dati da una risorsa specifica di Application Insights, filtrare la proprietà predefinita
_ResourceIddisponibile 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 i dati classici di Application Insights e 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 az extension add comando, viene visualizzato un messaggio di errore che indica che 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 la documentazione completa dell'interfaccia della riga di comando di Azure per 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 PowerShell per eseguire la Update-AzApplicationInsights 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 IngestionMode parametri e WorkspaceResoruceId per eseguire la migrazione dell'istanza classica all'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 modelli.
Attenzione
Assicurarsi di aver rimosso tutte le impostazioni di esportazione continous 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.
Nel riquadro delle risorse di Application Insights selezionare Proprietà>Cambia area di lavoro Aree di lavoro>Log Analytics.
Domande frequenti
Questa sezione fornisce le risposte alle domande comuni.
Cosa succede se non si esegue la migrazione della risorsa classica di Application Insights a una risorsa basata sull'area di lavoro?
Microsoft inizierà un approccio automatico in più fasi alla migrazione delle risorse classiche verso risorse basate sull'area di lavoro a partire da maggio 2024 e questa migrazione durerà diversi mesi. Non è possibile fornire date indicative in cui verrà eseguita la migrazione di risorse, sottoscrizioni o aree specifiche.
È consigliabile eseguire la migrazione manuale alle risorse basate sull'area di lavoro, che viene avviata selezionando il banner di avviso di ritiro nel riquadro Panoramica delle risorse di Application Insights classico del portale di Azure. Questo processo prevede in genere un unico passaggio per scegliere quale area di lavoro Log Analytics verrà 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 non si vuole eseguire automaticamente la migrazione da una risorsa classica a una risorsa basata sull'area di lavoro, è possibile eliminare la risorsa o eseguire manualmente la migrazione.
C'è qualche implicazione sul costo della migrazione?
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 più i dati gratuiti.
- Le risorse di Application Insights incluse nel piano tariffario basic prima di aprile 2018 continuano a essere fatturate nello stesso punto di prezzo non a livello di area precedente ad aprile 2018. Le risorse di Application Insights create dopo tale data o quelle convertite in base all'area di lavoro riceveranno i prezzi internazionali correnti. Per i prezzi correnti nella valuta e nell'area locali, consultare Prezzi di Application Insights.
La migrazione ad Application Insights basata sull'area di lavoro offre diverse opzioni per ottimizzare ulteriormente i costi, inclusi i livelli di impegno di Log Analytics, i cluster dedicati e i log di base.
Come funzionerà il limite di telemetria?
È possibile impostare un limite giornaliero nell'area di lavoro Log Analytics.
Non è disponibile un limite di fatturazione rigoroso.
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 il tempo di query.
Le query di log precedenti continuano a funzionare?
Sì, continuano a lavorare.
I dashboard che hanno aggiunto grafici metrica e log continueranno a funzionare dopo la migrazione?
Sì, continuano a lavorare.
La migrazione influisce sull'API AppInsights che accede ai dati?
No. La migrazione non influisce sull'accesso all'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 attive o su altre esperienze di monitoraggio?
No. Non c'è alcun impatto sulle metriche attive o 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 di eseguire la migrazione alla risorsa basata sull'area di lavoro. L'impostazione di diagnostica esegue la migrazione ad Application Insights basata sull'area di lavoro.
Ricerca per categorie garantire una corretta migrazione 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 del componente classico prima di creare la risorsa di Application Insights basata sull'area di lavoro sostitutiva. Può causare la perdita di dati precedenti e richiedere l'aggiornamento delle configurazioni nelle app monitorate con nuovi valori di chiave di strumentazione e stringa di connessione.
Per evitare questo problema, assicurarsi di usare la versione più recente del provider Azurerm terraform, versione 3.89 o successiva, che esegue i passaggi di migrazione appropriati eseguendo la chiamata ARM appropriata per aggiornare la risorsa classica di App Insights a una risorsa basata sull'area di lavoro mantenendo tutti i dati precedenti e i valori di chiave di strumentazione e stringa di connessione/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 continueranno a funzionare. Ognuna di queste chiamate creerà una risorsa di Application Insights basata sull'area di lavoro e 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. Garantisce la continuità e la compatibilità delle impostazioni di diagnostica.
Risoluzione dei problemi
Questa sezione offre suggerimenti per la risoluzione dei problemi comuni.
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 Application Monitor prestazioni ing (APM) potrebbero essere interessate. 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 l'impostazione Autorizzazioni risorsa o area di lavoro. Questa impostazione si trova nell'interfaccia utente dell'area di lavoro Log Analytics in Modalità di controllo di accesso proprietà>. 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 di migrazione 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 i 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 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 aver eseguito la migrazione della risorsa di Application Insights all'area di lavoro basata su , è possibile usare le impostazioni di diagnostica per sostituire la funzionalità usata per l'esportazione continua usata per fornire. Selezionare Impostazioni di diagnostica Aggiungi impostazione di>diagnostica nella risorsa di Application Insights. È possibile selezionare tutte le tabelle, o un subset di tabelle, per archiviare in un account di archiviazione o un flusso 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. Sarà necessario riconfigurarli 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 della migrazione e iniziare a inserire nuovi dati.
È possibile controllare le impostazioni di conservazione correnti per Log Analytics in Impostazioni> Usage e i 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 sono stati archiviati separatamente da altri dati di log in Monitoraggio di Azure. Entrambi si basano su Azure Esplora dati e usano lo stesso Linguaggio di query Kusto (KQL). I dati delle risorse di Application Insights basati sull'area di lavoro vengono archiviati in un'area di lavoro Log Analytics, insieme ad altri dati di monitoraggio e alle applicazioni. 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 query di risorse, cartelle di lavoro e avvisi basati su log. Per eseguire query o visualizzare la nuova struttura o schema della tabella basata sull'area di lavoro, passare prima all'area di lavoro Log Analytics. Durante l'anteprima, selezionando Log nel riquadro Application Insights è possibile 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(). 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 dal runtime dell'applicazione. Acquisisce le eccezioni lato server e lato client (browser). |
| traces | AppTraces | Log dettagliati (tracce) generati tramite framework di registrazione/codice dell'applicazione registrati tramite TrackTrace(). |
Attenzione
Attendere nuovi dati di telemetria in Log Analytics prima di basarsi su di esso. Dopo aver avviato la migrazione, i dati di telemetria passano prima ad Application Insights classico. L'inserimento dei dati di telemetria viene passato 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 basati 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 modifiche oltre alle maiuscole 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 |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | 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 |
| duration | real | DurationMs | real |
id |
string | Id |
string |
| iKey | string | Ikey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _Itemid | string |
| itemType | string | Type | String |
| posizione | 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 | OperationSyntheticSource | string |
| performanceBucket | string | PerformanceBucket | string |
| sdkVersion | string | VersioneSDK | string |
| session_Id | string | SessionId | string |
| size | real | Dimensione | real |
| esito positivo | string | Riuscita | 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 |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | 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 |
| iKey | string | Ikey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _Itemid | string |
| 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 | OperationSyntheticSource | 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 |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | 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 |
| data | string | Dati | string |
| duration | real | DurationMs | real |
id |
string | Id |
string |
| iKey | string | Ikey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _Itemid | string |
| 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 | OperationSyntheticSource | string |
| performanceBucket | string | PerformanceBucket | string |
| resultCode | string | ResultCode | string |
| sdkVersion | string | VersioneSDK | string |
| session_Id | string | SessionId | string |
| esito positivo | string | Riuscita | Bool |
| target | 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 |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | 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 |
| iKey | string | Ikey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _Itemid | string |
| 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 | OperationSyntheticSource | 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 |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | 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 |
| iKey | string | Ikey | string |
| itemId | string | _Itemid | string |
| 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 | OperationSyntheticSource | 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 | ValueMax | real |
| valueMin | real | ValueMin | real |
| valueSum | real | ValueSum | real |
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 dagli SDK. Se il valore viene ricevuto dall'endpoint di raccolta dati di Application Insights, 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 |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | 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 |
| duration | real | DurationMs | real |
id |
string | Id |
string |
| iKey | string | Ikey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _Itemid | string |
| 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 | OperationSyntheticSource | 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 |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| 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à | Dynamic |
| iKey | string | Ikey | string |
| instance | string | Istanza | string |
| itemId | string | _Itemid | string |
| 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 | OperationSyntheticSource | 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 |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | 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 |
| duration | real | DurationMs | Reale |
id |
string | Id |
String |
| iKey | string | Ikey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _Itemid | string |
| 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 | OperationSyntheticSource | 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 | Riuscita | 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 |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | string |
| 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 | _Itemid | string |
| 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 | OperationSyntheticSource | 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 |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | _ResourceId | 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 |
| iKey | string | Ikey | string |
| itemCount | int | ItemCount | int |
| itemId | string | _Itemid | string |
| 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 | OperationSyntheticSource | 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 |