Creare impostazioni di diagnostica in Monitoraggio di Azure

Creare e modificare le impostazioni di diagnostica in Monitoraggio di Azure per inviare metriche e log della piattaforma Azure a destinazioni diverse, ad esempio Log di Monitoraggio di Azure, Archiviazione di Azure o Hub eventi di Azure. È possibile usare metodi diversi per usare le impostazioni di diagnostica, ad esempio il portale di Azure, l'interfaccia della riga di comando di Azure, PowerShell e Azure Resource Manager.

Importante

I criteri di conservazione configurati nelle impostazioni in Impostazioni di diagnostica è ora deprecato e non possono più essere usati. Usare i criteri del ciclo di vita di Archiviazione di Azure per gestire il periodo di conservazione dei log. Per altre informazioni, vedere Eseguire la migrazione della conservazione dell'archiviazione delle impostazioni di diagnostica alla gestione del ciclo di vita di Archiviazione di Azure

Azure portal

È possibile configurare le impostazioni di diagnostica nel portale di Azure dal menu Monitoraggio di Azure o dal menu per la risorsa.

1. La posizione in cui configurare le impostazioni di diagnostica nel portale di Azure dipende dalla risorsa:

   • Per una singola risorsa, selezionare Impostazioni di diagnostica in Monitoraggio nel menu della risorsa.

     

   • Per una o più risorse, selezionare Impostazioni di diagnostica in Impostazioni nel menu Monitoraggio di Azure, quindi selezionare la risorsa.

     

   • Per il log attività selezionare Log attività nel menu Monitoraggio di Azure, quindi selezionare Esporta log attività. Assicurarsi di disabilitare qualsiasi configurazione legacy per il log attività. Per istruzioni, vedere Disabilitare le impostazioni esistenti.

     

2. Se non sono presenti impostazioni per la risorsa selezionata, verrà chiesto di crearne una. Selezionare Aggiungi impostazione di diagnostica.

   

   Se sono presenti impostazioni nella risorsa, verrà visualizzato un elenco di impostazioni già configurate. Selezionare Aggiungi impostazione di diagnostica per aggiungere una nuova impostazione. Oppure, selezionare Modifica impostazione per modificarne una esistente. Ogni impostazione non può avere più di un tipo di destinazione.

   

3. Assegnare un nome all'impostazione se non ne ha già uno.

   

4. Log e metriche da indirizzare: per i log scegliere un gruppo di categorie o selezionare le singole caselle di controllo per ogni categoria di dati da inviare alle destinazioni specificate in seguito. L'elenco delle categorie varia per ogni servizio di Azure. Selezionare AllMetrics per archiviare anche le metriche nei log di Monitoraggio di Azure.

5. Dettagli destinazione: selezionare la casella di controllo per ogni destinazione. Vengono visualizzate le opzioni che consentono di aggiungere altre informazioni.

   

   1. Invia all'area di lavoro Log Analytics: selezionare la sottoscrizione e l'area di lavoro Log Analytics in cui inviare i dati. Se non si dispone di un'area di lavoro, è necessario crearne una prima di procedere.

   2. Archivia in un account di archiviazione: selezionare la sottoscrizione e l'account di archiviazione in cui archiviare i dati.

      

      Suggerimento

      Usare i criteri del ciclo di vita di Archiviazione di Azure per gestire il periodo di conservazione dei log. I criteri di conservazione configurati nelle impostazioni di Impostazioni di diagnostica sono ora deprecati.

   3. Streaming in un hub eventi: specificare i criteri seguenti:

      • Sottoscrizione: la sottoscrizione di cui fa parte l'hub eventi.
      • Spazio dei nomi hub eventi: se non ne è presente è necessario crearne uno.
      • Nome hub eventi (facoltativo): il nome a cui inviare tutti i dati. Se non si specifica un nome, viene creato un hub eventi per ogni categoria di log. Se si invia a più categorie, è possibile specificare un nome per limitare il numero di hub eventi creati. Per altre informazioni, vedere Quote e limiti di Hub eventi di Azure.
      • Nome criteri hub eventi (facoltativo): un criterio definisce le autorizzazioni del meccanismo di streaming. Per altre informazioni, vedere Funzionalità di Hub eventi.

   4. Invia alla soluzione partner: è necessario installare prima i servizi ISV nativi di Azure nella sottoscrizione. Le opzioni di configurazione variano in base al partner. Per altre informazioni, vedere Panoramica dei servizi ISV nativi di Azure.

6. Se il servizio supporta sia la modalità di diagnostica specifica delle risorse sia quella di Diagnostica di Azure è possibile selezionare la tabella di destinazione visualizzata quando si seleziona l'area di lavoro Log Analytics come destinazione. In genere è consigliabile selezionare Specifico della risorsa perché la struttura della tabella consente una maggiore flessibilità e query più efficienti.

   

7. Seleziona Salva.

Dopo alcuni istanti, la nuova impostazione viene visualizzata nell'elenco delle impostazioni per questa risorsa. I log vengono trasmessi alle destinazioni specificate quando vengono generati nuovi dati dell'evento. Potrebbero passare fino a 15 minuti tra l'emissione di un evento e la sua comparsa in un file area di lavoro Log Analytics.

PowerShell

Usare il cmdlet New-AzDiagnosticSetting per creare un'impostazione di diagnostica con Azure PowerShell. Per una descrizione dei parametri, vedere la documentazione di questo cmdlet.

Importante

Non è possibile usare questo metodo per un log attività. In alternativa, usare Crea impostazione di diagnostica in Monitoraggio di Azure usando un modello di Azure Resource Manager per creare un modello di Resource Manager e distribuirlo con PowerShell.

Il cmdlet di PowerShell di esempio seguente crea un'impostazione di diagnostica per tutti i log, o per i log di controllo, e le metriche per un insieme di credenziali delle chiavi tramite l'area di lavoro Log Analytics.

$KV = Get-AzKeyVault -ResourceGroupName <resource group name> -VaultName <key vault name>
$Law = Get-AzOperationalInsightsWorkspace -ResourceGroupName <resource group name> -Name <workspace name>  # LAW name is case sensitive

$metric = New-AzDiagnosticSettingMetricSettingsObject -Enabled $true -Category AllMetrics
# For all available logs, use:
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup allLogs  
# or, for audit logs, use:
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup audit    
New-AzDiagnosticSetting -Name 'KeyVault-Diagnostics' -ResourceId $KV.ResourceId -WorkspaceId $Law.ResourceId -Log $log -Metric $metric -Verbose

CLI

Usare il comando az monitor diagnostic-settings create per creare un'impostazione di diagnostica con l'interfaccia della riga di comando di Azure. Vedere la documentazione per questo comando per le descrizioni dei relativi parametri.

Importante

Non è possibile usare questo metodo per un log attività. In alternativa, usare Crea impostazione di diagnostica in Monitoraggio di Azure usando un modello di Azure Resource Manager per creare un modello di Resource Manager e distribuirlo con l'interfaccia della riga di comando di Azure.

Il comando di esempio seguente crea un'impostazione di diagnostica usando tutte e tre le destinazioni. La sintassi è leggermente diversa a seconda del client.

Per specificare la modalità specifica della risorsa se supportata dal servizio, aggiungere il export-to-resource-specificparametro con il valore true.`

az monitor diagnostic-settings create  \
--name KeyVault-Diagnostics \
--resource /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.KeyVault/vaults/mykeyvault \
--logs    '[{"category": "AuditEvent","enabled": true}]' \
--metrics '[{"category": "AllMetrics","enabled": true}]' \
--storage-account /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.Storage/storageAccounts/<storage account name> \
--workspace /subscriptions/<subscription ID>/resourcegroups/<resource group name>/providers/microsoft.operationalinsights/workspaces/<log analytics workspace name> \
--event-hub-rule /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.EventHub/namespaces/<event hub namespace>/authorizationrules/RootManageSharedAccessKey \
--event-hub <event hub name> \
--export-to-resource-specific true

Resource Manager

Il modello JSON seguente fornisce un esempio per la creazione di un'impostazione di diagnostica per inviare tutti i log di controllo a un'area di lavoro Log Analytics. Tenere presente che apiVersion può cambiare a seconda della risorsa nell'ambito.

File modello

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "scope": {
        "type": "string"
    },
    "workspaceId": {
        "type": "string"
    },
    "settingName": {
        "type": "string"
    }
},
  "resources": [
    {
      "type": "Microsoft.Insights/diagnosticSettings",
      "apiVersion": "2021-05-01-preview",
      "scope": "[parameters('scope')]",
      "name": "[parameters('settingName')]",
      "properties": {
       "workspaceId": "[parameters('workspaceId')]",
      "logs": [
             {
            "category": null,
            "categoryGroup": "audit",
            "enabled": true
          }
        ]
      }
    }
  ]
  }

File di parametri

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "settingName": {
        "value": "audit3"
    },
    "workspaceId": {
      "value": "/subscriptions/<subscription id>/resourcegroups/<resourcegroup name>/providers/microsoft.operationalinsights/workspaces/<workspace name>"
    },
    "scope": {
      "value": "Microsoft.<resource type>/<resourceName>"
    }
  }
}

REST API

Per creare o aggiornare le impostazioni di diagnostica tramite l'API REST di Monitoraggio di Azure, vedere Impostazioni di diagnostica.

Criteri di Azure

Per informazioni dettagliate sull'uso di Criteri di Azure per creare impostazioni di diagnostica su larga scala, vedere Creare impostazioni di diagnostica su larga scala usando Criteri di Azure.

Risoluzione dei problemi

Ecco alcuni suggerimenti per la risoluzione dei problemi.

Categoria di metriche non supportata

Quando si distribuisce un'impostazione di diagnostica, viene visualizzato un messaggio di errore simile a "La categoria di metrica 'xxxx' non è supportata". È possibile che si riceva questo errore anche se la distribuzione precedente ha avuto esito positivo.

Il problema si verifica quando si usa un modello di Resource Manager, un'API REST, l'interfaccia della riga di comando o Azure PowerShell. Le impostazioni di diagnostica create tramite il portale di Azure non sono interessate perché vengono presentati solo i nomi delle categorie supportate.

Il problema si verifica a causa di una recente modifica dell'API sottostante. Le categorie di metriche diverse da AllMetrics non sono supportate e non sono mai state escluse da alcuni servizi di Azure specifici. In passato, i nomi delle altre categorie venivano ignorati durante la distribuzione di un'impostazione di diagnostica. Il back-end di Monitoraggio di Azure ha reindirizzato queste categorie ad AllMetrics. A partire da febbraio 2021, il back-end è stato aggiornato per confermare in modo specifico che la categoria di metriche fornita sia accurata. Questa modifica potrebbe causare l'esito negativo di alcune distribuzioni.

Se viene visualizzato questo errore, aggiornare le distribuzioni in modo da sostituire qualsiasi nome di categoria di metriche con AllMetrics per risolvere il problema. Se in precedenza la distribuzione aggiungeva più categorie, mantenerne solo una con il riferimento AllMetrics. Se il problema persiste, contattare il supporto tecnico di Azure tramite il portale di Azure.

L'impostazione scompare a causa di caratteri non ASCII in resourceID

Le impostazioni di diagnostica non supportano gli ID delle risorse con caratteri non ASCII. Ad esempio, si consideri il termine "Preproducción". Poiché non è possibile rinominare le risorse in Azure, l'unica opzione consiste nel creare una nuova risorsa senza i caratteri non ASCII. Se i caratteri si trovano in un gruppo di risorse, è possibile spostarle in un nuovo gruppo al suo interno. In caso contrario, è necessario ricreare la risorsa.

Possibilità di dati duplicati o eliminati

Viene fatto il possibile per assicurare che tutti i dati di log vengano inviati correttamente alle vostre destinazioni, ma non è possibile garantire il trasferimento dati al 100% dei log tra endpoint. Per aggirare questi problemi e cercare di garantire che i dati di log arrivino all'endpoint, sono stati implementati nuovi tentativi e altri meccanismi.

Risorse inattive

Quando una risorsa è inattiva ed esporta metriche con valore zero, il meccanismo di esportazione delle impostazioni di diagnostica si riduce in modo incrementale per evitare i costi non necessari di esportazione e archiviazione dei valori zero. Il back-off può causare un ritardo nell'esportazione del valore successivo diverso da zero.

Se una risorsa rimane inattiva per un'ora, il meccanismo di esportazione si riduce a 15 minuti. Ciò significa che esiste una latenza potenziale fino a 15 minuti per l'esportazione del prossimo valore diverso da zero. Il tempo massimo di backoff di due ore viene raggiunto dopo sette giorni di inattività. Quando la risorsa inizia a esportare valori diversi da zero, il meccanismo di esportazione torna alla latenza di esportazione originale di tre minuti.

Questo comportamento si applica solo alle metriche esportate e non influisce sugli avvisi basati sulle metriche o sulla scalabilità automatica.

Passaggi successivi

• Esaminare come usare le impostazioni di diagnostica in Monitoraggio di Azure
• Eseguire la migrazione della conservazione dell'archiviazione delle impostazioni di diagnostica alla gestione del ciclo di vita di Archiviazione di Azure
• Altre informazioni sui log della piattaforma di Azure