Een tabel instellen met het hulpplan in uw Log Analytics-werkruimte (preview)
Met het hulptabelplan kunt u gegevens opnemen en bewaren in uw Log Analytics-werkruimte tegen lage kosten. Azure Monitor-logboeken ondersteunen momenteel het hulptabelplan voor aangepaste tabellen op basis van gegevensverzamelingsregels (DCR) waarnaar u gegevens verzendt die u verzamelt met behulp van de Azure Monitor-agent of de API voor logboekopname.
In dit artikel wordt uitgelegd hoe u een aangepaste tabel maakt met het hulpplan in uw Log Analytics-werkruimte en hoe u een regel voor gegevensverzameling instelt waarmee gegevens naar deze tabel worden verzonden.
Hier volgt een video waarin enkele van de toepassingen en voordelen van het hulptabelplan worden uitgelegd:
Belangrijk
Zie openbare preview-beperkingen voor ondersteunde regio's en beperkingen met betrekking tot hulptabellen en regels voor gegevensverzameling.
Vereisten
Als u een aangepaste tabel wilt maken en logboekgegevens wilt verzamelen, hebt u het volgende nodig:
- Een Log Analytics-werkruimte met ten minste inzenderrechten.
- Een eindpunt voor gegevensverzameling (DCE).
- Alle tabellen in een Log Analytics-werkruimte hebben een kolom met de naam
TimeGenerated. Als uw onbewerkte logboekgegevens eenTimeGeneratedeigenschap hebben, gebruikt Azure Monitor deze waarde om de aanmaaktijd van de record te identificeren. Voor een tabel met het hulpplan ondersteunt deTimeGeneratedkolom momenteel alleen ISO8601 indeling. Zie de ondersteunde ISO 8601-datum/tijd-indeling voor informatie over deTimeGeneratedindeling.
Een aangepaste tabel maken met het hulpplan
Als u een aangepaste tabel wilt maken, roept u de Tabellen - API maken of bijwerken aan met behulp van deze opdracht:
PUT https://management.azure.com/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.OperationalInsights/workspaces/{workspace_name}/tables/{table name_CL}?api-version=2023-01-01-preview
Belangrijk
Met de enige versie 2023-01-01-preview van de API kunt u momenteel het hulptabelplan instellen.
Geef deze nettolading op: werk de tabelnaam bij en pas de kolommen aan op basis van uw tabelschema:
{
"properties": {
"schema": {
"name": "table_name_CL",
"columns": [
{
"name": "TimeGenerated",
"type": "datetime"
},
{
"name": "StringProperty",
"type": "string"
},
{
"name": "IntProperty",
"type": "int"
},
{
"name": "LongProperty",
"type": "long"
},
{
"name": "RealProperty",
"type": "real"
},
{
"name": "BooleanProperty",
"type": "boolean"
},
{
"name": "GuidProperty",
"type": "real"
},
{
"name": "DateTimeProperty",
"type": "datetime"
}
]
},
"totalRetentionInDays": 365,
"plan": "Auxiliary"
}
}
Gegevens verzenden naar een tabel met het hulpplan
Er zijn momenteel twee manieren om gegevens op te nemen in een aangepaste tabel met het hulpplan:
Verzamel logboeken uit een tekstbestand met De Azure Monitor-agent / verzamel logboeken uit een JSON-bestand met Azure Monitor Agent.
Als u deze methode gebruikt, mag uw aangepaste tabel slechts twee kolommen hebben en
TimeGeneratedRawData(van het typestring). De regel voor het verzamelen van gegevens verzendt de volledige logboekvermelding die u verzamelt naar deRawDatakolom en Azure Monitor-logboeken vult deTimeGeneratedkolom automatisch in met het moment dat het logboek wordt opgenomen.Gegevens verzenden naar Azure Monitor met behulp van logboekopname-API.
Ga als volgt te werk om deze methode te gebruiken:
Maak een aangepaste tabel met het hulpplan , zoals beschreven in dit artikel.
Volg de stappen die worden beschreven in zelfstudie: Gegevens verzenden naar Azure Monitor met behulp van logboekopname-API naar:
- Maak een Microsoft Entra-toepassing.
- Maak een regel voor gegevensverzameling met behulp van deze ARM-sjabloon.
{ "$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentTemplate.json#", "contentVersion": "1.0.0.0", "parameters": { "dataCollectionRuleName": { "type": "string", "metadata": { "description": "Specifies the name of the data collection rule to create." } }, "location": { "type": "string", "metadata": { "description": "Specifies the region in which to create the data collection rule. The must be the same region as the destination Log Analytics workspace." } }, "workspaceResourceId": { "type": "string", "metadata": { "description": "The Azure resource ID of the Log Analytics workspace in which you created a custom table with the Auxiliary plan." } } }, "resources": [ { "type": "Microsoft.Insights/dataCollectionRules", "name": "[parameters('dataCollectionRuleName')]", "location": "[parameters('location')]", "apiVersion": "2023-03-11", "kind": "Direct", "properties": { "streamDeclarations": { "Custom-table_name_CL": { "columns": [ { "name": "TimeGenerated", "type": "datetime" }, { "name": "StringProperty", "type": "string" }, { "name": "IntProperty", "type": "int" }, { "name": "LongProperty", "type": "long" }, { "name": "RealProperty", "type": "real" }, { "name": "BooleanProperty", "type": "boolean" }, { "name": "GuidProperty", "type": "real" }, { "name": "DateTimeProperty", "type": "datetime" } ] } }, "destinations": { "logAnalytics": [ { "workspaceResourceId": "[parameters('workspaceResourceId')]", "name": "myworkspace" } ] }, "dataFlows": [ { "streams": [ "Custom-table_name_CL" ], "destinations": [ "myworkspace" ] } ] } } ], "outputs": { "dataCollectionRuleId": { "type": "string", "value": "[resourceId('Microsoft.Insights/dataCollectionRules', parameters('dataCollectionRuleName'))]" } } }Hierin:
myworkspaceis de naam van uw Log Analytics-werkruimte.table_name_CLis de naam van de tabel.columnsbevat dezelfde kolommen die u hebt ingesteld in Een aangepaste tabel maken met het hulpplan.
Ververleent uw toepassing toestemming om uw DCR te gebruiken.
Beperkingen van openbare preview
Tijdens de openbare preview gelden deze beperkingen:
Het hulpplan wordt geleidelijk uitgerold naar alle regio's en wordt momenteel ondersteund in:
Regio Locaties Noord- en Zuid-Amerika Canada - midden VS - centraal VS - oost VS - oost 2 VS - west VS - west 2 VS - zuid-centraal VS - noord-centraal Azië en Stille Oceaan Australië - oost Australië - zuidoost Azië - oost Europa Europa -west Europa - noord Verenigd Koninkrijk Zuid Duitsland - west-centraal Zwitserland - noord Frankrijk - centraal Noorwegen - oost Midden-Oosten Israël - centraal U kunt het hulpplan alleen instellen op aangepaste tabellen die u maakt op basis van regels voor gegevensverzameling met behulp van de tabellen - API maken of bijwerken, versie
2023-01-01-preview.Tabellen met het hulpplan:
- Zijn momenteel niet gefactureerd. Er worden momenteel geen kosten in rekening gebracht voor opname, query's, zoektaken en langetermijnretentie.
- Geen ondersteuning bieden voor kolommen met dynamische gegevens.
- Een vaste totale retentie van 365 dagen hebben.
- Alleen ondersteuning voor ISO 8601-datum/tijd-indeling.
Een regel voor gegevensverzameling waarmee gegevens worden verzonden naar een tabel met een hulpplan:
- Kan alleen gegevens naar één tabel verzenden.
- Kan geen transformatie opnemen.
Opnamegegevens voor hulptabellen zijn momenteel niet beschikbaar in de tabel Gebruik van Azure Monitor-logboeken. Als u een schatting wilt maken van het gegevensopnamevolume, kunt u het aantal records in de hulptabel tellen met behulp van deze query:
MyTable_CL | summarize count()Deze functies worden momenteel niet ondersteund:
Functie Gegevens Replicatie van Log Analytics-werkruimte Azure Monitor repliceert geen gegevens in tabellen met het hulpplan naar uw secundaire werkruimte. Daarom zijn deze gegevens niet beschermd tegen gegevensverlies in het geval van een regionale storing en is deze niet beschikbaar wanneer u zich overzet naar uw secundaire werkruimte. Door klant beheerde sleutels Gegevens in tabellen met het hulpplan worden versleuteld met door Microsoft beheerde sleutels, zelfs als u de gegevens in de rest van uw Log Analytics-werkruimte beveiligt met uw eigen versleutelingssleutel. Klanten-lockbox voor Microsoft Azure De Lockbox-interface, waarmee u aanvragen voor klantgegevenstoegang kunt bekijken en goedkeuren of afwijzen als reactie op een door de klant geïnitieerd ondersteuningsticket of een probleem dat door Microsoft wordt geïdentificeerd, is niet van toepassing op tabellen met het hulpplan.
Volgende stappen
Meer informatie over: