Tabellen en kolommen toevoegen of verwijderen in Azure Monitor-logboeken

2025-10-09

Met regels voor gegevensverzameling kunt u logboekgegevens filteren en transformeren voordat u de gegevens naar een Azure-tabel of een aangepaste tabel verzendt. In dit artikel wordt uitgelegd hoe u aangepaste tabellen maakt en aangepaste kolommen toevoegt aan tabellen in uw Log Analytics-werkruimte.

Belangrijk

Wanneer u een tabelschema bijwerkt, moet u alle regels voor gegevensverzameling bijwerken die gegevens naar de tabel verzenden. Het tabelschema dat u in de regel voor gegevensverzameling definieert, bepaalt hoe Azure Monitor gegevens naar de doeltabel streamt. Azure Monitor werkt regels voor gegevensverzameling niet automatisch bij wanneer u wijzigingen in het tabelschema aanbrengt.

Vereisten

Handeling	Toestemming vereist
Een tabel beheren	`Microsoft.OperationalInsights/workspaces/*` machtiging op het niveau van Log Analytics-werkruimte of hoger. Bijvoorbeeld, zoals opgegeven door de bevoorrechte ingebouwde rol, Log Analytics-inzender.

Als u gegevens wilt opnemen in de tabel, hebt u mogelijk het volgende nodig:

Eindpunt voor gegevensverzameling (DCE). Zie DCE voor meer informatie.

Een voorbeeld van ten minste één record van de brongegevens in een JSON-bestand. Dit wordt gebruikt voor het maken van aangepaste tabellen in de portal, zoals wat vereist is voor het verzamelen van tekst- en JSON-gegevensbronnen van VM's

[
  {
    "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>"
  }
]

Alle tabellen in een Log Analytics-werkruimte moeten een TimeGenerated kolom hebben, die wordt gebruikt om de opnametijd van de record te identificeren. Als de kolom ontbreekt, wordt deze automatisch toegevoegd aan de transformatie in uw DCR voor de tabel. Zie ondersteunde datum/tijd-indelingen voor meer informatie.

Een aangepast tabel maken

Azure-tabellen hebben vooraf gedefinieerde schema's. Als u logboekgegevens in een ander schema wilt opslaan, gebruikt u regels voor gegevensverzameling om te definiëren hoe u de gegevens verzamelt, transformeert en verzendt naar een aangepaste tabel in uw Log Analytics-werkruimte. Zie Een tabel instellen met het Hulpplan om een aangepaste tabel te maken met het Hulpplan.

Belangrijk

Aangepaste tabellen hebben een achtervoegsel van _CL, bijvoorbeeld tablename_CL. Azure Portal voegt het achtervoegsel _CL automatisch toe aan de tabelnaam. Wanneer u een aangepaste tabel maakt met een andere methode, moet u het _CL achtervoegsel zelf toevoegen. De tablename_CL in de eigenschappen gegevensstromen in uw regels voor gegevensverzameling moeten overeenkomen met de tablename_CL naam in de Log Analytics-werkruimte.

Waarschuwing

Tabelnamen worden gebruikt voor factureringsdoeleinden, zodat ze geen gevoelige informatie mogen bevatten.

Een aangepaste tabel maken met behulp van Azure Portal:

Selecteer Tabellen in het menu Log Analytics-werkruimten.
Selecteer Maken en vervolgens Nieuw aangepast logboek (op basis van DCR).
Geef een naam op en eventueel een beschrijving voor de tabel. U hoeft het _CL achtervoegsel niet toe te voegen aan de naam van de aangepaste tabel. Dit wordt automatisch toegevoegd aan de naam die u in de portal opgeeft.
Selecteer een bestaande regel voor gegevensverzameling in de vervolgkeuzelijst Gegevensverzamelingsregel of selecteer Een nieuwe regel voor gegevensverzameling maken en geef het abonnement, de resourcegroep en de naam op voor de nieuwe regel voor gegevensverzameling.
Selecteer een eindpunt voor gegevensverzameling en selecteer Volgende.
Selecteer Bladeren naar bestanden en zoek het JSON-bestand met de voorbeeldgegevens voor de nieuwe tabel.

Als uw voorbeeldgegevens geen kolom bevatten TimeGenerated , ontvangt u een bericht dat er een transformatie met deze kolom wordt gemaakt.
Als u logboekgegevens wilt transformeren voordat u gegevens in uw tabel opneemt :
1. Selecteer Transformatieeditor.
  
  Met de transformatieeditor kunt u een transformatie maken voor de binnenkomende gegevensstroom. Dit is een KQL-query die wordt uitgevoerd op elke binnenkomende record. In Azure Monitor-logboeken worden de resultaten van de query opgeslagen in de doeltabel.
2. Selecteer Uitvoeren om de resultaten weer te geven.
Selecteer Toepassen om de transformatie op te slaan en het schema weer te geven van de tabel die binnenkort wordt gemaakt. Selecteer Volgende om door te gaan.
Controleer de laatste details en selecteer Maken om het aangepaste logboek op te slaan.

Gebruik de Table - Update PATCH API om een aangepaste tabel te maken met de volgende PowerShell-code. Met deze code maakt u een tabel met de naam MyTable_CL met twee kolommen. Wijzig dit schema om een andere tabel te verzamelen.

Selecteer de knop Cloud Shell in Azure Portal en zorg ervoor dat de omgeving is ingesteld op PowerShell.

Kopieer de volgende PowerShell-code en vervang de padparameter door de juiste waarden voor uw werkruimte in de Invoke-AzRestMethod opdracht. Plak deze in de Cloud Shell-prompt om deze uit te voeren.

$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

Een tabel verwijderen

U kunt elke tabel verwijderen die geen Azure-tabel is, maar hoe de gegevens worden verwijderd, is afhankelijk van het tabeltype.

Zie Wat gebeurt er met gegevens wanneer u een tabel in een Log Analytics-werkruimte verwijdert voor meer informatie.

Ga als volgt te werk om een tabel te verwijderen uit Azure Portal:

Selecteer Tabellen in het menu van de Log Analytics-werkruimte.
Zoek naar de tabellen die u wilt verwijderen op naam of door zoekresultaten in het veld Type te selecteren.
Selecteer de tabel die u wilt verwijderen, selecteer het beletselteken (... ) rechts van de tabel, selecteer Verwijderen en bevestig de verwijdering door ja te typen.

Een tabel verwijderen met behulp van PowerShell:

Selecteer de knop Cloud Shell in Azure Portal en zorg ervoor dat de omgeving is ingesteld op PowerShell.

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

Een aangepaste kolom toevoegen of verwijderen

Aangepaste tabellen maken het mogelijk om het schema te wijzigen door kolommen toe te voegen of te verwijderen na het maken van de tabel. In Azure-tabellen kunnen alleen aangepaste kolommen worden toegevoegd en verwijderd.

Gebruik deze regels bij het definiëren van kolomnamen voor aangepaste tabellen:

Kolomnamen moeten beginnen met een letter (A-Z of a-z).
Gebruik na het eerste teken alleen letters, cijfers of onderstrepingstekens.
Gebruik geen spaties, puntjes, streepjes of andere interpunctie in kolomnamen.
Niet-ASCII-letters (bijvoorbeeld Æ, É, Ö) worden niet ondersteund in kolomnamen.
Kolomnamen zijn alleen hoofdlettergevoelig voor Analytics- en Basic-tabellen. Bij opname van hulplogboektabellen worden gegevens verwijderd om kolomnamen te dupliceren wanneer het enige verschil hoofdletters en kleine letters is.
Kolomnamen moeten 2 tot 45 tekens lang zijn.
Aangepaste kolomnamen in Azure-tabellen moeten eindigen op _CF
Gebruik geen namen die conflicteren met systeem- of gereserveerde kolommen, waaronder id, , BilledSize, IsBillableInvalidTimeGeneratedTenantIdTitleType, . UniqueId_ItemId_ResourceGroup_ResourceId_SubscriptionId_TimeReceived

Belangrijk

De schemaregels voor aangepaste tabellen zijn strenger dan algemene Kusto-id-regels. Kusto kan verwijzen naar ongebruikelijke eigenschapsnamen met een quotatie in query's, maar het aangepaste tabelschema accepteert alleen letters, cijfers en onderstrepingstekens voor kolomnamen.

Als u een aangepaste kolom wilt toevoegen aan een tabel in uw Log Analytics-werkruimte of een kolom wilt verwijderen:

Selecteer Tabellen in het menu Log Analytics-werkruimten.
Selecteer het beletselteken ( ... ) rechts van de tabel die u wilt bewerken en selecteer Schema bewerken.

Hiermee opent u het scherm Schema-editor .
Schuif omlaag naar de sectie Aangepaste kolommen van het scherm Schema-editor .
Een nieuwe kolom toevoegen:
1. Selecteer Een kolom toevoegen.
2. Stel de kolomnaam en beschrijving in (optioneel) en selecteer het verwachte waardetype in de vervolgkeuzelijst Type .
3. Selecteer Opslaan om de nieuwe kolom op te slaan.
Als u een kolom wilt verwijderen, selecteert u het pictogram Verwijderen links van de kolom die u wilt verwijderen.

Als u een nieuwe kolom wilt toevoegen aan een Azure- of aangepaste tabel, voert u het volgende uit:

$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

De PUT aanroep retourneert de bijgewerkte tabeleigenschappen, die de zojuist toegevoegde kolom moeten bevatten.

Voorbeeld

Voer deze opdracht uit om een aangepaste kolom met de naam Custom1_CF, toe te voegen aan de Azure-tabel Heartbeat :

$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

Als u nu de zojuist toegevoegde kolom wilt verwijderen en in plaats daarvan nog een kolom wilt toevoegen, voert u het volgende uit:

$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

Als u alle aangepaste kolommen in de tabel wilt verwijderen, voert u het volgende uit:

$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

Feedback

Is deze pagina nuttig?

Delen via

Tabellen en kolommen toevoegen of verwijderen in Azure Monitor-logboeken

Vereisten

Een aangepast tabel maken

Een tabel verwijderen

Een aangepaste kolom toevoegen of verwijderen

Verwante inhoud

Feedback

Aanvullende resources