Integrazione di Azure Monitor con Azure Cosmos DB

Le informazioni dettagliate su Azure Cosmos DB offrono una visualizzazione delle prestazioni complessive, degli errori, della capacità e dell'integrità operativa di tutte le risorse di 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.

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à, latenza, il sistema e le metriche delle operazioni di gestione. Il riquadro mostra queste metriche per ogni contenitore 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.

   

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

   • Velocità effettiva. Questa scheda visualizza il numero totale di unità di richiesta utilizzate o che hanno fallito (codice di risposta 429) a causa del superamento della capacità di elaborazione o della capacità di archiviazione provisionate per il contenitore.

   • Richieste. 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 successo.

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

   

3. Selezionare 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.

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 Richieste per aprire la parte Richieste del modello di cartella di lavoro. Mostra le richieste totali con la distribuzione delle risposte che compongono tali richieste:

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

Immagazzinamento

Selezionare la scheda Archiviazione per aprire la parte Archiviazione del modello di cartella di lavoro. Mostra quanto riportato di seguito:

• Quantità di documenti disponibili.
• Crescita dei documenti nel tempo.
• Utilizzo dati attuale.
• Quantità totale di spazio di archiviazione disponibile rimanente.

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

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.

Visualizzare da una risorsa Azure Cosmos DB

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

   

2. Dopo aver eseguito il passaggio all'account Azure Cosmos DB, passare alla sezione Monitoraggio e selezionare Insights (anteprima) o Cartelle di lavoro. Queste opzioni consentono di analizzare velocità effettiva, richieste, archiviazione, disponibilità, latenza, sistema e gestione degli account.

   

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 ovunque dagli ultimi cinque minuti agli ultimi sette 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.

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 (429 risposte)

• 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à nel grafico sono una somma delle richieste totali per il periodo.

  

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

  

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

  

Personalizzare le metriche

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

Per esportare i dati nel formato Excel, aprire il menu di scelta rapida.

Per espandere o comprimere tutte le visualizzazioni a discesa nella cartella di lavoro, aprire il menu di scelta rapida.

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.

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.

Risoluzione dei problemi

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

Contenuti correlati

• Configurare gli avvisi delle metriche
• Abilitare le notifiche sull'integrità dei servizi.
• Crea report con cartelle di lavoro.