Esplorare informazioni dettagliate di Monitoraggio di Azure di Azure Cosmos DB

Le informazioni dettagliate di Azure Cosmos DB offrono una visualizzazione delle prestazioni complessive, degli errori, della capacità e dell'integrità operativa di tutte le risorse Azure Cosmos DB in un'esperienza interattiva unificata. Questo articolo consente di comprendere i vantaggi di questa nuova esperienza di monitoraggio e di come è possibile modificarla e adattarla per soddisfare le esigenze specifiche dell'organizzazione.

Introduzione

Prima di iniziare, è necessario comprendere come vengono presentate e visualizzate le informazioni.

Offre:

  • Prospettiva su larga scala delle risorse Azure Cosmos DB di tutte le sottoscrizioni in un'unica posizione. È possibile definire l'ambito in modo selettivo solo per le sottoscrizioni e le risorse che si desidera valutare.
  • Analisi drill-down di una determinata risorsa di Azure Cosmos DB. È possibile diagnosticare i problemi o eseguire analisi dettagliate usando le categorie di utilizzo, errori, capacità e operazioni. Selezionando una delle opzioni si ottiene una visualizzazione di profondità delle metriche Azure Cosmos DB rilevanti.
  • Esperienza personalizzabile basata sui modelli delle cartelle di lavoro di Monitoraggio di Azure. È possibile modificare le metriche visualizzate, modificare o impostare le soglie in linea con i limiti e quindi salvarle in una cartella di lavoro personalizzata. I grafici nelle cartelle di lavoro possono quindi essere aggiunti ai dashboard di Azure.

Questa funzionalità non richiede di abilitare o configurare alcunché. Queste metriche di Azure Cosmos DB vengono raccolte per impostazione predefinita.

Nota

Non è previsto alcun addebito per accedere a questa funzionalità. Verranno addebitate solo le funzionalità essenziali di Monitoraggio di Azure configurate o abilitate, come descritto nella pagina di dettagli sui prezzi di Monitoraggio di Azure.

Visualizzare informazioni dettagliate dal portale di Azure

  1. Accedere al portale di Azure e passare all'account Azure Cosmos DB.

  2. È possibile visualizzare le metriche del proprio account dal riquadro Metriche o dal riquadro Informazioni dettagliate.

    • Metriche: in questo riquadro sono presenti valori numerici che vengono raccolti a intervalli regolari e che descrivono un aspetto di un sistema in un determinato momento. Ad esempio, è possibile visualizzare e monitorare la metrica della latenza lato server, la metrica di utilizzo delle unità richiesta normalizzate e così via.

    • Informazioni dettagliate: questo riquadro offre un'esperienza di monitoraggio personalizzata per Azure Cosmos DB. Questo riquadro usa le stesse metriche e gli stessi log raccolti in Monitoraggio di Azure e mostra una visualizzazione aggregata per l'account.

  3. Aprire il riquadro Informazioni dettagliate. Per impostazione predefinita, il riquadro Informazioni dettagliate mostra la velocità effettiva, le richieste, l'archiviazione, la disponibilità, la latenza, il sistema e le metriche delle operazioni di gestione per ogni contenitore presente nell'account. È possibile selezionare i parametri di Intervallo di tempo , Database e Contenitore per cui si desidera visualizzare informazioni dettagliate. La scheda Panoramica mostra il consumo di UR/sec, dati e indici, le richieste limitate e il consumo di UR/sec normalizzate per il database e il contenitore selezionati.

    Screenshot delle metriche delle prestazioni di Azure Cosmos DB nel portale di Azure.

  4. Nel pannello Informazioni dettagliate sono disponibili le metriche seguenti:

    • Velocità effettiva. Questa scheda mostra il numero totale di unità richiesta usate o non riuscite (codice di risposta 429) perché è stata superata la velocità effettiva o la capacità di archiviazione con provisioning per il contenitore.

    • Requests. Questa scheda mostra il numero totale di richieste elaborate per codice di stato, tipo di operazione e numero di richieste non riuscite (codice di risposta 429). Le richieste hanno esito negativo quando viene superata la velocità effettiva o la capacità di archiviazione con provisioning per il contenitore.

    • Archiviazione. Questa scheda mostra le dimensioni dei dati e il consumo degli indici nel periodo di tempo selezionato.

    • Disponibilità. Questa scheda mostra la percentuale di richieste riuscite rispetto al totale delle richieste all'ora. I contratti di servizio di Azure Cosmos DB definiscono la percentuale di riuscita.

    • Latenza. Questa scheda mostra la latenza di lettura e scrittura osservata da Azure Cosmos DB nell'area in cui è operativo l'account. Per un account con replica geografica, è possibile visualizzare la latenza tra aree. È possibile visualizzare anche la latenza lato server in base a operazioni diverse. Questa metrica non rappresenta la latenza delle richieste end-to-end.

    • Sistema. Questa scheda mostra il numero di richieste di metadati gestite nella partizione primaria. Consente anche di identificare le richieste limitate.

    • Operazioni di gestione. Questa scheda mostra le metriche relative alle attività di gestione dell'account, come la creazione o l'eliminazione dell'account, gli aggiornamenti delle chiavi e le impostazioni di rete e di replica.

Visualizzare le metriche di uso e prestazioni per Azure Cosmos DB

Per visualizzare l'utilizzo e le prestazioni degli account di archiviazione di tutte le sottoscrizioni:

  1. Accedere al portale di Azure.

  2. Cercare Monitoraggio e selezionare Monitoraggio.

    Screenshot che mostra la casella di ricerca con la parola

  3. Selezionare Azure Cosmos DB.

    Screenshot che mostra la cartella di lavoro Panoramica di Azure Cosmos DB.

Panoramica

Nella pagina Panoramica la tabella mostra le metriche interattive di Azure Cosmos DB. È possibile filtrare i risultati in base alle opzioni selezionate dagli elenchi a discesa seguenti:

  • Sottoscrizioni: sono elencate solo le sottoscrizioni con una risorsa Azure Cosmos DB.
  • Azure Cosmos DB: è possibile selezionare tutte le risorse di Azure Cosmos DB, un subset o una singola risorsa.
  • Intervallo di tempo: per impostazione predefinita, le ultime quattro ore di informazioni vengono mostrate in base alle selezioni corrispondenti effettuate.

Il riquadro del contatore sotto gli elenchi a discesa esegue il rollup del numero totale di risorse di Azure Cosmos DB incluse nelle sottoscrizioni selezionate. La codifica con colori condizionale o le mappe termiche per le colonne nella cartella di lavoro riportano metriche di transazioni. Il colore più scuro ha il valore più alto. Un colore più chiaro si basa sui valori più bassi.

Selezionare la freccia dell'elenco a discesa di una delle risorse di Azure Cosmos DB per visualizzare il dettaglio delle metriche di prestazioni al livello del singolo contenitore di database.

Screenshot che mostra l'elenco a discesa espanso contenente i singoli contenitori di database e il dettaglio delle prestazioni associato.

Selezionare il nome della risorsa di Azure Cosmos DB evidenziato in blu per accedere alla pagina Panoramica predefinita dell'account Azure Cosmos DB associato.

Errori

Selezionare la scheda Errori per aprire la sezione Errori del modello della cartella di lavoro. Mostra le richieste totali con la distribuzione delle risposte che compongono tali richieste:

Screenshot che mostra gli errori con il dettaglio per tipo di richiesta HTTP.

Codice Descrizione
200 OK Una delle operazioni REST seguenti ha avuto esito positivo:
- GET su una risorsa.
- PUT su una risorsa.
- POST su una risorsa.
- POST su una risorsa di stored procedure per eseguire la stored procedure.
201 Created Un'operazione POST per creare una risorsa ha esito positivo.
404 Not Found L'operazione tenta di agire su una risorsa che non esiste più. Ad esempio, è possibile che la risorsa sia stata già eliminata.

Per un elenco completo dei codici di stato, vedere Codici di stato HTTP per Azure Cosmos DB.

Capacità

Selezionare la scheda Capacità per aprire la sezione Capacità del modello della cartella di lavoro. Mostra quanto riportato di seguito:

  • Numero di documenti disponibili.
  • Crescita del documento nel tempo.
  • Utilizzo dei dati.
  • Quantità totale di spazio di archiviazione disponibile rimasto.

Queste informazioni consentono di identificare potenziali problemi di archiviazione e utilizzo dei dati.

Screenshot che mostra la cartella di lavoro Capacità.

Come per la cartella di lavoro Panoramica, selezionando l'elenco a discesa accanto a una risorsa di Azure Cosmos DB nella colonna Sottoscrizione viene mostrato il dettaglio in base ai singoli contenitori che costituiscono il database.

Operazioni

Selezionare la scheda Operazioni per aprire la sezione Operazioni del modello della cartella di lavoro. È possibile visualizzare le richieste suddivise per tipo di richiesta effettuata.

Nell'esempio seguente è possibile notare che eastus-billingint riceve principalmente richieste di lettura, ma con alcune richieste di upsert e creazione. È possibile notare anche che westeurope-billingint è di sola lettura dal punto di vista della richiesta, almeno nelle ultime quattro ore in cui la cartella di lavoro è attualmente definita come ambito tramite il parametro intervallo di tempo.

Screenshot che mostra la cartella di lavoro Operazioni.

Visualizzare da una risorsa Azure Cosmos DB

  1. Cercare o selezionare uno degli account Azure Cosmos DB esistenti.

    Screenshot che mostra la ricerca di Azure Cosmos DB.

  2. Dopo aver spostato nell'account Azure Cosmos DB, nella sezione Monitoraggio selezionare Dati analitici (anteprima) o Cartelle di lavoro. È ora possibile eseguire ulteriori analisi sulla velocità effettiva, le richieste, l'archiviazione, la disponibilità, latenza, il sistema e la gestione degli account.

    Screenshot che mostra la pagina Panoramica delle informazioni dettagliate di Azure Cosmos DB Insights.

Intervallo di tempo

Per impostazione predefinita, il campo Intervallo di tempo mostra i dati delle ultime 24 ore. È possibile modificare l'intervallo di tempo per visualizzare i dati di un qualsiasi periodo tra gli ultimi 5 minuti e gli ultimi 7 giorni. Il selettore dell'intervallo di tempo include anche una modalità personalizzata. Immettere le date di inizio/fine per visualizzare un intervallo di tempo personalizzato in base ai dati disponibili per l'account selezionato.

Screenshot che mostra l'intervallo di tempo di Azure Cosmos DB.

Panoramica delle informazioni dettagliate

La scheda panoramica fornisce le metriche più comuni per l'account Azure Cosmos DB selezionato, tra cui:

  • Richieste totali
  • Richieste non riuscite (429s)
  • Consumo UR normalizzato (massimo)
  • Utilizzo dati e indice
  • Metriche dell'account Azure Cosmos DB per raccolta

Richieste totali: questo grafico offre una visualizzazione delle richieste totali per l'account suddivise in base al codice di stato. Le unità nella parte inferiore del grafico sono una somma delle richieste totali per il periodo.

Screenshot che mostra il grafo Totale richieste di Azure Cosmos DB.

Richieste non riuscite (429s): questo grafico fornisce una visualizzazione delle richieste non riuscite con un codice di stato 429. Le unità nella parte inferiore del grafico sono una somma delle richieste totali per il periodo.

Screenshot che mostra il grafo Richieste non riuscite di Azure Cosmos DB.

Consumo normalizzato di UR (max): questo grafico fornisce la percentuale massima compresa tra lo 0 e il 100% delle unità di consumo di UR normalizzate per il periodo specificato.

Screenshot che mostra il grafo Consumo UR normalizzato di Azure Cosmos DB.

Aggiungere, esportare ed espandere

È possibile aggiungere una qualsiasi delle sezioni di metriche a un dashboard di Azure selezionando la puntina da disegno nell’angolo in alto a destra della sezione.

Screenshot che mostra l'esempio di aggiunta della sezione delle metriche al dashboard.

Per esportare i dati in formato Excel, selezionare la freccia in basso a sinistra della puntina da disegno.

Screenshot che mostra la freccia giù dell'opzione Esporta cartella di lavoro.

Per espandere o comprimere tutte le viste a discesa nella cartella di lavoro, selezionare la freccia di espansione a sinistra della freccia verso il basso.

Screenshot che mostra la freccia dell'opzione Espandi cartella di lavoro.

Personalizzare le informazioni dettagliate su Azure Cosmos DB

Questa esperienza si basa sui modelli delle cartelle di lavoro di Monitoraggio di Azure. È possibile usare Personalizza>Modifica>Salva per modificare e salvare una copia della versione modificata in una cartella di lavoro personalizzata.

Screenshot che mostra il pulsante Personalizza.

Le cartelle di lavoro vengono salvate all'interno di un gruppo di risorse. La sezione Report personali è privata. La sezione Report condivisi è accessibile a chiunque abbia accesso al gruppo di risorse. Dopo aver salvato la cartella di lavoro personalizzata, per avviarla è necessario passare alla raccolta di cartelle di lavoro.

Screenshot che mostra il pulsante Raccolta.

Risoluzione dei problemi

Per indicazioni sulla risoluzione dei problemi, vedere Risoluzione dei problemi relativi alle informazioni dettagliate basate su cartelle di lavoro.

Passaggi successivi