Esportazione dei dati dell'area di lavoro Log Analytics in Monitoraggio di Azure

2025-05-15

L'esportazione dei dati in un'area di lavoro di Log Analytics consente di esportare continuamente i dati per ogni tabella selezionata nell'area di lavoro. È possibile eseguire l'esportazione in un account di Archiviazione di Azure o in Hub eventi di Azure man mano che i dati arrivano a una pipeline di Monitoraggio di Azure. Questo articolo fornisce informazioni dettagliate su questa funzionalità e i passaggi per configurare l'esportazione dei dati nelle aree di lavoro.

Informazioni generali

I dati in Log Analytics sono disponibili per il periodo di conservazione definito nell'area di lavoro. Viene usato in varie esperienze fornite in Monitoraggio di Azure e nei servizi di Azure. In alcuni casi è necessario usare altri strumenti:

Conformità dell'archivio protetto da manomissione: i dati non possono essere modificati in Log Analytics dopo l'inserimento, ma possono essere eliminati. Esportare in un account di archiviazione configurato con criteri di immutabilità per mantenere i dati protetti dalle manomissioni.
Integrazione con i servizi di Azure e altri strumenti: esportare in Hub eventi man mano che arrivano i dati e vengono elaborati in Monitoraggio di Azure.
Conservazione a lungo termine dei dati di controllo e sicurezza:esportare in un account di archiviazione nell'area dell'area di lavoro. In alternativa, è possibile replicare i dati in altre aree usando una delle opzioni di ridondanza di Archiviazione di Azure, tra cui Archiviazione con ridondanza geografica e Archiviazione con ridondanza geografica della zona.

Dopo aver configurato le regole di esportazione dei dati in un'area di lavoro di Log Analytics, i nuovi dati per le tabelle nelle regole vengono esportati dalla pipeline di Monitoraggio di Azure all'account di archiviazione o a Hub eventi non appena arrivano. Il traffico di esportazione dei dati si trova nella rete backbone di Azure e non lascia la rete di Azure.

I dati vengono esportati senza un filtro. Ad esempio, quando si configura una regola di esportazione dei dati per una tabella SecurityEvent, tutti i dati inviati alla tabella SecurityEvent vengono esportati a partire dall'ora di configurazione. In alternativa, è possibile filtrare o modificare i dati esportati configurando le trasformazioni nell'area di lavoro, che si applicano ai dati in ingresso, prima dell'invio alle aree di lavoro di Log Analytics e alle destinazioni di esportazione.

Altre opzioni di esportazione

L'esportazione dei dati dell'area di lavoro di Log Analytics esporta continuamente i dati inviati all'area di lavoro di Log Analytics. Esistono altre opzioni per esportare i dati per scenari specifici:

Se una risorsa di Azure invia log all'area di lavoro Log Analytics tramite le impostazioni del log di diagnostica, è consigliabile aggiornare direttamente le impostazioni di diagnostica nella risorsa di Azure per aggiungere la nuova destinazione anziché usare regolarmente un'esportazione dei dati. Questo approccio ha una latenza inferiore rispetto a un'esportazione di dati, ma non invia dati cronologici.
Pianificare un'esportazione dei dati in base a una query di log definita con l'API di query di Log Analytics. Usare Azure Data Factory, Funzioni di Azure o App per la logica di Azure per orchestrare le query nell'area di lavoro ed esportare i dati in una destinazione. Questo metodo è simile alla funzionalità di esportazione dei dati, ma è possibile usarlo per esportare i dati cronologici dall'area di lavoro usando filtri e aggregazioni. Questo metodo è soggetto ai limiti delle query di log e non è destinato alla scalabilità. Per ulteriori informazioni vedere Esportare i dati da un'area di lavoro di Log Analytics a un account di archiviazione usando App per la logica.
Usare un'esportazione una tantum in un computer locale con uno script di PowerShell. Per altre informazioni, vedere Invoke-AzOperationalInsightsQueryExport.

Autorizzazioni necessarie

Azione	Autorizzazioni necessarie
Creare o aggiornare la regola di esportazione dei dati	Le autorizzazioni `Microsoft.OperationalInsights/workspaces/dataexports/write` per l'area di lavoro Log Analytics fornite dal ruolo integrato di Collaboratore Log Analytics, ad esempio
Elimina regola di esportazione dati	Le autorizzazioni `Microsoft.OperationalInsights/workspaces/dataexports/delete` per l'area di lavoro Log Analytics fornite dal ruolo integrato di Collaboratore Log Analytics, ad esempio
Esportare in Account di archiviazione	Autorizzazioni `Microsoft.Storage/storageAccounts/blobServices/containers/write` per l'account di archiviazione fornite dal ruolo predefinito di Collaboratore account di archiviazione, ad esempio
Esportare in Hub eventi	`Microsoft.EventHub/namespaces/eventhubs/write`, `Microsoft.EventHub/namespaces/eventhubs/messages/write`, `Microsoft.EventHub/namespaces/authorizationRules/listkeys/action` autorizzazioni all'Event Hub, come previsto dai ruoli predefiniti Data Owner di Azure Event Hubs, ad esempio
Eseguire query sui log in una tabella	Autorizzazioni `Microsoft.OperationalInsights/workspaces/query/<table>/read` per le aree di lavoro Log Analytics fornite dal ruolo predefinito di Lettore di Log Analytics, ad esempio
Eseguire query sui log in una tabella (azione tabella)	Autorizzazioni `Microsoft.OperationalInsights/workspaces/tables/query/read` per le aree di lavoro Log Analytics fornite dal ruolo predefinito di Lettore di Log Analytics, ad esempio

Limiti

I log personalizzati creati usando l'API dell'agente di raccolta dati HTTP non possono essere esportati, inclusi i log basati su testo utilizzati dall'agente di Log Analytics. I log personalizzati creati usando regole di raccolta dati, inclusi i log basati su testo, possono essere esportati.
L'esportazione dei dati supporterà gradualmente più tabelle. Vedere la sezione Tabelle non supportate .
Il numero massimo di regole attive per area di lavoro è 10, ognuna può includere più tabelle.
L'account di archiviazione deve essere univoco per tutte le regole nello spazio di lavoro.
I piani di tabella supportati sono Analytics e Basic. Il piano ausiliario non è supportato.
Le destinazioni devono trovarsi nella stessa area dell'area di lavoro di Log Analytics.
L'esportazione nell'Account di archiviazione Premium non è supportata.

Completezza dei dati

L'esportazione dei dati è ottimizzata per spostare volumi di dati di grandi dimensioni nelle destinazioni. In caso di destinazione con scalabilità o disponibilità insufficiente, un processo di ripetizione dei tentativi continua per un massimo di 12 ore e può risultare nella duplicazione di una parte dei record esportati. Seguire le indicazioni per le destinazioni dell'account di archiviazione e di Event Hubs per migliorare l'affidabilità. Se le destinazioni non sono ancora disponibili dopo il periodo di ripetizione dei tentativi, i dati vengono eliminati.

Per altre informazioni sui limiti di destinazione e sugli avvisi consigliati, vedere Creare o aggiornare una regola di esportazione dei dati.

Modello di determinazione prezzi

Gli addebiti per l'esportazione dei dati si basano sul numero di byte esportati in destinazioni in dati in formato JSON e misurati in GB (10^9 byte). I calcoli delle dimensioni dell'esportazione dei dati non possono essere eseguiti con una query dell'area di lavoro perché il calcolo delle dimensioni non include il sovraccarico di formattazione JSON. Usa il metodo di questo script di esempio di PowerShell per calcolare le dimensioni totali di fatturazione di un contenitore blob. Attualmente non è previsto alcun addebito per l'esportazione nei cloud sovrani. Prima dell'abilitazione verrà inviata una notifica.

Per altre informazioni, inclusa la sequenza temporale di fatturazione per l'esportazione dei dati, vedere Prezzi di Monitoraggio di Azure. La fatturazione per l'esportazione dei dati è stata abilitata all'inizio di ottobre 2023.

Destinazioni di esportazione

La destinazione di esportazione dei dati deve essere disponibile prima di creare regole di esportazione nell'area di lavoro. Le destinazioni possono trovarsi in sottoscrizioni diverse. Con Azure Lighthouse, è anche possibile inviare dati alle destinazioni in un altro tenant di Microsoft Entra.

Account di archiviazione

Evitare errori di ingresso di archiviazione a causa della latenza o del superamento dei limiti di frequenza usando un account di archiviazione esistente che non dispone di altri dati non di monitoraggio. In questo modo è possibile controllare meglio l'accesso ai dati e migliorare l'affidabilità dell'esportazione dei dati.

Per inviare dati a un account di archiviazione non modificabile, impostare i criteri non modificabili per l'account di archiviazione come descritto in Impostare e gestire i criteri di immutabilità per Archiviazione BLOB di Azure. È necessario seguire tutti i passaggi descritti in questo articolo, inclusa l'abilitazione delle scritture di BLOB di accodamento protetti.

L'account di archiviazione non può essere Premium, deve essere StorageV1 o versione successiva e si trova nella stessa area dell'area di lavoro. Se è necessario replicare i dati in altri account di archiviazione in altre aree, usare una delle opzioni di ridondanza di Archiviazione di Azure, tra cui archiviazione con ridondanza geografica e archiviazione con ridondanza geografica e archiviazione con ridondanza geografica.

I dati vengono inviati agli account di archiviazione quando raggiungono Azure Monitor ed esportati in destinazioni situate in una regione di workspace. Viene creato un contenitore per ogni tabella nell'account di archiviazione con il nome am- seguito dal nome della tabella. Ad esempio, la tabella SecurityEvent invia a un contenitore denominato am-SecurityEvent.

I BLOB vengono archiviati in cartelle di 5 minuti nella struttura di percorso seguente: WorkspaceResourceId=/subscriptions/subscription-id/resourcegroups/<resource-group>/providers/microsoft.operationalinsights/workspaces/<workspace>/y=<four-digit numeric year>/m=<two-digit numeric month>/d=<two-digit numeric day>/h=<two-digit 24-hour clock hour>/m=<two-digit 60-minute clock minute>/PT05M.json. Le aggiunte ai BLOB sono limitate a 50 K scritture. Nella cartella verranno aggiunti altri BLOB come PT05M_#.json*, dove '#' è il conteggio incrementale dei BLOB.

Nota

Le aggiunte ai BLOB vengono scritte in base al campo "TimeGenerated" e si verificano durante la ricezione dei dati di origine. I dati in arrivo in Monitoraggio di Azure con ritardo o tentativi di limitazione delle destinazioni seguenti vengono scritti nei BLOB in base al relativo TimeGenerated.

Il formato dei BLOB in un account di archiviazione si trova in righe JSON, in cui ogni record è delimitato da una nuova riga, senza matrice di record esterni e senza virgole tra i record JSON.

Hub eventi

Evitare di usare un hub eventi con dati esistenti non di monitoraggio. Questa procedura consigliata consente di evitare errori di ingresso a causa della latenza o del superamento dei limiti di frequenza.

I dati vengono inviati all'Event Hub quando raggiungono Azure Monitor e vengono esportati in destinazioni che si trovano in una regione del workspace. Creare più regole di esportazione nello stesso spazio dei nomi dell'hub eventi specificando un valore diverso Event Hub name nella regola. Quando non viene specificato un oggetto Event Hub name, viene creato un Hub eventi predefinito per le tabelle esportate con il nome am- seguito dal nome della tabella. Ad esempio, la tabella SecurityEvent verrà inviata a un Hub eventi denominato am-SecurityEvent.

Il numero di Hub eventi supportati nei livelli dello spazio dei nomi Basic e Standard è 10. Quando si esportano più di 10 tabelle in questi livelli, è necessario suddividere le tabelle tra diverse regole di esportazione destinate a differenti spazi dei nomi di Hub Eventi, oppure specificare un nome di Hub Eventi per esportare tutte le tabelle.

Nota

Il livello dello spazio dei nomi Di base di Hub eventi è limitato. Supporta dimensioni di eventi inferiori e nessuna opzione Aumento automatico per aumentare e aumentare automaticamente il numero di unità elaborate. Poiché il volume di dati nell'area di lavoro aumenta nel tempo e, di conseguenza, è necessario ridimensionare l'Hub eventi, usare i livelli Standard, Premium o Hub eventi dedicati con la funzionalità Aumento automatico abilitata. Per ulteriori informazioni, vedere Aumentare automaticamente le unità di rendimento di Hub eventi di Azure.
L'esportazione dei dati non può raggiungere le risorse di Hub eventi quando sono abilitate le reti virtuali. È necessario selezionare la casella di controllo Consenti ai servizi di Azure nell'elenco servizi attendibili di accedere a questo account di archiviazione per ignorare questa impostazione del firewall in un Hub eventi per concedere l'accesso agli Hub eventi.

Eseguire query sui dati esportati

L'esportazione di dati dalle aree di lavoro agli account di archiviazione consente di soddisfare diversi scenari indicati in panoramica e può essere usata da strumenti in grado di leggere i BLOB dagli account di archiviazione. I metodi seguenti consentono di eseguire query sui dati usando il linguaggio di query di Log Analytics, che è lo stesso per Esplora dati di Azure.

Eseguire query sui dati in Azure Data Lake usando Esplora dati di Azure.
Usare Esplora dati di Azure per inserire dati da un account di archiviazione.
Usare l'area di lavoro di Log Analytics per eseguire query sui dati inseriti usando l'API di inserimento dei log. I dati inseriti vengono inviati a una tabella di log personalizzata e non alla tabella originale.

Abilitare l'esportazione dati

Per abilitare l'esportazione dei dati di Log Analytics, è necessario eseguire i passaggi seguenti.

Registrare il provider di risorse
Consenti servizi Microsoft attendibili
Monitorare le destinazioni (scelta consigliata)
Creare o aggiornare una regola di esportazione dei dati

Registrare il provider di risorse

Il provider di risorse di Azure Microsoft.Insights deve essere registrato nella sottoscrizione per abilitare l'esportazione dei dati di Log Analytics.

Questo provider di risorse è probabilmente già registrato per la maggior parte degli utenti di Monitoraggio di Azure. Per verificare, andare a Sottoscrizioni nel portale di Azure. Selezionare la sottoscrizione e quindi selezionare Provider di risorse nella sezione Impostazioni del menu. Individuare Microsoft.Insights. Se lo stato è Registrato, è già registrato. In caso contrario, selezionare Registra per registrarla.

È anche possibile usare uno dei metodi disponibili per registrare un provider di risorse come descritto in Provider e tipi di risorse di Azure. Il comando di esempio seguente usa l'interfaccia della riga di comando di Azure:

az provider register --namespace 'Microsoft.insights'

Il comando di esempio seguente usa PowerShell:

Register-AzResourceProvider -ProviderNamespace Microsoft.insights

Consenti servizi Microsoft attendibili

Se è stato configurato l'account di archiviazione per consentire l'accesso dalle reti selezionate, è necessario aggiungere un'eccezione per consentire a Monitoraggio di Azure di scrivere nell'account. Da Firewall e reti virtuali per l'account di archiviazione selezionare Consenti ai servizi di Azure nell'elenco dei servizi attendibili di accedere a questo account di archiviazione.

Monitorare le destinazioni

Importante

Le destinazioni di esportazione hanno limiti e dovrebbero essere monitorate per ridurre al minimo la limitazione del traffico, gli errori e la latenza. Per ulteriori informazioni, vedere Scalabilità dell'account di archiviazione e Quote dello spazio dei nomi di Event Hubs.

Le metriche seguenti sono disponibili per l'operazione di esportazione dei dati e gli avvisi

Nome della metrica	Descrizione
Byte esportati	Numero totale di byte esportati nella destinazione dall'area di lavoro di Log Analytics nell'intervallo di tempo selezionato. Le dimensioni dei dati esportati sono il numero di byte nei dati in formato JSON esportati. 1 GB = 10^9 byte.
Errori di esportazione	Numero totale di richieste di esportazione non riuscite nella destinazione dall'area di lavoro di Log Analytics nell'intervallo di tempo selezionato. Questo numero include i tentativi di esportazione falliti a causa della limitazione delle risorse di destinazione, dell'errore di accesso negato o di qualsiasi errore del server. Un processo di ripetizione dei tentativi gestisce i tentativi non riusciti e il numero non indica i dati mancanti.
Record esportati	Numero totale di record esportati dall'area di lavoro di Log Analytics nell'intervallo di tempo selezionato. Questo numero conta i record per le operazioni terminate con esito positivo.

Monitorare un account di archiviazione

Usare un account di archiviazione separato per l'esportazione.

Configurare un avviso sulla metrica:

Ambito	Spazio dei nomi delle metriche	Metrica	Aggregazione	soglia
nome dell'archiviazione	Conto	Dati in ingresso	Somma	80% del numero massimo di ingressi per periodo di valutazione degli avvisi. Ad esempio, il limite è di 60 Gbps per utilizzo generico v2 negli Stati Uniti occidentali. La soglia di avviso è 1676 GiB per periodo di valutazione di 5 minuti.

Azioni di rimedio all'allerta:
- Usare un account di archiviazione separato per l'esportazione non condiviso con dati non di monitoraggio.
- Gli account Standard di Archiviazione di Azure supportano un limite di ingresso superiore per richiesta. Per richiedere un aumento, contattare il supporto di Azure.
- Suddividere le tabelle tra più account di archiviazione.

Monitorare Hub eventi

Configurare avvisi nelle metriche:

Ambito	Spazio dei nomi delle metriche	Metrica	Aggregazione	soglia
nome del namespace	Metriche standard di Event Hubs	Byte in ingresso	Somma	80% del numero massimo di ingressi per periodo di valutazione degli avvisi. Ad esempio, il limite è 1 MB/s per unità (TU o PU) e cinque unità usate. La soglia è di 228 MiB per periodo di valutazione di 5 minuti.
nome del namespace	Metriche standard di Event Hubs	Richieste in ingresso	Conteggio	80% degli eventi massimi per periodo di valutazione degli avvisi. Ad esempio, il limite è 1.000/s per unità (TU o PU) e cinque unità usate. La soglia è di 1.200.000 per periodo di valutazione di 5 minuti.
nome del namespace	Metriche standard di Event Hubs	Errori di superamento quota	Conteggio	Tra l'1% della richiesta. Ad esempio, le richieste per 5 minuti sono 600.000. La soglia è di 6.000 per periodo di valutazione di 5 minuti.

Azioni di rimedio all'allerta:
- Usare uno spazio dei nomi separato di Hub eventi per l'esportazione che non è condiviso con dati non di monitoraggio.
- Configurare la funzionalità Aumento automatico per ridimensionare automaticamente e incrementare il numero di unità di throughput per soddisfare le esigenze di utilizzo.
- Verificare l'aumento delle unità di elaborazione per supportare il volume di dati.
- Distribuire le tabelle fra più namespace.
- Usare i livelli Premium o Dedicato per una maggiore velocità effettiva.

Creare o aggiornare una regola di esportazione dei dati

Una regola di esportazione dei dati definisce la destinazione e le tabelle per le quali vengono esportati i dati. Il provisioning delle regole richiede circa 30 minuti prima dell'avvio dell'operazione di esportazione. Considerazioni sulle regole di esportazione dei dati:

L'account di archiviazione deve essere univoco per tutte le regole nello spazio di lavoro.
Più regole possono utilizzare lo stesso namespace di Event Hubs quando si invia a Event Hubs separati.
Esportazione in un account di archiviazione: viene creato un contenitore separato nell'account di archiviazione per ogni tabella.
Esporta in Hub eventi: se non viene specificato un nome di Hub eventi, viene creato un Hub eventi separato per ogni tabella. Il numero di Hub eventi supportati nei livelli dello spazio dei nomi Basic e Standard è 10. Quando si esportano più di 10 tabelle in questi livelli, suddividere le tabelle tra diverse regole di esportazione in spazi dei nomi di Hub eventi diversi o specificare un nome di Hub eventi nella regola per esportare tutte le tabelle.

Nel menu dell'area di lavoro di Log Analytics nel portale di Azure selezionare Esportazione dati nella sezione Impostazioni. Selezionare Nuova regola di esportazione nella parte superiore del riquadro.
Seguire i passaggi e quindi selezionare Crea. Solo le tabelle con dati in esse contenute vengono visualizzate nella scheda "Origine".

Screenshot della configurazione della regola di esportazione.

Usare il comando seguente per creare una regola di esportazione dei dati in un account di archiviazione usando PowerShell. Viene creato un contenitore separato per ogni tabella.

$storageAccountResourceId = '/subscriptions/subscription-id/resourceGroups/resource-group-name/providers/Microsoft.Storage/storageAccounts/storage-account-name'
New-AzOperationalInsightsDataExport -ResourceGroupName resourceGroupName -WorkspaceName workspaceName -DataExportName 'ruleName' -TableName 'SecurityEvent,Heartbeat' -ResourceId $storageAccountResourceId

Usare il comando seguente per creare una regola di esportazione dei dati in un Hub eventi specifico usando PowerShell. Tutte le tabelle vengono esportate nel nome dell'Hub eventi specificato e possono essere filtrate in base al campo Tipo per separare le tabelle.

$eventHubResourceId = '/subscriptions/subscription-id/resourceGroups/resource-group-name/providers/Microsoft.EventHub/namespaces/namespaces-name/eventhubs/eventhub-name'
New-AzOperationalInsightsDataExport -ResourceGroupName resourceGroupName -WorkspaceName workspaceName -DataExportName 'ruleName' -TableName 'SecurityEvent,Heartbeat' -ResourceId $eventHubResourceId -EventHubName EventhubName

Usare il comando seguente per creare una regola di esportazione dei dati in un Hub eventi usando PowerShell. Quando non viene specificato un nome specifico di Hub eventi, viene creato un contenitore separato per ogni tabella, fino al numero di Hub eventi supportati in ogni livello di Hub eventi. Per esportare più tabelle, specificare un nome dell'Hub eventi nella regola. In alternativa, è possibile impostare un'altra regola ed esportare le tabelle rimanenti in un altro spazio dei nomi di Hub eventi.

$eventHubResourceId = '/subscriptions/subscription-id/resourceGroups/resource-group-name/providers/Microsoft.EventHub/namespaces/namespaces-name'
New-AzOperationalInsightsDataExport -ResourceGroupName resourceGroupName -WorkspaceName workspaceName -DataExportName 'ruleName' -TableName 'SecurityEvent,Heartbeat' -ResourceId $eventHubResourceId

Usare il comando seguente per creare una regola di esportazione dei dati in un account di archiviazione usando l'interfaccia della riga di comando. Viene creato un contenitore separato per ogni tabella.

$storageAccountResourceId = '/subscriptions/subscription-id/resourceGroups/resource-group-name/providers/Microsoft.Storage/storageAccounts/storage-account-name'
az monitor log-analytics workspace data-export create --resource-group resourceGroupName --workspace-name workspaceName --name ruleName --tables SecurityEvent Heartbeat --destination $storageAccountResourceId

Usare il comando seguente per creare una regola di esportazione dei dati in un Hub eventi specifico usando l'interfaccia della riga di comando. Tutte le tabelle vengono esportate nel nome dell'Hub eventi specificato e possono essere filtrate in base al campo Tipo per separare le tabelle.

$eventHubResourceId = '/subscriptions/subscription-id/resourceGroups/resource-group-name/providers/Microsoft.EventHub/namespaces/namespaces-name/eventhubs/eventhub-name'
az monitor log-analytics workspace data-export create --resource-group resourceGroupName --workspace-name workspaceName --name ruleName --tables SecurityEvent Heartbeat --destination $eventHubResourceId

Usare il comando seguente per creare una regola di esportazione dei dati in un Hub eventi usando l'interfaccia della riga di comando. Quando non viene specificato un nome specifico di Hub eventi, viene creato un contenitore separato per ogni tabella fino al numero di Hub eventi supportati per il livello di Hub eventi. Se sono presenti più tabelle da esportare, specificare un nome di Hub eventi per esportare un numero qualsiasi di tabelle. In alternativa, è possibile impostare un'altra regola per esportare le tabelle rimanenti in un altro spazio dei nomi di Hub eventi.

$eventHubsNamespacesResourceId = '/subscriptions/subscription-id/resourceGroups/resource-group-name/providers/Microsoft.EventHub/namespaces/namespaces-name'
az monitor log-analytics workspace data-export create --resource-group resourceGroupName --workspace-name workspaceName --name ruleName --tables SecurityEvent Heartbeat --destination $eventHubsNamespacesResourceId

Usare la richiesta seguente per creare una regola di esportazione dei dati in un account di archiviazione usando l'API REST. Viene creato un contenitore separato per ogni tabella. La richiesta deve usare l'autorizzazione con token di tipo bearer e il tipo di contenuto application/json.

PUT https://management.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.operationalInsights/workspaces/<workspace-name>/dataexports/<data-export-name>?api-version=2023-09-01

Il corpo della richiesta specifica la destinazione della tabella. L'esempio seguente è un corpo di esempio per la richiesta REST.

{
    "properties": {
        "destination": {
            "resourceId": "/subscriptions/subscription-id/resourcegroups/resource-group-name/providers/Microsoft.Storage/storageAccounts/storage-account-name"
        },
        "tablenames": [
            "table1",
            "table2" 
        ],
        "enable": true
    }
}

L'esempio seguente è un corpo di esempio per la richiesta REST per un Hub eventi.

{
    "properties": {
        "destination": {
            "resourceId": "/subscriptions/subscription-id/resourcegroups/resource-group-name/providers/Microsoft.EventHub/namespaces/eventhub-namespaces-name"
        },
        "tablenames": [
            "table1",
            "table2"
        ],
        "enable": true
    }
}

L'esempio seguente è un corpo di esempio per la richiesta REST per un Hub eventi in cui viene fornito il nome dell'Hub eventi. In questo caso, tutti i dati esportati vengono inviati ad esso.

{
    "properties": {
        "destination": {
            "resourceId": "/subscriptions/subscription-id/resourcegroups/resource-group-name/providers/Microsoft.EventHub/namespaces/eventhub-namespaces-name",
            "metaData": {
                "EventHubName": "eventhub-name"
        },
        "tablenames": [
            "table1",
            "table2"
        ],
        "enable": true
    }
  }
}

Usare il comando seguente per creare una regola di esportazione dei dati in un account di archiviazione usando un modello di Azure Resource Manager.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "workspaceName": {
            "defaultValue": "workspace-name",
            "type": "String"
        },
        "workspaceLocation": {
            "defaultValue": "workspace-region",
            "type": "string"
        },
        "storageAccountRuleName": {
            "defaultValue": "storage-account-rule-name",
            "type": "string"
        },
        "storageAccountResourceId": {
            "defaultValue": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/resource-group-name/providers/Microsoft.Storage/storageAccounts/storage-account-name",
            "type": "String"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "microsoft.operationalinsights/workspaces",
            "apiVersion": "2023-09-01",
            "name": "[parameters('workspaceName')]",
            "location": "[parameters('workspaceLocation')]",
            "resources": [
                {
                  "type": "microsoft.operationalinsights/workspaces/dataexports",
                  "apiVersion": "2023-09-01",
                  "name": "[concat(parameters('workspaceName'), '/' , parameters('storageAccountRuleName'))]",
                  "dependsOn": [
                      "[resourceId('microsoft.operationalinsights/workspaces', parameters('workspaceName'))]"
                  ],
                  "properties": {
                      "destination": {
                          "resourceId": "[parameters('storageAccountResourceId')]"
                      },
                      "tableNames": [
                          "Heartbeat",
                          "InsightsMetrics",
                          "VMConnection",
                          "Usage"
                      ],
                      "enable": true
                  }
              }
            ]
        }
    ]
}

Usare il comando seguente per creare una regola di esportazione dei dati in un Hub eventi usando un modello di Resource Manager. Viene creato un Hub eventi separato per ogni tabella.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "workspaceName": {
            "defaultValue": "workspace-name",
            "type": "String"
        },
        "workspaceLocation": {
            "defaultValue": "workspace-region",
            "type": "string"
        },
        "eventhubRuleName": {
            "defaultValue": "event-hub-rule-name",
            "type": "string"
        },
        "namespacesResourceId": {
            "defaultValue": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/resource-group-name/providers/microsoft.eventhub/namespaces/namespaces-name",
            "type": "String"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "microsoft.operationalinsights/workspaces",
            "apiVersion": "2023-09-01",
            "name": "[parameters('workspaceName')]",
            "location": "[parameters('workspaceLocation')]",
            "resources": [
              {
                  "type": "microsoft.operationalinsights/workspaces/dataexports",
                  "apiVersion": "2023-09-01",
                  "name": "[concat(parameters('workspaceName'), '/', parameters('eventhubRuleName'))]",
                  "dependsOn": [
                      "[resourceId('microsoft.operationalinsights/workspaces', parameters('workspaceName'))]"
                  ],
                  "properties": {
                      "destination": {
                          "resourceId": "[parameters('namespacesResourceId')]"
                      },
                      "tableNames": [
                          "Usage",
                          "Heartbeat"
                      ],
                      "enable": true
                  }
              }
            ]
        }
    ]
}

Usare il comando seguente per creare una regola di esportazione dei dati in un Hub eventi specifico usando un modello di Resource Manager. Tutte le tabelle vengono esportate lì.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "workspaceName": {
            "defaultValue": "workspace-name",
            "type": "String"
        },
        "workspaceLocation": {
            "defaultValue": "workspace-region",
            "type": "string"
        },
        "eventhubRuleName": {
            "defaultValue": "event-hub-rule-name",
            "type": "string"
        },
        "namespacesResourceId": {
            "defaultValue": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/resource-group-name/providers/microsoft.eventhub/namespaces/namespaces-name",
            "type": "String"
        },
        "eventhubName": {
            "defaultValue": "event-hub-name",
            "type": "string"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "microsoft.operationalinsights/workspaces",
            "apiVersion": "2023-09-01",
            "name": "[parameters('workspaceName')]",
            "location": "[parameters('workspaceLocation')]",
            "resources": [
              {
                  "type": "microsoft.operationalinsights/workspaces/dataexports",
                  "apiVersion": "2023-09-01",
                  "name": "[concat(parameters('workspaceName'), '/', parameters('eventhubRuleName'))]",
                  "dependsOn": [
                      "[resourceId('microsoft.operationalinsights/workspaces', parameters('workspaceName'))]"
                  ],
                  "properties": {
                      "destination": {
                          "resourceId": "[parameters('namespacesResourceId')]",
                          "metaData": {
                              "eventHubName": "[parameters('eventhubName')]"
                          }
                      },
                      "tableNames": [
                          "Usage",
                          "Heartbeat"
                      ],
                      "enable": true
                  }
              }
            ]
        }
    ]
}

Visualizzare la configurazione delle regole di esportazione dei dati

Nel menu dell'area di lavoro di Log Analytics nel portale di Azure selezionare Esportazione dati nella sezione Impostazioni.
Selezionare una regola per una visualizzazione di configurazione.

Usare il comando seguente per visualizzare la configurazione di una regola di esportazione dei dati tramite PowerShell.

Get-AzOperationalInsightsDataExport -ResourceGroupName resourceGroupName -WorkspaceName workspaceName -DataExportName 'ruleName'

Usare il comando seguente per visualizzare la configurazione di una regola di esportazione dei dati usando l'interfaccia della riga di comando.

az monitor log-analytics workspace data-export show --resource-group resourceGroupName --workspace-name workspaceName --name ruleName

Usare la richiesta seguente per visualizzare la configurazione di una regola di esportazione dei dati usando l'API REST. La richiesta deve usare l'autorizzazione del token di connessione.

GET https://management.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.operationalInsights/workspaces/<workspace-name>/dataexports/<data-export-name>?api-version=2023-09-01

Disabilitare o aggiornare una regola di esportazione

È possibile disabilitare le regole di esportazione per arrestare l'esportazione per un determinato periodo, ad esempio quando si esegue il test. Nel menu dell'area di lavoro di Log Analytics nel portale di Azure selezionare Esportazione dati nella sezione Impostazioni. Selezionare l'interruttore Stato per disabilitare o abilitare la regola di esportazione.

È possibile disabilitare le regole di esportazione per arrestare l'esportazione per un determinato periodo, ad esempio quando si esegue il test. Usare il comando seguente per disabilitare o aggiornare i parametri delle regole tramite PowerShell.

Update-AzOperationalInsightsDataExport -ResourceGroupName resourceGroupName -WorkspaceName workspaceName -DataExportName 'ruleName' -TableName 'SecurityEvent,Heartbeat' -Enable: $false

az monitor log-analytics workspace data-export update --resource-group resourceGroupName --workspace-name workspaceName --name ruleName --tables SecurityEvent Heartbeat --enable false

PUT https://management.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.operationalInsights/workspaces/<workspace-name>/dataexports/<data-export-name>?api-version=2023-09-01
Authorization: Bearer <token>
Content-type: application/json

{
    "properties": {
        "destination": {
            "resourceId": "/subscriptions/subscription-id/resourcegroups/resource-group-name/providers/Microsoft.Storage/storageAccounts/storage-account-name"
        },
        "tablenames": [
"table1",
    "table2" 
        ],
        "enable": false
    }
}

Eliminare una regola di esportazione

Nel menu dell'area di lavoro di Log Analytics nel portale di Azure selezionare Esportazione dati nella sezione Impostazioni. Cliccare sui puntini di sospensione a destra della regola e selezionare Elimina.

Usare il comando seguente per eliminare una regola di esportazione dei dati usando PowerShell.

Remove-AzOperationalInsightsDataExport -ResourceGroupName resourceGroupName -WorkspaceName workspaceName -DataExportName 'ruleName'

Usare il comando seguente per eliminare una regola di esportazione dei dati usando l'interfaccia della riga di comando.

az monitor log-analytics workspace data-export delete --resource-group resourceGroupName --workspace-name workspaceName --name ruleName

Usare la richiesta seguente per eliminare una regola di esportazione dei dati usando l'API REST. La richiesta deve usare l'autorizzazione del token di connessione.

DELETE https://management.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.operationalInsights/workspaces/<workspace-name>/dataexports/<data-export-name>?api-version=2023-09-01

Visualizzare tutte le regole di esportazione dei dati in un'area di lavoro

Nel menu Area di lavoro di Log Analytics nel portale di Azure selezionare Esportazione dati nella sezione Impostazioni per visualizzare tutte le regole di esportazione nell'area di lavoro.

Usare il comando seguente per visualizzare tutte le regole di esportazione dei dati in un'area di lavoro usando PowerShell.

Get-AzOperationalInsightsDataExport -ResourceGroupName resourceGroupName -WorkspaceName workspaceName

Usare il comando seguente per visualizzare tutte le regole di esportazione dei dati in un'area di lavoro usando l'interfaccia della riga di comando.

az monitor log-analytics workspace data-export list --resource-group resourceGroupName --workspace-name workspaceName

Usare la richiesta seguente per visualizzare tutte le regole di esportazione dei dati in un'area di lavoro usando l'API REST. La richiesta deve usare l'autorizzazione del token di connessione.

GET https://management.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.operationalInsights/workspaces/<workspace-name>/dataexports?api-version=2023-09-01

Tabelle non compatibili

Nota

Se la regola di esportazione dei dati include una tabella non supportata, la configurazione avrà esito positivo, ma non verranno esportati dati per tale tabella. Quando la tabella è supportata, verrà avviata l'esportazione dei dati. È in corso un processo di aggiunta del supporto per altre tabelle. Consultare regolarmente questo articolo.

Tabella	Limitazioni
ADXDataOperation
Avviso	Supporto parziale. L'inserimento dati per gli avvisi Zabbix non è supportato.
Cronologia Avviso
AzureActivity	Supporto parziale. I dati provenienti dall'agente di Log Analytics o dall'agente di Monitoraggio di Azure sono completamente supportati nell'esportazione. I dati in arrivo tramite l'agente di estensione diagnostica vengono raccolti mediante l'archiviazione. Questo percorso non è supportato nell'esportazione.
AzureDiagnostics
AzureMetrics
Modifica di configurazione
Dati di configurazione	Supporto parziale. Alcuni dati vengono inseriti tramite servizi interni non supportati nell'esportazione. Attualmente, questa parte non è presente nell'esportazione.
Databricks DatabricksSQL
DatabricksSQL
AvvioApplicazioneDispositivo
Calendario del Dispositivo
SessioneDiConnessioneDelDispositivo
DeviceEtw
DeviceHealth
BattitoDelDispositivo
ETWEvent	Supporto parziale. I dati provenienti dall'agente di Log Analytics o dall'agente di Monitoraggio di Azure sono completamente supportati nell'esportazione. I dati in arrivo tramite l'agente di estensione diagnostica vengono raccolti mediante l'archiviazione. Questo percorso non è supportato nell'esportazione.
Evento	Supporto parziale. I dati provenienti dall'agente di Log Analytics o dall'agente di Monitoraggio di Azure sono completamente supportati nell'esportazione. I dati in arrivo tramite l'agente di estensione diagnostica vengono raccolti mediante l'archiviazione. Questo percorso non è supportato nell'esportazione.
InsightsMetrics	Supporto parziale. Alcuni dati vengono inseriti tramite servizi interni non supportati nell'esportazione. Attualmente, questa parte non è presente nell'esportazione.
Sessioni di rete
Operazione	Supporto parziale. Alcuni dati vengono inseriti tramite servizi interni non supportati nell'esportazione. Attualmente, questa parte non è presente nell'esportazione.
Stato di Protezione
EventoOperativoDiServiceFabric	Supporto parziale. I dati provenienti dall'agente di Log Analytics o dall'agente di Monitoraggio di Azure sono completamente supportati nell'esportazione. I dati in arrivo tramite l'agente di estensione diagnostica vengono raccolti mediante l'archiviazione. Questo percorso non è supportato nell'esportazione.
ServiceFabricReliableActorEvent	Supporto parziale. I dati provenienti dall'agente di Log Analytics o dall'agente di Monitoraggio di Azure sono completamente supportati nell'esportazione. I dati in arrivo tramite l'agente di estensione diagnostica vengono raccolti mediante l'archiviazione. Questo percorso non è supportato nell'esportazione.
Evento Servizio Affidabile ServiceFabric	Supporto parziale. I dati provenienti dall'agente di Log Analytics o dall'agente di Monitoraggio di Azure sono completamente supportati nell'esportazione. I dati in arrivo tramite l'agente di estensione diagnostica vengono raccolti mediante l'archiviazione. Questo percorso non è supportato nell'esportazione.
Aggiornamento	Supporto parziale. Alcuni dati vengono inseriti tramite servizi interni non supportati nell'esportazione. Attualmente, questa parte non è presente nell'esportazione.
VMBoundPort
VMComputer
VMConnection
VMProcess
W3CIISLog	Supporto parziale. I dati provenienti dall'agente di Log Analytics o dall'agente di Monitoraggio di Azure sono completamente supportati nell'esportazione. I dati in arrivo tramite l'agente di estensione diagnostica vengono raccolti mediante l'archiviazione. Questo percorso non è supportato nell'esportazione.
WireData	Supporto parziale. Alcuni dati vengono inseriti tramite servizi interni non supportati nell'esportazione. Attualmente, questa parte non è presente nell'esportazione.

Passaggi successivi

Eseguire query sui dati esportati da Esplora dati di Azure

Condividi tramite

Esportazione dei dati dell'area di lavoro Log Analytics in Monitoraggio di Azure

Informazioni generali

Altre opzioni di esportazione

Autorizzazioni necessarie

Limiti

Completezza dei dati

Modello di determinazione prezzi

Destinazioni di esportazione

Account di archiviazione

Hub eventi

Eseguire query sui dati esportati

Abilitare l'esportazione dati

Registrare il provider di risorse

Consenti servizi Microsoft attendibili

Monitorare le destinazioni

Monitorare un account di archiviazione

Monitorare Hub eventi

Creare o aggiornare una regola di esportazione dei dati

Visualizzare la configurazione delle regole di esportazione dei dati

Disabilitare o aggiornare una regola di esportazione

Eliminare una regola di esportazione

Visualizzare tutte le regole di esportazione dei dati in un'area di lavoro

Tabelle non compatibili

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive