Monitorare Azure Cosmos DBMonitor Azure Cosmos DB

È possibile monitorare gli account Azure Cosmos DB nel portale di Azure.You can monitor your Azure Cosmos DB accounts in the Azure portal. Per ogni account di Azure Cosmos DB, è disponibile un set completo di metriche per il monitoraggio di velocità effettiva, archiviazione, disponibilità, latenza e coerenza.For each Azure Cosmos DB account, a full suite of metrics is available to monitor throughput, storage, availability, latency, and consistency.

È possibile esaminare le metriche nella pagina Account, nella nuova pagina Metriche o in Monitoraggio di Azure.Metrics can be reviewed on the Account page, the new Metrics page, or in Azure Monitor.

Visualizzare le metriche delle prestazioni nella pagina MetricheView performance metrics on the Metrics page

  1. Nel portale di Azure fare clic su Altri servizi, scorrere fino a Database, fare clic su Azure Cosmos DB e quindi fare clic sul nome dell'account Azure Cosmos DB per il quale si vogliono visualizzare le metriche delle prestazioni.In the Azure portal, click More Services, scroll to Databases, click Azure Cosmos DB, and then click the name of the Azure Cosmos DB account for which you would like to view performance metrics.
  2. Una volta caricata la nuova pagina, nel menu delle risorse, sotto Monitoraggio, fare clic su Metriche.When the new page loads, in the resource menu, under Monitoring, click Metrics.
  3. Nella pagina Metriche selezionare la raccolta da esaminare dall'elenco a discesa Raccolte.When the Metrics page opens, select the collection to review from the Collection(s) drop-down.

    Il portale di Azure visualizza l'insieme delle metriche di raccolta disponibili.The Azure portal displays the suite of collection metrics available. Si noti che velocità effettiva, archiviazione, disponibilità, latenza e coerenza delle metriche vengono fornite in schede separate.Note that throughput, storage, availability, latency, and consistency metrics are provided on separate tabs. Per ottenere altre informazioni sulle metriche fornite, fare clic sulla doppia freccia nella parte superiore destra del riquadro di ogni metrica.To get additional detail on the metrics provided, click on the double-arrow in the top right of each metrics pane.

    Schermata della sezione Monitoraggio che mostra la suite di metriche disponibili

Visualizzare le metriche delle prestazioni utilizzando Monitoraggio di AzureView performance metrics by using Azure Monitoring

  1. Nel portale di Azure fare clic su Monitoraggio nella barra degli strumenti a sinistra.In the Azure portal, click Monitor on the left bar.
  2. Nel menu delle risorse fare clic su Metriche.In the resource menu, click Metrics.
  3. Nella finestra Monitoraggio - Metriche selezionare dal menu a discesa Gruppo di risorse il gruppo di risorse associato all'account Azure Cosmos DB da monitorare.In the Monitor - Metrics window, in the Resource group drop-down menu, select the resource group associated with the Azure Cosmos DB account that you'd like to monitor.
  4. Nel menu a discesa Risorsa selezionare l'account di database da monitorare.In the Resource drop-down menu, select the database account to monitor.
  5. Nell'elenco delle Metriche disponibili selezionare le metriche da visualizzare.In the list of Available metrics, select the metrics to display. Utilizzare il tasto CTRL per selezionare più voci.Use the CTRL button to multi-select.

Visualizzare le metriche delle prestazioni nella pagina AccountView performance metrics on the account page

  1. Nel portale di Azure fare clic su Altri servizi, scorrere fino a Database, fare clic su Azure Cosmos DB e quindi fare clic sul nome dell'account Azure Cosmos DB per il quale si vogliono visualizzare le metriche delle prestazioni.In the Azure portal, click More Services, scroll to Databases, click Azure Cosmos DB, and then click the name of the Azure Cosmos DB account for which you would like to view performance metrics.
  2. La sezione Monitoraggio visualizza i seguenti riquadri per impostazione predefinita:The Monitoring lens displays the following tiles by default:

    • Richieste totali per il giorno corrente.Total requests for the current day.
    • Spazio di archiviazione usato.Storage used.

    Schermata della sezione Monitoraggio che mostra le richieste e l'uso delle risorse di archiviazione

  3. Fare clic sulla doppia freccia in alto a destra del riquadro Richieste per aprire una pagina Metrica dettagliata.Clicking on the double-arrow in the top-right of the Requests tile opens a detailed Metric page.
  4. La pagina Metrica mostra i dettagli relativi alle richieste totali.The Metric page shows you details about the total requests.

Configurare gli avvisi nel portaleSet up alerts in the portal

  1. Nel portale di Azure fare clic su Altri servizi, Azure Cosmos DB e infine sul nome dell'account Azure Cosmos DB per cui si vogliono configurare gli avvisi relativi alle metriche delle prestazioni.In the Azure portal, click More Services, click Azure Cosmos DB, and then click the name of the Azure Cosmos DB account for which you would like to set up performance metric alerts.
  2. Nel menu delle risorse fare clic su Regole di avviso per aprire la relativa pagina.In the resource menu, click Alert Rules to open the Alert rules page.
    Screenshot della parte di regole di avviso selezionataScreen shot of the Alert rules part selected
  3. Nella pagina Regole di avviso fare clic su Aggiungi avviso.In the Alert rules page, click Add alert.
    Schermata della pagina Regole di avviso, con il pulsante Aggiungi avviso evidenziatoScreenshot of the Alert Rules page, with the Add Alert button highlighted
  4. Nella pagina Aggiungi una regola di avviso specificare:In the Add an alert rule page, specify:

    • Il nome della regola di avviso che si sta configurando.The name of the alert rule you are setting up.
    • Una descrizione della nuova regola di avviso.A description of the new alert rule.
    • La metrica per la regola di avviso.The metric for the alert rule.
    • Condizione, soglia e periodo per l'attivazione della regola.The condition, threshold, and period that determine when the alert activates. Ad esempio, un numero di errori del server maggiore di 5 negli ultimi 15 minuti.For example, a server error count greater than 5 over the last 15 minutes.
    • Se deve essere inviato un messaggio di posta elettronica all'amministratore del servizio e ai coamministratori quando viene attivata la regola.Whether the service administrator and coadministrators are emailed when the alert fires.
    • Indirizzi di posta elettronica aggiuntivi per le notifiche degli avvisi.Additional email addresses for alert notifications.
      Schermata della pagina Aggiungi una regola di avviso

Monitorare Azure Cosmos DB a livello di codiceMonitor Azure Cosmos DB programmatically

Le metriche di livello di account disponibili nel portale, quali richieste di utilizzo e il totale di archiviazione account, non sono disponibili tramite le API di SQL.The account level metrics available in the portal, such as account storage usage and total requests, are not available via the SQL APIs. Tuttavia, è possibile recuperare i dati di utilizzo a livello di raccolta utilizzando le API di SQL.However, you can retrieve usage data at the collection level by using the SQL APIs. Per recuperare i dati a livello di raccolta, eseguire le operazioni seguenti:To retrieve collection level data, do the following:

Per accedere a metriche aggiuntive, usare l'SDK di Monitoraggio di Azure.To access additional metrics, use the Azure Monitor SDK. Le definizioni delle metriche disponibili possono essere recuperate chiamando:Available metric definitions can be retrieved by calling:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/metricDefinitions?api-version=2015-04-08

Le query per recuperare le singole metriche usano il formato seguente:Queries to retrieve individual metrics use the following format:

https://management.azure.com/subscriptions/{SubecriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/metrics?api-version=2015-04-08&$filter=%28name.value%20eq%20%27Total%20Requests%27%29%20and%20timeGrain%20eq%20duration%27PT5M%27%20and%20startTime%20eq%202016-06-03T03%3A26%3A00.0000000Z%20and%20endTime%20eq%202016-06-10T03%3A26%3A00.0000000Z

Per altre informazioni, vedere Retrieving Resource Metrics via the Azure Insights API(Recupero delle metriche delle risorse tramite l'API REST del Monitoraggio di Azure).For more information, see Retrieving Resource Metrics via the Azure Monitor REST API. Si noti che il nuovo nome di Azure Insights è Monitoraggio di Azure.Note that "Azure Insights" was renamed "Azure Monitor". Nel blog si usa ancora il nome precedente.This blog entry refers to the older name.

Passaggi successiviNext steps

Per altre informazioni sulla pianificazione della capacità di Azure Cosmos DB, vedere lo strumento di calcolo Capacity Planner di Azure Cosmos DB.To learn more about Azure Cosmos DB capacity planning, see the Azure Cosmos DB capacity planner calculator.