Condividi tramite

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

  • Articolo

Il piano di tabella ausiliario consente di inserire e conservare i dati nell'area di lavoro Log Analytics a basso costo.

Ecco un video che illustra alcuni degli usi e dei vantaggi del piano di tabella ausiliario:

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 nuova 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.

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).
  • La configurazione di una tabella con il piano ausiliario è supportata solo per le tabelle nuove. Dopo aver creato una tabella con un piano ausiliario, non è possibile cambiare il piano della tabella.

Annotazioni

I log ausiliari sono disponibili a livello generale per tutte le aree del cloud pubblico, ma non per i cloud cinesi o di Azure per enti pubblici.

Creare una tabella personalizzata con il piano ausiliario

Per creare una tabella personalizzata, chiamare l'API Tables - Create usando questo comando:

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

Annotazioni

Attualmente, solo la versione 2023-01-01-preview dell'API consente di impostare il piano di tabella Ausiliario.

Specificare questo payload come corpo della richiesta. Aggiornare il nome della tabella e modificare le colonne in base allo schema della tabella. Questo esempio elenca tutti i tipi di dati di colonna supportati.

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

Annotazioni

  • La TimeGenerated colonna supporta solo il formato ISO 8601 con 6 cifre decimali per la precisione (nanosecondi). Per altre informazioni, vedere Formato datetime ISO 8601 supportato.
  • Le tabelle con il piano ausiliario non supportano colonne con dati dinamici.

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 l'ora di inserimento del log.

  • Inviare dati a Monitoraggio di Azure usando l'API di inserimento dei log.

    Per usare questo metodo:

    1. Creare una tabella personalizzata con il piano ausiliario come descritto in questo articolo.

    2. Seguire la procedura descritta in Esercitazione: Inviare dati ad Azure Monitor usando l'API di ingestione dei log per:

      1. Creare un'applicazione Microsoft Entra.

      2. 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:

    3. Concedere all'applicazione le autorizzazioni per l'uso della DCR.

    Annotazioni

    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.

Passaggi successivi

Altre informazioni su: