Aggiungere o eliminare tabelle e colonne nei log di Monitoraggio di Azure

Le regole di raccolta dati consentono di filtrare e trasformare i dati di log prima di inviare i dati a una tabella di Azure o personalizzata. Questo articolo illustra come creare tabelle personalizzate e aggiungere colonne personalizzate alle tabelle nell'area di lavoro Log Analytics.

Importante

Ogni volta che si aggiorna uno schema di tabella, assicurarsi di aggiornare le regole di raccolta dati che inviano dati alla tabella. Lo schema di tabella che definisci nella regola di raccolta dati determina come Azure Monitor trasmette i dati alla tabella di destinazione. Monitoraggio di Azure non aggiorna automaticamente le regole di raccolta dati quando si apportano modifiche allo schema di tabella.

Prerequisiti

Action	Autorizzazione richiesta
Gestire una tabella	L’autorizzazione Microsoft.OperationalInsights/workspaces/* a livello nell’ambito dell’area di lavoro Log Analytics o superiore. Ad esempio, come fornito dal ruolo predefinito con privilegi, collaboratore di Log Analytics.

Per inserire dati nella tabella, potrebbe essere necessario quanto segue:

• Endpoint di raccolta dati (DCE). Per altre informazioni, vedere DCE.

• Esempio di almeno un record dei dati di origine in un file JSON. Viene usato per creare tabelle personalizzate nel portale, ad esempio ciò che è necessario per raccogliere il testo e le origini dati JSON dalle macchine virtuali

  [
    {
      "TimeGenerated": "supported_datetime_format",
      "<column_name_1>": "<column_name_1_value>",
      "<column_name_2>": "<column_name_2_value>"
    },
    {
      "TimeGenerated": "supported_datetime_format",
      "<column_name_1>": "<column_name_1_value>",
      "<column_name_2>": "<column_name_2_value>"
    },
    {
      "TimeGenerated": "supported_datetime_format",
      "<column_name_1>": "<column_name_1_value>",
      "<column_name_2>": "<column_name_2_value>"
    }
  ]
  

• Tutte le tabelle in un'area di lavoro Log Analytics devono avere una TimeGenerated colonna, usata per identificare il tempo di inserimento del record. Se la colonna non è presente, viene aggiunta automaticamente alla trasformazione nel tuo DCR per la tabella. Per informazioni, vedere Formati datetime supportati.

Creazione di una tabella personalizzata

Le tabelle di Azure hanno schemi predefiniti. Per archiviare i dati di log in uno schema diverso, usare le regole di raccolta dati per definire come raccogliere, trasformare e inviare i dati a una tabella personalizzata nell'area di lavoro Log Analytics. Per creare una tabella personalizzata con il piano ausiliario, vedere Configurare una tabella con il piano ausiliario.

Importante

Le tabelle personalizzate hanno un suffisso _CL; ad esempio tablename_CL. Il portale di Azure aggiunge automaticamente il suffisso _CL al nome della tabella. Quando si crea una tabella personalizzata usando un metodo diverso, è necessario aggiungere il suffisso _CL manualmente. tablename_CL nelle proprietà Flussi di dati nelle regole di raccolta dati deve corrispondere al nome tablename_CL nell'area di lavoro Log Analytics.

Avviso

I nomi delle tabelle vengono usati per scopi di fatturazione in modo che non contengano informazioni riservate.

Portale

Per creare una tabella personalizzata usando il portale di Azure:

1. Dal menu Aree di lavoro Log Analytics, selezionare Tabelle.

   

2. Selezionare Crea e quindi Nuovo log personalizzato (basato su DCR).

   

3. Specificare un nome e, facoltativamente, una descrizione per la tabella. Non è necessario aggiungere il suffisso _CL al nome della tabella personalizzata. Questo valore viene aggiunto automaticamente al nome specificato nel portale.

4. Selezionare una regola di raccolta dati esistente nell'elenco a discesa Regola di raccolta dati oppure selezionare Crea una nuova regola di raccolta dati e specificare Sottoscrizione, Gruppo di risorsee Nome per la nuova regola di raccolta dati.

   

5. Selezionare un endpoint di raccolta dati e selezionare Avanti.

   

6. Selezionare Cerca file e individuare il file JSON con i dati di esempio per la nuova tabella.

   

   Se i dati di esempio non includono una TimeGenerated colonna, viene visualizzato un messaggio che indica che viene creata una trasformazione con questa colonna.

7. Se si vuole trasformare i dati di log prima dell'inserimento nella tabella:

   1. Selezionare Editor trasformazione.

      L'editor di trasformazione consente di creare una trasformazione per il flusso di dati in ingresso. È una query KQL eseguita su ogni record in ingresso. I log di Azure Monitor salvano i risultati della query nella tabella di destinazione.

      

   2. Selezionare Esegui per visualizzare i risultati.

      

8. Selezionare Applica per salvare la trasformazione e visualizzare lo schema della tabella che sta per essere creato. Selezionare Avanti per continuare.

   

9. Verificare i dettagli finali e selezionare Crea per salvare il log personalizzato.

   

api

Per creare una tabella personalizzata, chiamare l'API Tables - Create Or Update.

CLI

Per creare una tabella personalizzata, eseguire il comando az monitor log-analytics workspace table create.

PowerShell

Usare l'API Tables - Update PATCH per creare una tabella personalizzata con il codice di PowerShell seguente. Questo codice crea una tabella denominata MyTable_CL con due colonne. Modificare questo schema per raccogliere una tabella diversa.

1. Selezionare il pulsante Cloud Shell nel portale di Azure e assicurarsi che l'ambiente sia impostato su PowerShell.

   

2. Copiare il codice di PowerShell seguente e sostituire il parametro Path con i valori appropriati per l'area di lavoro nel comando Invoke-AzRestMethod. Incollarlo nel prompt di Cloud Shell per eseguirlo.

   $tableParams = @'
   {
       "properties": {
           "schema": {
               "name": "MyTable_CL",
               "columns": [
                   {
                       "name": "TimeGenerated",
                       "type": "DateTime"
                   }, 
                   {
                       "name": "RawData",
                       "type": "String"
                   }
               ]
           }
       }
   }
   '@
   
   Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/MyTable_CL?api-version=2021-12-01-preview" -Method PUT -payload $tableParams
   

Elimina una tabella

È possibile eliminare qualsiasi tabella che non sia una tabella di Azure, ma il modo in cui i dati vengono eliminati dipende dal tipo di tabella.

Per altre informazioni, vedere Cosa accade ai dati quando si elimina una tabella in un'area di lavoro Log Analytics.

Portale

Per eliminare una tabella dal portale di Azure:

1. Dal menu dell'area di lavoro Log Analytics selezionare Tabelle.

2. Cercare le tabelle da eliminare in base al nome oppure selezionando Risultati della ricerca nel campo Tipo.

   

3. Selezionare la tabella da eliminare, selezionare i puntini di sospensione (...) a destra della tabella, selezionare Elimina e confermare l'eliminazione digitando sì.

   

api

Per eliminare una tabella, chiamare l'API Tables - Delete.

CLI

Per eliminare una tabella, eseguire il comando az monitor log-analytics workspace table delete.

PowerShell

Per eliminare una tabella tramite PowerShell:

1. Selezionare il pulsante Cloud Shell nel portale di Azure e assicurarsi che l'ambiente sia impostato su PowerShell.

   

2. Copiare il codice di PowerShell seguente e sostituire il parametro Path con i valori appropriati per l'area di lavoro nel comando Invoke-AzRestMethod. Incollarlo nel prompt di Cloud Shell per eseguirlo.

   Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/NewCustom_CL?api-version=2021-12-01-preview" -Method DELETE
   

Aggiungere o eliminare una colonna personalizzata

Le tabelle personalizzate consentono la modifica dello schema aggiungendo o eliminando colonne dopo la creazione della tabella. Le tabelle di Azure consentono solo l'aggiunta e l'eliminazione di colonne personalizzate.

Usare queste regole quando si definiscono i nomi di colonna per le tabelle personalizzate:

• I nomi delle colonne devono iniziare con una lettera (A-Z o a-z).

• Dopo il primo carattere, usare solo lettere, cifre o caratteri di sottolineatura.

• Non usare spazi, punti, trattini o altri segni di punteggiatura nei nomi di colonna.

• Le lettere non ASCII (ad esempio, Æ, É, Ö) non sono supportate nei nomi di colonna.

• I nomi delle colonne fanno distinzione tra maiuscole e minuscole solo per le tabelle di analisi e le tabelle di base. L'inserimento dati delle tabelle log ausiliarie omette i dati per duplicare i nomi delle colonne quando l'unica differenza è la distinzione tra maiuscole e minuscole.

• I nomi delle colonne devono essere lunghi da 2 a 45 caratteri.

• I nomi di colonna personalizzati nelle tabelle di Azure devono terminare _CF

• Non usare nomi in conflitto con colonne di sistema o riservate, tra cui id, , BilledSizeIsBillableInvalidTimeGeneratedTenantIdTitle, . TypeUniqueId_ItemId_ResourceGroup_ResourceId_SubscriptionId_TimeReceived

Importante

Le regole dello schema per le tabelle personalizzate sono più rigide delle regole di identificatore Kusto generali. Kusto può fare riferimento a nomi di proprietà insoliti con virgolette nelle query, ma lo schema di tabella personalizzato accetta solo lettere, cifre e caratteri di sottolineatura per i nomi di colonna.

Portale

Per aggiungere una colonna personalizzata a una tabella nell'area di lavoro Log Analytics o eliminare una colonna:

1. Dal menu Aree di lavoro Log Analytics, selezionare Tabelle.

2. Selezionare i puntini di sospensione (...) a destra della tabella da modificare e selezionare Modifica schema.

   Si apre la schermata Editor dello schema.

3. Scorrere verso il basso fino alla sezione Colonne personalizzate della schermata Editor dello schema.

   

4. Per aggiungere una nuova colonna:

   1. Selezionare Aggiungi una colonna.
   2. Impostare il nome e la descrizione della colonna (facoltativo) e selezionare il tipo di valore previsto dall'elenco a discesa Tipo.
   3. Selezionare Salva per salvare la nuova colonna.

5. Per eliminare una colonna, selezionare l'icona Elimina a sinistra della colonna da eliminare.

api

Per aggiungere o eliminare una colonna personalizzata, chiamare l'API Tables - Create Or Update.

CLI

Per aggiungere o eliminare una colonna personalizzata, eseguire il comando az monitor log-analytics workspace table update.

PowerShell

Per aggiungere una nuova colonna a una tabella di Azure o personalizzata, eseguire:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "<TableName>",
            "columns": [
                {
                    "name": ""<ColumnName>",
                    "description": "First custom column",
                    "type": "string",
                    "isDefaultDisplay": true,
                    "isHidden": false
                }
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/<TableName>?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

La chiamata PUT restituisce le proprietà della tabella aggiornate, che devono includere la colonna appena aggiunta.

Esempio

Eseguire questo comando per aggiungere una colonna personalizzata, denominata Custom1_CF, alla tabella Heartbeat di Azure:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "Heartbeat",
            "columns": [
                {
                    "name": "Custom1_CF",
                    "description": "The second custom column",
                    "type": "datetime",
                    "isDefaultDisplay": true,
                    "isHidden": false
                }
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/Heartbeat?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

A questo fine, per eliminare la colonna appena aggiunta e aggiungerne un'altra, eseguire:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "Heartbeat",
            "columns": [
                {
                    "name": "Custom2_CF",
                    "description": "The second custom column",
                    "type": "datetime",
                    "isDefaultDisplay": true,
                    "isHidden": false
                }
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/Heartbeat?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

Per eliminare tutte le colonne personalizzate nella tabella, eseguire:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "Heartbeat",
            "columns": [
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/Heartbeat?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

Contenuti correlati

• Raccolta di log con l'API di inserimento log
• Raccolta di log con l'agente di Monitoraggio di Azure
• Raccogliere dati dalle macchine virtuali