Monitoraggio di Azure CosmosDB
Il sensore Azure CosmosDB viene distribuito e installato automaticamente dopo l'installazione dell'agente Instana.
Azure Cosmos DB è il servizio di database multimodello distribuito globalmente da Microsoft. Instana supporta il monitoraggio in base alle metriche di raccolta e, a seconda del modello utilizzato, supporta anche il monitoraggio delle metriche specifiche del modello per ogni raccolta.
I dati sono organizzati in modo drill - down con 4 livelli di metriche. Vengono visualizzate le metriche aggregate dell'istanza. Queste metrica si applicano all'intera istanza CosmosDb .
Il livello successivo è costituito dalle metriche per regione. Le metriche della regione vengono aggregate su tutte le raccolte che esistono all'interno di tale regione, ma contengono anche traffico interregionale e altro traffico. Ciò significa che i dati relativi a ciascuna regione sono leggermente superiori alla somma del traffico di tutte le raccolte presenti in quella regione.
Il terzo livello diventa visibile una volta che si espande una regione. Qui puoi vedere le metriche per collezione. In base al modello di dati, ogni raccolta dispone di metriche aggiuntive che è possibile visualizzare espandendo la vista della raccolta.
La frequenza di raccolta dei dati è determinata dall'SDK di monitoraggio di Azure.
Informazioni aggiuntive
Tracciamento supportato lato client
Configurazione
Il sensore Azure CosmosDB può essere abilitato e può essere filtrato in base a tag e gruppi di risorse. È possibile configurare un sensore Azure CosmosDB tramite la configurazione <agentinstall_dir>/etc/instana/configuration.yaml dell'agente in:
com.instana.plugin.azure.cosmosdb:
# Valid values: true, false
enabled: false # enabled (true) by default
# Comma separated list of tags in key:value format
include_tags:
# Comma separated list of tags in key:value format
exclude_tags:
# Comma separated list of resource groups
include_resource_groups:
# Comma separated list of resource groups
exclude_resource_groups:
Il sensore Azure CosmosDB può essere disabilitato. Per disabilitare il controllo dei servizi CosmosDB di Azure , utilizzare la seguente configurazione:
com.instana.plugin.azure.cosmosdb:
enabled: false
È possibile definire più tag e gruppi di risorse, separati da una virgola. Le tag devono essere fornite come una coppia chiave - valore separata da :. Per semplificare la configurazione, è possibile definire quali tag e gruppi di risorse si desidera includere nel rilevamento o escludere dal rilevamento. Quando si definisce un tag o un gruppo di risorse in entrambi gli elenchi (di inclusione e di esclusione), l'elenco di esclusione ha la priorità. Se non è necessario filtrare i servizi, la configurazione non dovrebbe essere definita. Non è obbligatorio definire tutti i valori per abilitare il filtro.
Per includere i servizi per tag nel rilevamento, utilizzare la seguente configurazione:
com.instana.plugin.azure.cosmosdb:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
Per escludere i servizi per tag dal rilevamento, utilizzare la seguente configurazione:
com.instana.plugin.azure.cosmosdb:
exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
Per includere i servizi per gruppi di risorse nel rilevamento, utilizzare la seguente configurazione:
com.instana.plugin.azure.cosmosdb:
include_resource_groups: # Comma separated list of resource groups (e.g. rg_prod,rg_staging)
Per escludere i servizi per gruppi di risorse dal rilevamento, utilizzare la seguente configurazione:
com.instana.plugin.azure.cosmosdb:
exclude_resource_groups: # Comma separated list of resource groups (e.g. rg_dev,rg_test)
Il filtro di rilevamento può essere configurato a livello globale per tutti i servizi Azure . I filtri globali vengono ignorati quando si definiscono i filtri per un servizio Azure CosmosDB. Per ulteriori dettagli sul filtro del rilevamento servizi Azure globale, visitare Azure Configurazione.
Raccolta di metriche
Per visualizzare le metriche, seleziona "Infrastruttura" nella barra laterale dell'interfaccia utente di Instana, fai clic su un host monitorato specifico e potrai visualizzare una dashboard dell'host con tutte le metriche raccolte e i processi monitorati.
Dati di configurazione
Elenco di informazioni statiche per istanza CosmosDB .
| Dettagli CosmosDB | Descrizione |
|---|---|
| Nome | Il nome dell'istanza CosmosDB . |
| Gruppo di risorse | Il gruppo di risorse dell'istanza CosmosDB . |
| Ubicazione | La regione principale in cui si trova l'istanza |
| ID sottoscrizione | L'ID sottoscrizione dell'istanza CosmosDB . |
| Stato | Stato di installazione corrente dell'istanza. |
| API | Tipo di modello del documento ( GlobalDB,, Cassandra o MongoDB ) |
| Immettere | Tipo di documento |
| Tipo | Indica il tipo di account database |
| Endpoint | Endpoint database |
Riepilogo
Il primo livello di metriche aggregato per l'intera istanza CosmosDB .
| Metrica di istanza CosmosDB | Descrizione | Granularità |
|---|---|---|
| Numero documenti | Numero di documenti che esistono nell'intera istanza | 5 minuti |
| Disponibilità dei servizi | Espresso in% | 1 ora |
| Richieste totali | Numero totale di tutte le richieste | 1 minuto |
| Richieste metadati | Numero totale di richieste di metadati | 1 minuto |
| Latenza di lettura | 1 minuto | |
| Latenza di scrittura | 1 minuto |
Regioni
Le metriche per regione contengono i dati aggregati per tutte le raccolte in tale regione più le metriche che si verificano a livelli di regione come le metriche tra regioni o le richieste di metadati.
| Metriche regione | Granularità |
|---|---|
| Richieste totali | 1 minuto |
| Richieste metadati | 1 minuto |
| Numero documenti | 5 minuti |
Raccolte
Ogni regione ha una o più raccolte. Ogni raccolta dispone di una serie di metriche accessibili indipendentemente dal modello del documento:
| Metriche raccolta | Descrizione | Granularità |
|---|---|---|
| Richieste totali | Numero di richieste totali | 1 minuto |
| Richieste metadati | Numero di richieste di metadati | 1 minuto |
| Numero documenti | Numero di documenti memorizzati in questa raccolta | 5 minuti |
| Utilizzo dati | Numero di byte utilizzati per memorizzare tutti i documenti | 5 minuti |
| Utilizzo indice | Quantità totale di memoria disponibile | 5 minuti |
| Quota Documento | Quantità totale di memoria disponibile per la memorizzazione dei documenti | 5 minuti |
| Codici di stato | Metriche delle richieste totali per codice di stato | 1 minuto |
Sulla base del modello del documento ( API ), vengono raccolte ulteriori metriche:
Cassandra
| Metriche raccolta | Descrizione | Granularità |
|---|---|---|
| Tipo di risorsa | Richieste per tipo di risorsa | 1 minuto |
MongoDB
| Metriche raccolta | Descrizione | Granularità |
|---|---|---|
| Tipo di comando | Richieste per tipo di comando | 1 minuto |
| Codice di errore | Richieste per codice di errore | 1 minuto |
Indicatori sanitari
Per ogni sensore, c'è una knowledgebase curata delle firme di integrità che vengono valutate continuamente rispetto alle metriche in ingresso e vengono utilizzate per generare problemi o incidenti a seconda dell'impatto dell'utente.
Gli eventi predefiniti generano problemi o incidenti in base al mancato rispetto delle condizioni di integrità delle entità, mentre gli eventi personalizzati generano problemi o incidenti in base alle soglie di una singola metrica di una determinata entità.
Per informazioni sugli eventi integrati per il sensore CosmosDB di Azure , consultare la Guida di riferimento agli eventi integrati.