Creare impostazioni di diagnostica in Monitoraggio di Azure

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

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.

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

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.

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

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

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

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.