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 impostati nelle impostazioni delle impostazioni di diagnostica sono ora deprecati e non possono più essere usati. Usare i criteri relativi al ciclo di vita 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 si configurano le impostazioni di diagnostica nella 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 e quindi selezionare la risorsa.

     

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

     

2. Se nella risorsa selezionata non sono presenti impostazioni, viene richiesto di creare un'impostazione. Selezionare Aggiungi impostazione di diagnostica.

   

   Se sono presenti impostazioni esistenti nella risorsa, viene visualizzato un elenco di impostazioni già configurate. Selezionare Aggiungi impostazione di diagnostica per aggiungere una nuova impostazione. In alternativa, selezionare Modifica impostazione per modificarne una esistente. Ogni impostazione non può avere più di uno dei tipi di destinazione.

   

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

   

4. Log e metriche da instradare: 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 un secondo momento. L'elenco delle categorie varia per ogni servizio di Azure. Selezionare AllMetrics se si vogliono archiviare anche le metriche nei log di Monitoraggio di Azure.

5. Dettagli destinazione: selezionare la casella di controllo per ogni destinazione. Le opzioni vengono visualizzate in modo da poter 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. Archivio in un account di archiviazione: selezionare la sottoscrizione e l'accountArchiviazione in cui archiviare i dati.

      

      Suggerimento

      Usare i criteri relativi al ciclo di vita Archiviazione di Azure per gestire il periodo di conservazione dei log. I criteri di conservazione impostati nelle impostazioni delle impostazioni di diagnostica sono ora deprecati.

   3. Trasmettere a un hub eventi: specificare i criteri seguenti:

      • Sottoscrizione: sottoscrizione di cui fa parte l'hub eventi.
      • Spazio dei nomi dell'hub eventi: se non è disponibile, è necessario crearne uno.
      • Nome dell'hub eventi (facoltativo): 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 inviano a più categorie, è possibile specificare un nome per limitare il numero di hub eventi creati. Per altre informazioni, vedere Hub eventi di Azure quote e limiti.
      • Nome dei criteri dell'hub eventi (facoltativo): un criterio definisce le autorizzazioni del meccanismo di streaming. Per altre informazioni, vedere Funzionalità di Hub eventi.

   4. Inviare alla soluzione partner: è prima necessario installare Azure Native ISV Services 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 della risorsa che quella di Azure, è possibile selezionare la tabella di destinazione visualizzata quando si seleziona l'area di lavoro Log Analytics come destinazione. In genere è consigliabile selezionare Specifica risorsa perché la struttura della tabella consente 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 essere necessari fino a 15 minuti tra quando viene generato un evento e quando viene visualizzato in un'area di lavoro Log Analytics.

PowerShell

Usare il cmdlet New-AzDiagnosticSetting per creare un'impostazione di diagnostica con Azure PowerShell. Vedere la documentazione per questo cmdlet per le descrizioni dei relativi parametri.

Importante

Non è possibile usare questo metodo per un log attività. Usare invece l'impostazione Crea 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 usando 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 = @()
$log = @()
$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à. Usare invece l'impostazione crea diagnostica in Monitoraggio di Azure usando un modello di 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 il servizio lo supporta, aggiungere il export-to-resource-specific parametro con un 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 può cambiare a apiVersion 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 usando 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 metrica 'xxxx' non è supportata". Questo errore potrebbe verificarsi anche se la distribuzione precedente è riuscita.

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 di categoria supportati.

Il problema si verifica a causa di una modifica recente nell'API sottostante. Le categorie di metriche diverse da AllMetrics non sono supportate e non sono mai state ad eccezione di alcuni servizi di Azure specifici. In passato, altri nomi di categoria venivano ignorati durante la distribuzione di un'impostazione di diagnostica. Il back-end di Monitoraggio di Azure ha reindirizzato queste categorie a AllMetrics. A partire da febbraio 2021, il back-end è stato aggiornato per verificare in modo specifico che la categoria di metriche fornita sia accurata. Questa modifica può 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, mantenere solo una con il riferimento AllMetrics . Se il problema persiste, contattare 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 risorsa con caratteri non ASCII. Si consideri ad esempio 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 spostarne le risorse in una nuova. In caso contrario, è necessario ricreare la risorsa.

Possibilità di dati duplicati o eliminati

Ogni sforzo viene effettuato per garantire che tutti i dati di log vengano inviati correttamente alle destinazioni, ma non è possibile garantire il trasferimento di dati al 100% dei log tra endpoint. I tentativi e altri meccanismi sono stati risolti per risolvere questi problemi e tentare di assicurarsi che i dati di log arrivino all'endpoint.

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 Archiviazione di Azure
• Altre informazioni sui log della piattaforma Azure