Condividi tramite


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:

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":

  • 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

Risorsa classica: Screenshot della pagina di panoramica del portale di Application Insights classico.

Risorse basate sull'area di lavoro: Screenshot della pagina di panoramica del portale di Application Insights basato 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:

  1. Dalla risorsa di Application Insights selezionare "Proprietà" sotto l'intestazione "Configura" nel menu a sinistra.

    Screenshot che mostra le proprietà sotto l'intestazione Configurato.

  2. Selezionare Esegui la migrazione alla modalità basata su area di lavoro.

    Screenshot che mostra il pulsante Esegui la migrazione alla modalità basata su area di lavoro.

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

    Screenshot che mostra l'interfaccia utente della Migrazione guidata con l'opzione per selezionare l'area di lavoro di destinazione.

    Dopo la migrazione della risorsa, verranno visualizzate le informazioni corrispondenti sull'area di lavoro nel riquadro Panoramica.

    Screenshot che mostra il nome dell'area di lavoro.

    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.

  1. Abilitare le impostazioni di diagnostica nella risorsa classica di Application Insights.

  2. Nella visualizzazione delle risorse di Application Insights, sotto l'intestazione "Configura", selezionare "Esportazione continua".

    Screenshot che mostra la voce di menu Esportazione continua.

  3. Seleziona Disabilita.

    Screenshot che mostra il pulsante Disabilita per l'esportazione continua.

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

Diagramma che mostra la struttura log di Monitoraggio di Azure per Application Insights.

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