Metriche, avvisi e log di Batch per la valutazione diagnostica e il monitoraggioBatch metrics, alerts, and logs for diagnostic evaluation and monitoring

Questo articolo descrive come monitorare un account Batch tramite le funzionalità di Monitoraggio di Azure.This article explains how to monitor a Batch account using features of Azure Monitor. Monitoraggio di Azure raccoglie metriche e log di diagnostica per le risorse nell'account Batch.Azure Monitor collects metrics and diagnostic logs for resources in your Batch account. È possibile raccogliere e utilizzare i dati in svariati modi per monitorare l'account Batch e diagnosticare i problemi.Collect and consume this data in a variety of ways to monitor your Batch account and diagnose issues. È anche possibile configurare avvisi sulle metriche per ricevere notifiche quando una metrica raggiunge un valore specificato.You can also configure metric alerts so you receive notifications when a metric reaches a specified value.

Metriche di BatchBatch metrics

Le metriche sono dati di telemetria di Azure (chiamati anche contatori delle prestazioni) generati dalle risorse di Azure che vengono usate dal servizio Monitoraggio di Azure.Metrics are Azure telemetry data (also called performance counters) emitted by your Azure resources which are consumed by the Azure Monitor service. Tra le metriche di esempio in un account Batch sono incluse quelle relative a eventi di creazione di pool, conteggio di nodi per priorità bassa ed eventi di completamento di attività.Example metrics in a Batch account include: Pool Create Events, Low-Priority Node Count, and Task Complete Events.

Vedere l'elenco delle metriche di Batch supportate.See the list of supported Batch metrics.

Le metriche:Metrics are:

  • Vengono abilitate per impostazione predefinita in ogni account Batch senza alcuna configurazione aggiuntivaEnabled by default in each Batch account without additional configuration
  • Vengono generate ogni minutoGenerated every 1 minute
  • Non sono automaticamente persistenti, ma hanno una cronologia in sequenza di 30 giorni.Not persisted automatically, but have a 30-day rolling history. È possibile mantenere persistenti le metriche di attività come parte della registrazione diagnostica.You can persist activity metrics as part of diagnostic logging.

Visualizzare le metricheView metrics

È possibile visualizzare le metriche per l'account Batch nel portale di Azure.View metrics for your Batch account in the Azure portal. La pagina Panoramica per l'account mostra per impostazione predefinita le metriche relative a nodi, core e attività principali.The Overview page for the account by default shows key node, core, and task metrics.

Per visualizzare tutte le metriche dell'account Batch:To view all Batch account metrics:

  1. Nel portale fare clic su Tutti i servizi > Account Batch e quindi fare clic sul nome dell'account Batch.In the portal, click All services > Batch accounts, and then click the name of your Batch account.
  2. In Monitoraggio selezionare Metrica.Under Monitoring, click Metrics.
  3. Selezionare una o più metriche.Select one or more of the metrics. Se lo si desidera, è possibile selezionare metriche di risorse aggiuntive tramite gli elenchi a discesa Sottoscrizioni, Gruppo di risorse, Tipo di risorsa e Risorsa.If you want, select additional resource metrics by using the Subscriptions, Resource group, Resource type, and Resource dropdowns.

    Metriche di Batch

Per recuperare le metriche a livello di codice, usare le API di Monitoraggio di Azure.To retrieve metrics programmatically, use the Azure Monitor APIs. Ad esempio, vedere Retrieve Azure Monitor metrics with .NET (Recuperare metriche di Monitoraggio di Azure con .NET).For example, see Retrieve Azure Monitor metrics with .NET.

Avvisi sulle metriche di BatchBatch metric alerts

Facoltativamente, è possibile configurare avvisi sulle metriche praticamente in tempo reale, che vengono attivati quando il valore di una metrica specificata supera la soglia assegnata.Optionally, configure near real-time metric alerts that trigger when the value of a specified metric crosses a threshold that you assign. L'avviso genera una notifica personalizzata quando viene "attivato" (quando la soglia viene superata e viene soddisfatta la condizione di avviso) e anche quando viene "risolto" (quando il valore rientra nella soglia e la condizione non viene più soddisfatta).The alert generates a notification you choose when the alert is "Activated" (when the threshold is crossed and the alert condition is met) as well as when it is "Resolved" (when the threshold is crossed again and the condition is no longer met).

Ad esempio, è possibile configurare un avviso sulle metriche quando il numero di core per priorità bassa diminuisce a un determinato livello, per consentire la regolazione della composizione dei pool.For example, you might want to configure a metric alert when your low priority core count falls to a certain level, so you can adjust the composition of your pools.

Per configurare un avviso sulle metriche nel portale:To configure a metric alert in the portal:

  1. Fare clic su Tutti i servizi > Account Batch e quindi fare clic sul nome dell'account Batch.Click All services > Batch accounts, and then click the name of your Batch account.
  2. In Monitoraggio fare clic su Regole di avviso > Aggiungi avviso per la metrica.Under Monitoring, click Alert rules > Add metric alert.
  3. Selezionare una metrica, una condizione di avviso, ad esempio quando una metrica supera un valore specifico durante un periodo, e una o più notifiche.Select a metric, an alert condition (such as when a metric exceeds a particular value during a period), and one or more notifications.

È anche possibile configurare un avviso praticamente in tempo reale usando l'API REST.You can also configure a near real-time alert using the REST API. Per altre informazioni, vedere Usare gli avvisi sulle metriche più recenti per i servizi di Azure nel portale di AzureFor more information, see Use the newer metric alerts for Azure services in Azure portal

Diagnostica di BatchBatch diagnostics

I log di diagnostica contengono informazioni generate dalle risorse di Azure che descrivono il funzionamento di ogni risorsa.Diagnostic logs contain information emitted by Azure resources that describe the operation of each resource. Per Batch, è possibile raccogliere i log seguenti:For Batch, you can collect the following logs:

  • Eventi Log del servizio generati dal servizio Batch di Azure durante il ciclo di vita di una singola risorsa di Batch, come un pool o un'attività.Service Logs events emitted by the Azure Batch service during the lifetime of an individual Batch resource like a pool or task.

  • Log Metrica a livello di account.Metrics logs at the account level.

Le impostazioni per abilitare la raccolta di log di diagnostica non sono attive per impostazione predefinita.Settings to enable collection of diagnostic logs are not enabled by default. È necessario abilitare in modo esplicito le impostazioni di diagnostica per ogni account Batch che si vuole monitorare.Explicitly enable diagnostic settings for each Batch account you want to monitor.

Destinazioni dei logLog destinations

Uno scenario comune consiste nel selezionare un account di archiviazione di Azure come destinazione dei log.A common scenario is to select an Azure Storage account as the log destination. Per archiviare i log in Archiviazione di Azure, creare l'account prima di abilitare la raccolta dei log.To store logs in Azure Storage, create the account before enabling collection of logs. Se all'account Batch è stato associato un account di archiviazione, è possibile scegliere l'account come destinazione dei log.If you associated a storage account with your Batch account, you can choose that account as the log destination.

Altre destinazioni facoltative per i log di diagnostica:Other optional destinations for diagnostic logs:

  • Trasmettere gli eventi dei log di diagnostica di Batch a un hub eventi di Azure.Stream Batch diagnostic log events to an Azure Event Hub. Hub eventi è in grado di inserire milioni di eventi al secondo, che è quindi possibile trasformare e archiviare tramite un qualsiasi provider di analisi in tempo reale.Event Hubs can ingest millions of events per second, which you can then transform and store using any real-time analytics provider.

  • Inviare i log di diagnostica ad Azure Log Analytics, in cui è possibile analizzarli nel portale di Operations Management Suite (OMS) o esportarli per l'analisi in Power BI o Excel.Send diagnostic logs to Azure Log Analytics, where you can analyze them in the Operations Management Suite (OMS) portal, or export them for analysis in Power BI or Excel.

Nota

Potrebbero essere previsti costi aggiuntivi per archiviare o elaborare dati dei log di diagnostica con servizi di Azure.You may incur additional costs to store or process diagnostic log data with Azure services.

Abilitare la raccolta dei log di diagnostica di BatchEnable collection of Batch diagnostic logs

  1. Nel portale fare clic su Tutti i servizi > Account Batch e quindi fare clic sul nome dell'account Batch.In the portal, click All services > Batch accounts, and then click the name of your Batch account.
  2. In Monitoraggio fare clic su Log di diagnostica > Abilita diagnostica.Under Monitoring, click Diagnostic logs > Turn on diagnostics.
  3. In Impostazioni di diagnostica immettere un nome per l'impostazione e scegliere una destinazione dei log (account di archiviazione esistente, hub eventi o Log Analytics).In Diagnostic settings, enter a name for the setting, and choose a log destination (existing Storage account, Event Hub, or Log Analytics). Selezionare ServiceLog, AllMetrics o entrambi.Select either or both ServiceLog and AllMetrics.

    Quando si seleziona un account di archiviazione, è facoltativamente possibile impostare criteri di conservazione.When you select a storage account, optionally set a retention policy. Se non si specifica un numero di giorni per la conservazione, i dati vengono mantenuti per tutto il ciclo di vita dell'account di archiviazione.If you don't specify a number of days for retention, data is retained during the life of the storage account.

  4. Fare clic su Save.Click Save.

    Diagnostica di Batch

Altre opzioni per abilitare la raccolta di log includono l'uso di Monitoraggio di Azure nel portale per configurare le impostazioni di diagnostica, di un modello di Resource Manager oppure di Azure PowerShell o dell'interfaccia della riga di comando di Azure.Other options to enable log collection include: use Azure Monitor in the portal to configure diagnostic settings, use a Resource Manager template, or use Azure PowerShell or the Azure CLI. Vedere Raccogliere e utilizzare dati dei log dalle risorse di Azuresee Collect and consume log data from your Azure resources.

Accedere ai log di diagnostica nell'archiviazioneAccess diagnostics logs in storage

Se si archiviano i log di diagnostica di Batch in un account di archiviazione, viene creato un contenitore di archiviazione nell'account di archiviazione non appena si verifica un evento correlato.If you archive Batch diagnostic logs in a storage account, a storage container is created in the storage account as soon as a related event occurs. I BLOB vengono creati in base al modello di denominazione seguente:Blobs are created according to the following naming pattern:

insights-{log category name}/resourceId=/SUBSCRIPTIONS/{subscription ID}/
RESOURCEGROUPS/{resource group name}/PROVIDERS/MICROSOFT.BATCH/
BATCHACCOUNTS/{batch account name}/y={four-digit numeric year}/
m={two-digit numeric month}/d={two-digit numeric day}/
h={two-digit 24-hour clock hour}/m=00/PT1H.json

Esempio:Example:

insights-metrics-pt1m/resourceId=/SUBSCRIPTIONS/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/
RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.BATCH/
BATCHACCOUNTS/MYBATCHACCOUNT/y=2018/m=03/d=05/h=22/m=00/PT1H.json

Ogni file di BLOB PT1H.json contiene eventi in formato JSON che si sono verificati nell'ora specificata nell'URL del BLOB, ad esempio, h=12.Each PT1H.json blob file contains JSON-formatted events that occurred within the hour specified in the blob URL (for example, h=12). Durante l'ora attuale, gli eventi vengono aggiunti al file PT1H.json man mano che si verificano.During the present hour, events are appended to the PT1H.json file as they occur. Il valore dei minuti (m=00) è sempre 00, perché gli eventi del log di diagnostica vengono sempre suddivisi in singoli BLOB per ogni ora.The minute value (m=00) is always 00, since diagnostic log events are broken into individual blobs per hour. Tutte le ore sono in formato UTC.(All times are in UTC.)

Per altre informazioni sullo schema dei log di diagnostica nell'account di archiviazione, vedere Archiviare log di diagnostica di Azure.For more information about the schema of diagnostic logs in the storage account, see Archive Azure Diagnostic Logs.

Per accedere ai log nell'account di archiviazione a livello di codice, usare le API di Archiviazione.To access the logs in your storage account programmatically, use the Storage APIs.

Eventi del log del servizioService Log events

I log del servizio Azure Batch, se raccolti, contengono gli eventi generati dal servizio Azure Batch durante il ciclo di vita di una singola risorsa di Batch, come un pool o un'attività.Azure Batch Service Logs, if collected, contain events emitted by the Azure Batch service during the lifetime of an individual Batch resource like a pool or task. Ogni evento generato da Batch viene registrato in formato JSON.Each event emitted by Batch is logged in JSON format. Ad esempio, questo è il corpo di un evento di creazione pool di esempio:For example, this is the body of a sample pool create event:

{
    "poolId": "myPool1",
    "displayName": "Production Pool",
    "vmSize": "Small",
    "cloudServiceConfiguration": {
        "osFamily": "5",
        "targetOsVersion": "*"
    },
    "networkConfiguration": {
        "subnetId": " "
    },
    "resizeTimeout": "300000",
    "targetDedicatedComputeNodes": 2,
    "maxTasksPerNode": 1,
    "vmFillType": "Spread",
    "enableAutoscale": false,
    "enableInterNodeCommunication": false,
    "isAutoPool": false
}

Il servizio Batch attualmente emette gli eventi di log del servizio seguenti.The Batch service currently emits the following Service Log events. Questo elenco potrebbe non essere completo, poiché è possibile che eventi aggiuntivi siano stati aggiunti dopo l'ultimo aggiornamento di questo articolo.This list may not be exhaustive, since additional events may have been added since this article was last updated.

Eventi del log del servizioService Log events
Creazione di poolPool create
Avvio dell'eliminazione di poolPool delete start
Completamento dell'eliminazione di poolPool delete complete
Avvio del ridimensionamento di poolPool resize start
Completamento del ridimensionamento di poolPool resize complete
Avvio dell'attivitàTask start
Attività completataTask complete
Errore dell'attivitàTask fail

Passaggi successiviNext steps