Monitoraggio di Azure CosmosDB

Il sensore Azure CosmosDB viene distribuito e installato automaticamente dopo l'installazione dell'agente Instana.

Nota: per ulteriori informazioni sugli altri servizi supportati da Azure, consulta la documentazione di Azure.

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.

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.