Esercitazione: Aggiungere una trasformazione per i dati dell'area di lavoro di Azure Cosmos DB usando il portale di Azure

Questa esercitazione illustra come configurare un esempio di trasformazione in una regola di raccolta dati dell'area di lavoro (DCR) utilizzando il portale di Azure.

Le trasformazioni dell'area di lavoro vengono archiviate insieme in un singolo DCR per l'area di lavoro, denominata DCR dell'area di lavoro. Ogni trasformazione è associata a una tabella specifica. La trasformazione viene applicata a tutti i dati inviati a questa tabella da qualsiasi flusso di lavoro che non usa un record di dominio.

In questa esercitazione apprenderai a:

Prerequisiti

Per completare questa esercitazione è necessario:

• Un'area di lavoro Log Analytics in cui si dispone almeno dei diritti di collaboratore.
• Autorizzazioni per creare oggetti DCR nello spazio di lavoro.
• Tabella che contiene già alcuni dati.
• La tabella non può essere associata al DCR della trasformazione dell'area di lavoro.

Panoramica dell'esercitazione

In questa esercitazione si riduce il requisito di archiviazione per la CDBDataPlaneRequests tabella filtrando determinati record. È anche possibile rimuovere il contenuto di una colonna durante l'analisi dei dati della colonna per archiviare una parte di dati in una colonna personalizzata. La tabella CDBDataPlaneRequests viene creata quando si abilita Log Analytics in un'area di lavoro.

Questa esercitazione usa il portale di Azure, che fornisce una procedura guidata per guidarti nel processo di creazione di una trasformazione al momento dell'inserimento. Dopo aver completato i passaggi, vedrai che la procedura guidata:

• Aggiorna lo schema della tabella con qualsiasi altra colonna della query.
• Crea un WorkspaceTransformation DCR e lo collega all'area di lavoro se un DCR predefinito non è già collegato all'area di lavoro.
• Crea una trasformazione al momento dell'ingestione e la aggiunge al DCR.

Abilitare i log di controllo delle query

È necessario abilitare Log Analytics per l'area di lavoro per creare la CDBDataPlaneRequests tabella con cui si sta lavorando. Questo passaggio non è necessario per tutte le trasformazioni del tempo di inserimento. È solo per generare i dati di esempio con cui stiamo lavorando.

Aggiungere una trasformazione alla tabella

Ora che la tabella è stata creata, è possibile creare la trasformazione per essa.

1. Nel menu Log Analytics aree di lavoro nel portale di Azure selezionare Table. Individuare la CDBDataPlaneRequests tabella e selezionare Crea trasformazione.

   

2. Poiché questa trasformazione è la prima nell'area di lavoro, è necessario creare un DCR di trasformazione dell'area di lavoro. Se si creano trasformazioni per altre tabelle nella stessa area di lavoro, queste vengono archiviate nello stesso DCR. Selezionare Crea una nuova regola di raccolta dati. La sottoscrizione e il gruppo di risorse sono già configurati per l'area di lavoro. Immettere un nome per il DCR e selezionare Fine.

3. Selezionare Avanti per visualizzare i dati di esempio della tabella. Quando si definisce la trasformazione, il risultato viene applicato ai dati di esempio. Per questo motivo, è possibile valutare i risultati prima di applicarli ai dati effettivi. Selezionare Editor di trasformazione per definire la trasformazione.

   

4. Nell'editor di trasformazione è possibile visualizzare la trasformazione applicata ai dati prima dell'inserimento nella tabella. Una tabella virtuale denominata source rappresenta i dati in ingresso, con lo stesso set di colonne della tabella di destinazione stessa. La trasformazione contiene inizialmente una query semplice che restituisce la source tabella senza modifiche.

5. Modificare la query per adattarla al seguente esempio:

   source
   | where StatusCode != 200 // searching for requests that are not successful
   | project-away Type, TenantId
   

   La modifica apporta le modifiche seguenti:

   • Le righe correlate all'esecuzione di query sulla CDBDataPlaneRequests tabella stessa sono state eliminate per risparmiare spazio perché queste voci di log non sono utili.
   • I dati dalle TenantId colonne e Type sono stati rimossi per risparmiare spazio.
   • Le trasformazioni supportano anche l'aggiunta di colonne usando l'operatore extend nella query.

   Annotazioni

   Usando il portale di Azure, l'output della trasformazione avvierà le modifiche allo schema della tabella, se necessario. Le colonne verranno aggiunte in modo che corrispondano all'output della trasformazione, se non esistono già. Assicurarsi che l'output non contenga colonne che non si desidera aggiungere alla tabella. Se l'output non include colonne già presenti nella tabella, tali colonne non verranno rimosse, ma i dati non verranno aggiunti.

   Tutte le colonne personalizzate aggiunte a una tabella predefinita devono terminare in _CF. Le colonne aggiunte a una tabella personalizzata non devono avere questo suffisso. Una tabella personalizzata ha un nome che termina con _CL.

6. Copiare la query nell'editor di trasformazione e selezionare Esegui per visualizzare i risultati dai dati di esempio. È possibile verificare che la nuova Workspace_CF colonna si trovi nella query.

   

7. Selezionare Applica per salvare la trasformazione e quindi Avanti per esaminare la configurazione. Selezionare Crea per aggiornare il DCR con la nuova trasformazione.

   

Testare la trasformazione

Attendere circa 30 minuti perché la trasformazione abbia effetto e quindi verificarla eseguendo una query sulla tabella. Questa trasformazione influisce solo sui dati inviati alla tabella dopo l'applicazione della trasformazione.

Per questa esercitazione, eseguire alcune query di esempio per inviare dati alla CDBDataPlaneRequests tabella. Includere alcune query su CDBDataPlaneRequests in modo da poter verificare che la trasformazione filtri questi record.

Risoluzione dei problemi

In questa sezione vengono descritte le diverse condizioni di errore che è possibile ricevere e come correggerle.

IntelliSense in Log Analytics non sta riconoscendo le nuove colonne della tabella

L'aggiornamento della cache che gestisce IntelliSense potrebbe richiedere fino a 24 ore.

La trasformazione in una colonna dinamica non funziona

Un problema noto attualmente riguarda le colonne dinamiche. Una soluzione temporanea consiste nell'analizzare in modo esplicito i dati delle colonne dinamiche usando parse_json() prima di eseguire qualsiasi operazione su di essi.

Passaggi successivi