Monitorare Azure Cosmos DB

L'articolo illustra:

• I tipi di dati di monitoraggio che è possibile raccogliere per questo servizio.
• Modi per analizzare i dati.

Quando si hanno applicazioni e processi di business critici che si basano sulle risorse di Azure, è necessario monitorare e ricevere avvisi per il sistema. Il servizio Monitoraggio di Azure raccoglie e aggrega metriche e log da ogni componente del sistema. Il Monitoraggio di Azure offre una visione sulla disponibilità, le prestazioni e la resilienza e notifica i problemi. È possibile usare il portale di Azure, PowerShell, l'interfaccia della riga di comando di Azure, l'API REST o le librerie client per configurare e visualizzare i dati di monitoraggio.

• Per altre informazioni sul monitoraggio di Azure, vedere Informazioni generali sul Monitoraggio di Azure.
• Per altre informazioni su come monitorare le risorse di Azure in generale, vedere Monitorare le risorse di Azure con Monitoraggio di Azure.

Informazioni dettagliate

Per alcuni servizi di Azure, nel portale di Azure è disponibile un dashboard di monitoraggio predefinito che fornisce un punto iniziale per il monitoraggio del servizio. Questi dashboard sono denominati informazioni dettagliate ed è possibile trovarli nell'hub di Insights del Monitoraggio di Azure nel portale di Azure.

Informazioni dettagliate su Azure Cosmos DB

Informazioni dettagliate su Azure Cosmos DB è una funzionalità basata sulla funzionalità cartelle di lavoro di Monitoraggio di Azure. Utilizzare le informazioni dettagliate di Azure Cosmos DB per 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.

Per altre informazioni dettagliate su Azure Cosmos DB, vedere gli articoli seguenti:

• Esplorare le informazioni dettagliate su Azure Cosmos DB
• Eseguire il monitoraggio e il debug con informazioni dettagliate in Azure Cosmos DB.

Tipi di risorsa

Azure usa il concetto di tipi di risorse e ID per identificare tutti gli elementi in una sottoscrizione. I tipi di risorse fanno anche parte degli ID della risorsa per ogni risorsa in esecuzione in Azure. Ad esempio, un tipo di risorsa per una macchina virtuale è Microsoft.Compute/virtualMachines. Per un elenco dei servizi e dei relativi tipi di risorse associati, vedere Provider di risorse.

Il Monitoraggio di Azure organizza in modo analogo i dati di monitoraggio di base in metriche e log in base ai tipi di risorse, detti anche spazi dei nomi. Sono disponibili metriche e log diversi per diversi tipi di risorse. Il servizio potrebbe essere associato a più tipi di risorse.

Per altre informazioni sui tipi di risorse per Azure Cosmos DB, vedere Riferimento ai dati di Monitoraggio di Azure Cosmos DB.

Archiviazione di dati

Per il Monitoraggio di Azure:

• I dati delle metriche vengono archiviati dal database di metriche del Monitoraggio di Azure.
• I dati di log vengono archiviati nell'archivio dei log del Monitoraggio di Azure. Log Analytics è uno strumento nel portale di Azure in grado di eseguire query su questo archivio.
• Il log attività di Azure è un archivio separato con la propria interfaccia nel portale di Azure.

Facoltativamente, è possibile instradare i dati delle metriche e dei log attività all'archivio dei log di Monitoraggio di Azure. È quindi possibile usare Analisi dei log per eseguire query sui dati e correlarli con altri dati di log.

Molti servizi possono usare le impostazioni di diagnostica per inviare i dati delle metriche e dei log ad altre posizioni di archiviazione all'esterno di Monitoraggio di Azure. Gli esempi includono Archiviazione di Azure, sistemi partner ospitati e sistemi partner non Azure usando Hub eventi.

Per informazioni dettagliate su come il Monitoraggio di Azure archivia i dati, vedere la piattaforma dati del Monitoraggio di Azure.

Metriche della piattaforma del Monitoraggio di Azure

Il Monitoraggio di Azure fornisce metriche della piattaforma per la maggior parte dei servizi. Le metriche sono:

• Definite singolarmente per ogni spazio dei nomi.
• Archiviate in un database delle metriche di serie temporali del Monitoraggio di Azure.
• Leggere e in grado di creare avvisi in tempo quasi reale.
• Usate per tenere traccia delle prestazioni di una risorsa nel tempo.

Raccolta: il Monitoraggio di Azure raccoglie automaticamente le metriche della piattaforma. Non è richiesta alcuna configurazione.

Routing: è anche possibile instradare alcune metriche della piattaforma ai log di Monitoraggio di Azure/Log Analytics per poterle eseguire query con altri dati di log. Controllare l'impostazione di esportazione DS per ogni metrica per verificare se è possibile usare un'impostazione di diagnostica per instradare la metrica ai log di Monitoraggio di Azure/Log Analytics.

• Per altre informazioni, vedere impostazioni delle metriche di diagnostica.
• Per configurare le impostazioni di diagnostica per un servizio, vedere Creare impostazioni di diagnostica in Monitoraggio di Azure.

Per un elenco di tutte le metriche che è possibile raccogliere per tutte le risorse nel Monitoraggio di Azure, vedere Metriche supportate nel Monitoraggio di Azure.

Monitoraggio di Azure raccoglie le metriche di Azure Cosmos DB per impostazione predefinita. Non è necessario configurare in modo esplicito alcun elemento. La maggior parte delle metriche è disponibile nella pagina del portale di Azure Cosmos DB o nella pagina Monitoraggio di Azure. Per impostazione predefinita, le metriche vengono raccolte con la granularità di un minuto. La granularità può variare in base alla metrica scelta. Per altre informazioni sul periodo di conservazione predefinito, vedere Conservazione delle metriche di Monitoraggio di Azure

Le metriche lato server di Azure Cosmos DB includono velocità effettiva, archiviazione, disponibilità, latenza, coerenza e metriche a livello di sistema. Sul lato client è possibile raccogliere i dettagli per l'addebito delle richieste, l'ID attività, le informazioni di analisi dell'eccezione e dello stack, lo stato HTTP, il codice dello stato secondario e la stringa di diagnostica. Per impostazione predefinita, queste metriche hanno un periodo di conservazione di sette giorni. È possibile utilizzare questi dati per eseguire il debug dei problemi o se è necessario contattare il team di supporto di Azure Cosmos DB.

I valori delle dimensioni per le metriche, ad esempio il nome del contenitore, non fanno distinzione tra maiuscole e minuscole. Questa situazione può causare confusione o collisione di dati di telemetria e azioni sui contenitori con tali nomi. Confronto senza distinzione tra maiuscole e minuscole quando si eseguono confronti di stringhe su questi valori di dimensione.

Per un elenco delle metriche disponibili per Azure Cosmos DB, vedere Riferimento ai dati di Monitoraggio di Azure Cosmos DB.

Metriche non basate su Monitoraggio di Azure

Questo servizio fornisce altre metriche non incluse nel database delle metriche di Monitoraggio di Azure.

• Per informazioni sulle soluzioni e sugli strumenti dei partner che consentono di monitorare Azure Cosmos DB, vedere Monitorare Azure Cosmos DB con soluzioni di terze parti.
• Per implementare le metriche di Micrometer in Java SDK per Azure Cosmos DB utilizzando le metriche Prometheus, vedere Utilizzare metriche client di Micrometer per Java.

Log delle risorse di Monitoraggio di Azure

I log delle risorse forniscono informazioni dettagliate sulle operazioni eseguite da una risorsa di Azure. I log vengono generati automaticamente, ma è necessario indirizzarli verso i log del Monitoraggio di Azure per salvarli o interrogarli. I log sono organizzati in categorie. Uno specifico spazio dei nomi potrebbe avere più categorie di log delle risorse.

Raccolta: i log delle risorse non vengono raccolti e archiviati fino a quando non si crea un'impostazione di diagnostica e li si instrada verso una o più posizioni. Quando si crea un'impostazione di diagnostica, si specificano quali categorie di log raccogliere. Esistono diversi modi per creare e gestire le impostazioni di diagnostica, tra cui il portale di Azure, il livello programmatico e anche i Criteri di Azure.

Pianificazione percorso: l'impostazione predefinita consigliata consiste nell'instradare i log delle risorse verso i log del Monitoraggio di Azure in modo da poterli interrogare con altri dati di log. Sono disponibili anche altre posizioni, ad esempio Archiviazione di Azure, Hub eventi di Azure e alcuni partner di monitoraggio Microsoft. Per altre informazioni, vedere Log delle risorse di Azure e Destinazioni del log delle risorse.

Per informazioni dettagliate sulla raccolta, l'archiviazione e la pianificazione percorso dei log delle risorse, vedere Impostazioni di diagnostica nel Monitoraggio di Azure.

Per un elenco di tutte le categorie di log delle risorse disponibili nel Monitoraggio di Azure, vedere Log delle risorse supportati nel Monitoraggio di Azure.

Tutti i log delle risorse nel Monitoraggio di Azure hanno gli stessi campi d'intestazione, seguiti da campi specifici del servizio. Lo schema comune è descritto in Schema dei log delle risorse di Monitoraggio di Azure.

Da Monitoraggio di Azure, è possibile monitorare i log di diagnostica dall'account Azure Cosmos DB e creare dashboard. I dati, ad esempio eventi e tracce con una granularità nell'ordine del secondo, vengono archiviati come log. Ad esempio, se la velocità effettiva di un contenitore cambia, le proprietà di un account Azure Cosmos DB cambiano. I log acquisiscono questi eventi. È possibile analizzare questi log eseguendo query sui dati raccolti.

Per le categorie di log delle risorse disponibili, le tabelle di Log Analytics associate e gli schemi dei log per Azure Cosmos DB, vedere Riferimento ai dati di monitoraggio di Azure Cosmos DB.

Finestra Log attività di Azure

Il log attività contiene eventi a livello di sottoscrizione che tengono traccia delle operazioni per ogni risorsa di Azure vista dall'esterno, ad esempio la creazione di una nuova risorsa o l'avvio di una macchina virtuale.

Raccolta: gli eventi del log attività vengono generati e raccolti automaticamente in un archivio separato per la visualizzazione nel portale di Azure.

Pianificazione percorso: è possibile inviare i dati del log attività ai log di Monitoraggio di Azure in modo da poterli analizzare insieme ad altri dati di log. Sono disponibili anche altre posizioni, ad esempio Archiviazione di Azure, Hub eventi di Azure e alcuni partner di monitoraggio Microsoft. Per altre informazioni su come instradare i log attività, vedere Informazioni generali sul log attività di Azure.

Controllare le azioni di ripristino per la modalità di backup continuo

Usando i log attività, è possibile elencare tutti i ripristini temporizzati per la modalità continua eseguiti in un account Azure Cosmos DB. Per informazioni su come visualizzare queste operazioni nel portale di Azure, vedere Controllare l'azione di ripristino temporizzato per la modalità di backup continuo.

Analizzare i dati di monitoraggio

Sono disponibili molti strumenti per l'analisi dei dati di monitoraggio.

Strumenti di Monitoraggio di Azure

Il Monitoraggio di Azure supporta gli strumenti di base seguenti:

• Esplora metriche, uno strumento nel portale di Azure che consente di visualizzare e analizzare le metriche per le risorse di Azure. Per altre informazioni, vedere Analizzare le metriche con Esplora metriche di Monitoraggio di Azure.

• Log Analytics, uno strumento nel portale di Azure che consente di eseguire query e analizzare i dati di log usando il linguaggio di query Kusto (KQL). Per altre informazioni, vedere Introduzione alle query dei log del Monitoraggio di Azure.

• Log attività, che dispone di un'interfaccia utente nel portale di Azure per la visualizzazione e le ricerche di base. Per eseguire analisi più approfondite, è necessario instradare i dati verso i log di Monitoraggio di Azure ed eseguire query più complesse in Log Analytics.

Gli strumenti che consentono una visualizzazione più complessa includono:

• I dashboard che consentono di combinare tipi di dati diversi in un singolo riquadro nel portale di Azure.
• Cartelle di lavoro, report personalizzabili che è possibile creare nel portale di Azure. Le cartelle di lavoro possono includere testo, metriche e query di log.
• Grafana è una piattaforma aperta, ideale per i dashboard operativi. È possibile usare Grafana per creare dashboard che includano dati da più origini diverse dal Monitoraggio di Azure.
• Power BI, un servizio di analisi aziendale che fornisce visualizzazioni interattive per un'ampia varietà di origini dati. È possibile configurare per Power BI per importare automaticamente i dati di log da Monitoraggio di Azure per sfruttare i vantaggi di queste visualizzazioni.

Strumenti di esportazione del Monitoraggio di Azure

È possibile ottenere dati dal Monitoraggio di Azure in altri strumenti usando i metodi seguenti:

• Metriche: usare l'API REST per le metriche per estrarre i dati delle metriche dal database delle metriche del Monitoraggio di Azure. L'API supporta espressioni di filtro per perfezionare i dati recuperati. Per altre informazioni, vedere Informazioni di riferimento sull'API REST del Monitoraggio di Azure.

• Log: usare l'API REST o le librerie client associate.

• Un'altra opzione è l'esportazione dati dell'area di lavoro.

Per iniziare a usare l'API REST per il Monitoraggio di Azure, vedere Procedura dettagliata per l'API REST del Monitoraggio di Azure.

Analizzare le metriche di Azure Cosmos DB

È possibile usare Esplora metriche di Monitoraggio di Azure per analizzare le metriche di Azure Cosmos DB con le metriche di altri servizi di Azure: nel portale degli account di Azure Cosmos DB, in Monitoraggio, selezionare Metriche. Per altre informazioni su come utilizzare Esplora metriche, vedere Analizzare le metriche con Esplora metriche di Monitoraggio di Azure.

È possibile monitorare la latenza lato server, l'utilizzo dell'unità richiesta e l'utilizzo normalizzato dell'unità richiesta per le risorse di Azure Cosmos DB. È possibile selezionare metriche specifiche per unità richiesta, archiviazione, latenza, disponibilità, Cassandra e altre.

Sul lato client è possibile eseguire il debug dei problemi raccogliendo le metriche per l'addebito delle richieste, l'ID attività, le informazioni di analisi dell'eccezione e dello stack, lo stato HTTP, il codice dello stato secondario e la stringa di diagnostica.

Per altre informazioni e istruzioni dettagliate, vedere gli articoli seguenti:

• Monitorare la latenza lato server
• Monitorare l'utilizzo dell'unità richiesta
• Monitorare l'utilizzo dell'unità richiesta normalizzata

Per un elenco di tutte le metriche delle risorse supportate in Monitoraggio di Azure, vedere Metriche supportate di Monitoraggio di Azure. Per un elenco delle metriche della piattaforma raccolte per Azure Cosmos DB, vedere l'articolo Informazioni di riferimento sui dati di Monitoraggio di Azure Cosmos DB - Metriche.

Monitorare Azure Cosmos DB a livello di codice

Le metriche a livello di account disponibili nel portale, ad esempio l'utilizzo dell'archiviazione dell'account e le richieste totali, non sono disponibili usando l'API per NoSQL. Tuttavia, è possibile recuperare i dati di utilizzo a livello di raccolta usando l'API per NoSQL. Per recuperare i dati a livello di raccolta, usare uno degli approcci seguenti:

• Per usare l'API REST, eseguire il comando GET sulla raccolta. Le informazioni sulla quota e sull'utilizzo per la raccolta vengono restituite nelle intestazioni x-ms-resource-quota e x-ms-resource-usage nella risposta.

• Per usare .NET SDK, usare il metodo DocumentClient.ReadDocumentCollectionAsync, che restituisce un oggetto ResourceResponse contenente numerose proprietà di utilizzo, ad esempio CollectionSizeUsage, DatabaseUsage e DocumentUsage.

Per accedere a metriche aggiuntive, usare Azure Monitor SDK. Le definizioni delle metriche disponibili possono essere recuperate usando questo formato:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01

Per recuperare le singole metriche, usare il formato seguente:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metrics?timespan={StartTime}/{EndTime}&interval={AggregationInterval}&metricnames={MetricName}&aggregation={AggregationType}&`$filter={Filter}&api-version=2018-01-01

Per altre informazioni, vedere API REST di monitoraggio di Azure.

Analizzare i log di Azure Cosmos DB

I dati nei log di Monitoraggio di Azure vengono archiviati nelle tabelle. Ogni tabella ha un proprio set di proprietà univoco. Tutti i log delle risorse in Monitoraggio di Azure hanno gli stessi campi seguiti da campi specifici del servizio. Lo schema comune è descritto in Schema dei log delle risorse di Monitoraggio di Azure.

Per conoscere i tipi di log delle risorse raccolti per Azure Cosmos DB, vedere Riferimento ai dati di Monitoraggio di Azure Cosmos DB.

Per altre informazioni sull'uso dei log di Monitoraggio di Azure per Azure Cosmos DB, vedere gli articoli seguenti:

• Monitorare i dati usando le impostazioni di diagnostica di Azure
• Controllare i log del piano di controllo
• Aggiungere una trasformazione per i dati dell'area di lavoro

Query Kusto

È possibile analizzare i dati di monitoraggio nell'archivio dei Log/Log Analytics del Monitoraggio di Azure usando il linguaggio di query Kusto (KQL).

Per un elenco delle query comuni per qualsiasi servizio, vedere l'interfaccia query di Analisi dei log.

Prima di usare Log Analytics per eseguire query Kusto, è necessario abilitare i log di diagnostica per le operazioni del piano di controllo. Quando si abilitano i log di diagnostica, è possibile scegliere tra l'archiviazione dei dati in tabelle specifiche delle risorse o la singola tabella AzureDiagnostics (legacy). Il testo esatto delle query Kusto dipende dalla modalità di raccolta selezionata.

• Vedere Risolvere i problemi relativi alle query di diagnostica per query semplici per risolvere i problemi relativi ad Azure Cosmos DB.
• Vedere Risolvere i problemi relativi alle query di diagnostica avanzate con Azure Cosmos DB for NoSQL per query più complesse per risolvere i problemi relativi all'account Azure Cosmos DB usando i log di diagnostica inviati alle tabelle di Diagnostica di Azure (legacy) e specifiche delle risorse (anteprima).

Di seguito sono riportate alcune query che è possibile immettere nella barra di ricerca Ricerca log per consentire il monitoraggio delle risorse Azure Cosmos DB.

CDBControlPlaneRequests

CDBDataPlaneRequests

CDBDataPlaneRequests
| where AccountName=="<account-name>"

CDBDataPlaneRequests
| summarize count() by AccountName

CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart

AzureDiagnostics
| where ResourceProvider=="MICROSOFT.DOCUMENTDB"
| where Category=="ControlPlaneRequests"

AzureDiagnostics
| where ResourceProvider=="MICROSOFT.DOCUMENTDB"
| where Category=="DataPlaneRequests"

AzureDiagnostics
| where ResourceProvider=="MICROSOFT.DOCUMENTDB"
| where Category=="DataPlaneRequests"
| where Resource=="<account-name>"

AzureDiagnostics
| where ResourceProvider=="MICROSOFT.DOCUMENTDB"
| where Category=="DataPlaneRequests"
| summarize count() by Resource

AzureDiagnostics
| where ResourceProvider=="MICROSOFT.DOCUMENTDB"
| where Category=="DataPlaneRequests"
| summarize count() by OperationName
| render columnchart

Per le query Kusto che è possibile utilizzare per risolvere i problemi relativi ad Azure Cosmos DB, vedere gli articoli seguenti:

• Risolvere i problemi usando query di base
• Risolvere i problemi usando query di diagnostica avanzate

Questi esempi sono solo una piccola parte delle query avanzate che è possibile eseguire in Monitoraggio di Azure utilizzando il Linguaggio di query Kusto (KQL). Per altri esempi, vedere esempi per le query Kusto.

Avvisi

Gli avvisi di Monitoraggio di Azure notificano in modo proattivo quando vengono riscontrate condizioni specifiche nei dati di monitoraggio. Consentono di identificare e risolvere i problemi del sistema prima che gli utenti li notino. Per altre informazioni, vedere Avvisi di Monitoraggio di Azure.

Esistono molte origini di avvisi comuni per le risorse di Azure. Per esempi di avvisi comuni per le risorse di Azure, vedere Query di avviso di log di esempio. Il sito Avvisi di base di Monitoraggio di Azure (AMBA) offre un metodo semi-automatizzato per implementare importanti avvisi, dashboard e linee guida per le metriche della piattaforma. Il sito si applica a un sottoinsieme di servizi di Azure in continua espansione, inclusi tutti i servizi che fanno parte della zona di destinazione di Azure.

Lo schema di avviso comune standardizza l'utilizzo delle notifiche di avviso di Monitoraggio di Azure. Per altre informazioni, vedere lo Schema degli avvisi comuni.

Tipi di avviso:

È possibile creare avvisi su qualsiasi metrica o fonte di dati di log nella piattaforma di dati di Monitoraggio di Azure. Esistono molti tipi diversi di avvisi a seconda dei servizi monitorati e dei dati di monitoraggio raccolti. Ogni tipo di avviso presenta vantaggi e svantaggi. Per altre informazioni, vedere Scegliere il tipo di avviso di monitoraggio corretto.

L'elenco seguente descrive i tipi di avvisi del Monitoraggio di Azure che è possibile creare:

• Gli avvisi delle metriche valutano le metriche delle risorse a intervalli regolari. Le metriche possono essere metriche della piattaforma, metriche personalizzate, log di Monitoraggio di Azure convertiti in metriche o metriche di Application Insights. Gli avvisi delle metriche possono anche applicare più condizioni e soglie dinamiche.
• Gli avvisi relativi ai log consentono agli utenti di utilizzare una query di Log Analytics per valutare i log delle risorse con una frequenza predefinita.
• Gli avvisi dei log attività vengono attivati quando si verifica un nuovo evento del log attività che soddisfa le condizioni definite. Gli avvisi sull'integrità delle risorse e gli avvisi sull'integrità dei servizi sono avvisi di log delle attività che segnalano l'integrità dei servizi e delle risorse.

Alcuni servizi di Azure supportano anche avvisi di rilevamento intelligente, avvisi Prometheus o regole di avviso consigliate.

Per alcuni servizi, è possibile effettuare un monitoraggio su larga scala applicando la stessa regola di avviso delle metriche a più risorse dello stesso tipo presenti nella stessa area di Azure. Vengono inviate notifiche singole per ogni risorsa monitorata. Per i servizi e i cloud di Azure supportati, vedere Monitorare più risorse con una regola di avviso.

Regole di avviso di Azure Cosmos DB

La tabella seguente elenca alcune regole di avviso comuni e consigliate per Azure Cosmos DB.

Per altre informazioni e istruzioni relative alla creazione di avvisi per Azure Cosmos DB, vedere Creare un avviso per le metriche. Per creare un avviso per monitorare se l'archiviazione per una chiave di partizione logica si avvicina a 20 GB, vedere Creare avvisi sulla dimensione della chiave di partizione logica.

Elementi consigliati di Advisor

Per alcuni servizi, se si verificano condizioni critiche o modifiche imminenti durante le operazioni sulle risorse, viene visualizzato un avviso nella pagina Panoramica del servizio nel portale. È possibile trovare altre informazioni e correzioni consigliate per l'avviso in Consigli di Advisor in Monitoraggio nel menu a sinistra. Durante il normale funzionamento non viene visualizzato nessun consiglio di Advisor.

Per altre informazioni su Azure Advisor, vedere Informazioni generali su Azure Advisor.

Contenuto correlato

• Vedere Riferimento ai dati di Monitoraggio di Azure Cosmos DB per informazioni di riferimento su metriche, log e altri valori importanti creati per Azure Cosmos DB.
• Per informazioni generali sul monitoraggio delle risorse di Azure, vedere Monitoraggio delle risorse di Azure con Monitoraggio di Azure.