Configurare una tabella con il piano ausiliario nell'area di lavoro Log Analytics (anteprima)
Il piano di tabella ausiliario consente di inserire e conservare i dati nell'area di lavoro Log Analytics a basso costo. I log di Monitoraggio di Azure supportano attualmente il piano di tabella ausiliario per le tabelle personalizzate basate su DCR (regola di raccolta dati) a cui si inviano dati raccolti tramite l'agente di Monitoraggio di Azure o l'API di inserimento log.
Questo articolo illustra come creare una tabella personalizzata con il piano ausiliario nell'area di lavoro Log Analytics e configurare una regola di raccolta dati che invia dati a questa tabella.
Ecco un video che illustra alcuni degli usi e dei vantaggi del piano di tabella ausiliario:
Importante
Vedere le limitazioni dell'anteprima pubblica per le aree supportate e le limitazioni correlate alle tabelle ausiliarie e alle regole di raccolta dati.
Prerequisiti
Per creare una tabella personalizzata e raccogliere i dati di log, è necessario:
- Un'area di lavoro Log Analytics in cui si dispone almeno dei diritti di collaboratore.
- Un endpoint di raccolta dati (DCE).
- Tutte le tabelle in un'area di lavoro Log Analytics devono avere una colonna denominata
TimeGenerated. Se i dati di log non elaborati hanno una proprietàTimeGenerated, Monitoraggio di Azure usa questo valore per identificare l'ora di creazione del record. Per una tabella con il piano ausiliario, la colonnaTimeGeneratedsupporta attualmente solo il formato ISO8601. Per informazioni sul formatoTimeGenerated, vedere i formati datetime ISO 8601 supportati.
Creare una tabella personalizzata con il piano ausiliario
Per creare una tabella personalizzata, chiamare Tables - Create Or Update API usando questo comando:
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
Importante
Attualmente, solo la versione 2023-01-01-preview dell'API consente di impostare il piano di tabella Ausiliario.
Specificare questo payload: aggiornare il nome della tabella e modificare le colonne in base allo schema della tabella:
{
"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"
}
}
Inviare dati a una tabella con il piano ausiliario
Esistono attualmente due modi per inserire dati in una tabella personalizzata con il piano ausiliario:
Raccogliere i log da un file di testo con l'agente di Monitoraggio di Azure / Raccogliere i log da un file JSON con l'agente di Monitoraggio di Azure.
Se si usa questo metodo, la tabella personalizzata deve avere solo due colonne,
TimeGeneratedeRawData(di tipostring). La regola di raccolta dati invia l'intera voce di log raccolta alla colonnaRawDatae i log di Monitoraggio di Azure popolano automaticamente la colonnaTimeGeneratedcon il tempo di inserimento del log.Inviare dati a Monitoraggio di Azure usando l'API di inserimento dei log.
Per usare questo metodo:
Creare una tabella personalizzata con il piano ausiliario come descritto in questo articolo.
Seguire la procedura descritta in Esercitazione: Inviare dati a Monitoraggio di Azure usando l'API di inserimento dei log per:
- Creare un'applicazione Microsoft Entra.
- Creare una regola di raccolta dati usando questo modello di ARM.
{ "$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'))]" } } }Dove:
myworkspaceè il nome dell'area di lavoro Log Analytics.table_name_CLè il nome della tabella.columnsinclude le stesse colonne impostate in Creare una tabella personalizzata con il piano ausiliario.
Concedere all'applicazione le autorizzazioni per l'uso della DCR.
Limiti dell'anteprima pubblica
Durante l'anteprima pubblica, si applicano queste limitazioni:
Il piano ausiliario viene gradualmente implementato in tutte le aree ed è attualmente supportato in:
Area Posizioni Americhe Canada centrale Stati Uniti centrali Stati Uniti orientali Stati Uniti orientali 2 Stati Uniti occidentali Stati Uniti centro-meridionali Stati Uniti centro-settentrionali Asia/Pacifico Australia orientale Australia sud-orientale Europa Asia orientale Europa settentrionale Regno Unito meridionale Germania centro-occidentale Svizzera settentrionale Francia centrale Medio Oriente Israele centrale È possibile impostare il piano ausiliario solo nelle tabelle personalizzate basate su regole di raccolta dati create tramite Tables - Create Or Update API, versione
2023-01-01-preview.Tabelle con piano ausiliario:
- Attualmente non sono fatturate. Attualmente non sono previsti costi per l'inserimento, le query, i processi di ricerca e la conservazione a lungo termine.
- Non supportano colonne con dati dinamici.
- Hanno una conservazione totale fissa di 365 giorni.
- Supportano solo il formato datetime ISO 8601.
Regola di raccolta dati che invia dati a una tabella con un piano ausiliario:
- Può inviare dati solo a una singola tabella.
- Non può includere una trasformazione.
I dati di inserimento per le tabelle ausiliarie non sono attualmente disponibili nella tabella di utilizzo dei log di Monitoraggio di Azure. Per stimare il volume di inserimento dati, è possibile contare il numero di record nella tabella ausiliaria usando questa query:
MyTable_CL | summarize count()Queste funzionalità attualmente non sono supportate:
Funzionalità Dettagli Replica dell'area di lavoro Log Analytics Monitoraggio di Azure non replica i dati nelle tabelle con il piano Ausiliario nell'area di lavoro secondaria. Pertanto, questi dati non sono protetti dalla perdita di dati in caso di errori regionali e non sono disponibili quando si passa all'area di lavoro secondaria. Chiavi gestite dal cliente I dati nelle tabelle con il piano Ausiliario sono crittografati con chiavi gestite da Microsoft, anche se si proteggono i dati nel resto dell'area di lavoro di Log Analytics usando la propria chiave di crittografia. Customer Lockbox per Microsoft Azure L'interfaccia Lockbox, che consente di rivedere e approvare o rifiutare le richieste di accesso ai dati dei clienti in risposta a un ticket di supporto avviato dal cliente o un problema identificato da Microsoft, non si applica alle tabelle con il piano Ausiliario.
Passaggi successivi
Altre informazioni su: