Configurare una tabella con il piano ausiliario nell'area di lavoro Log Analytics (anteprima)

Articolo
01.10.2024

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 colonna TimeGenerated supporta attualmente solo il formato ISO8601. Per informazioni sul formato TimeGenerated, 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:

HTTP

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

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:

JSON

 {
    "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, TimeGenerated e RawData (di tipo string). La regola di raccolta dati invia l'intera voce di log raccolta alla colonna RawData e i log di Monitoraggio di Azure popolano automaticamente la colonna TimeGenerated con 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.

JSON

{
    "$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.
columns include 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 occidentali 2
	Stati Uniti centro-meridionali
	Stati Uniti centro-settentrionali
Asia/Pacifico	Australia orientale
	Australia sud-orientale
	Asia orientale
Europa	Europa occidentale
	Europa settentrionale
	Regno Unito meridionale
	Germania centro-occidentale
	Svizzera settentrionale
	Francia centrale
	Norvegia orientale
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:

Kusto
```
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:

Condividi tramite