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 definito nella regola di raccolta dati determina il modo in cui Monitoraggio di Azure 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

Per creare una tabella personalizzata, sono necessari:

• Un'area di lavoro Log Analytics in cui si dispone almeno dei diritti di collaboratore.

• Un endpoint di raccolta dati.

• Un file JSON con almeno un record di esempio per la tabella personalizzata. L'aspetto sarà simile al seguente:

  [
    {
      "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 colonna denominata TimeGenerated. Se i dati di esempio hanno una colonna denominata TimeGenerated, questo valore verrà usato per identificare l'ora di inserimento del record. In caso contrario, verrà aggiunta una colonna TimeGenerated alla trasformazione nel Registro Azure Container per la tabella. Per informazioni sul formato TimeGenerated, vedere i 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 (anteprima).

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 a scopo di fatturazione, quindi non devono contenere 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 colonna TimeGenerated, verrà 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. Si tratta di una query KQL eseguita su ogni record in ingresso. Log di Monitoraggio di Azure archivia 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 riportato di seguito. 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

Esistono diversi tipi di tabelle nei log di Monitoraggio di Azure. È possibile eliminare qualsiasi tabella che non sia una tabella di Azure, ma cosa accade ai dati quando si elimina la tabella è diversa per ogni 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

È possibile modificare lo schema delle tabelle personalizzate e aggiungere colonne personalizzate o eliminare colonne da una tabella standard.

Nota

I nomi delle colonne devono iniziare con una lettera e possono essere costituiti da un massimo di 45 caratteri alfanumerici e caratteri di sottolineatura (_). _ResourceId, id, _ResourceId, _SubscriptionId, TenantId, Type, UniqueId e Title sono nomi di colonna riservati.

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. Verrà visualizzata 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

Passaggi successivi

Altre informazioni su:

• Raccolta di log con l'API di inserimento log
• Raccolta di log con l'agente di Monitoraggio di Azure
• Regole di raccolta dati