Visualizza metriche

Questo argomento spiega come visualizzare le metriche ibride di Apigee in un Stackdriver.

Informazioni su Stackdriver

Per ulteriori informazioni su metriche, dashboard e Stackdriver, consulta:

Attivazione delle metriche ibride

Prima che le metriche ibride possano essere inviate a Stackdriver, devi prima abilitare la raccolta delle metriche. Consulta Configurare la raccolta delle metriche per questa procedura.

Informazioni sui nomi e sulle etichette delle metriche ibride

Se abilitato, il modello ibrida compila automaticamente le metriche di Stackdriver. Il prefisso del nome di dominio delle metriche create da un modello ibrido è:

apigee.googleapis.com/

Ad esempio, la metrica /proxy/request_count contiene il numero totale di richieste ricevute da un proxy API. Di conseguenza, il nome della metrica in Stackdriver è:

apigee.googleapis.com/proxy/request_count

Stackdriver consente di filtrare e gruppo i dati delle metriche in base a etichette. Alcune etichette sono predefinite, mentre altre vengono aggiunte esplicitamente da Hybrid. La sezione Metriche disponibili di seguito elenca tutte le metriche ibride disponibili e le eventuali etichette aggiunte specificamente per una metrica che puoi utilizzare per filtrare e raggruppare.

Visualizzazione delle metriche

L'esempio seguente mostra come visualizzare le metriche in Stackdriver:
  1. Apri Esplora metriche di Monitoring in un browser. In alternativa, se ti trovi già nella Nella console di Stackdriver, seleziona Esplora metriche.
  2. In Trova tipo di risorsa e metrica, individua e seleziona la metrica da esaminare. Scegli una metrica specifica elencata in Metriche disponibili o cerca una metrica. Ad esempio: cerca proxy/latencies:

    Inserisci metrica

  3. Seleziona la metrica che ti interessa.
  4. Applica i filtri. Le opzioni di filtro per ogni metrica sono elencate in Metriche disponibili. Ad esempio, per la metrica proxy_latencies, le opzioni di filtro sono: org=org_name.
  5. Stackdriver mostra il grafico per la metrica selezionata.
  6. Fai clic su Salva.

Creazione di una dashboard

Dashboard sono un modo per visualizzare e analizzare i dati delle metriche importanti per te. Stackdriver fornisce dashboard predefinite per le risorse e i servizi che utilizzi, e puoi anche creare dashboard personalizzate.

Utilizza un grafico per visualizzare una metrica Apigee nella dashboard personalizzata. Con le dashboard personalizzate hai il controllo completo sui grafici visualizzati e sulla relativa configurazione. Per saperne di più sulla creazione di grafici, consulta Creare grafici.

L'esempio seguente mostra come creare una dashboard in Stackdriver e poi aggiungere grafici per visualizzare i dati delle metriche:

  1. Apri Esplora metriche di Monitoring in un browser e seleziona Dashboard.
  2. Seleziona + Crea dashboard.
  3. Assegna un nome alla dashboard. Ad esempio: Traffico di richieste proxy ibrido
  4. Fai clic su Conferma.
  5. Per ogni grafico che vuoi aggiungere alla dashboard:

    1. Nella dashboard, seleziona Aggiungi grafico.
    2. Seleziona la metrica che ti interessa come descritto sopra in Visualizzazione delle metriche.
    3. Completa la finestra di dialogo per definire il grafico.
    4. Fai clic su Salva. Stackdriver mostra i dati relativi alla metrica selezionata.

Metriche disponibili

Le seguenti tabelle elencano le metriche per l'analisi del traffico proxy.

Metriche sul traffico di proxy, target e server

Il servizio Prometheus raccoglie ed elabora le metriche (come descritto in Raccolta di metriche) per proxy, di destinazione e del server.

La tabella seguente descrive le metriche e le etichette utilizzate da Prometheus. Queste etichette vengono utilizzate nelle voci dei log delle metriche.

Nome metrica Etichetta Utilizza
/proxy/request_count method Il numero totale di richieste proxy API ricevute.
/proxy/response_count method response_code Il numero totale di risposte dell'API proxy ricevute.
/proxy/latencies method Numero totale di millisecondi necessari per rispondere a una chiamata. Questo tempo include il sovraccarico del proxy API Apigee e l'ora del server di destinazione.
/target/request_count method

target_type

target_endpoint

Il numero totale di richieste inviate al target del proxy.
/target/response_count method

response_code

target_type

target_endpoint

Il numero totale di risposte ricevute dalla destinazione del proxy.
/target/latencies method

response_code

target_type

target_endpoint

Numero totale di millisecondi necessari per rispondere a una chiamata. Questo tempo non include il sovraccarico del proxy API Apigee.
/policy/latencies policy_name Il numero totale di millisecondi necessari per l'esecuzione di questo criterio denominato.
/server/fault_count source

Il numero totale di errori per l'applicazione server.

Ad esempio, l'applicazione potrebbe essere apigee-runtime, apigee-synchronizer, o apigee-udca. Utilizza l'etichetta pod_name per filtrare i risultati in base all'applicazione.

/server/nio state Il numero di socket aperti.
/server/num_threads Il numero di thread non daemon attivi nel server.
/server/request_count method

type

Il numero totale di richieste ricevute dall'applicazione server.

Ad esempio, l'applicazione potrebbe essere apigee-runtime, apigee-synchronizer oapigee-udca. Utilizza l'etichetta pod_name per filtrare i risultati in base all'applicazione.

/server/response_count method

response_code
type

Numero totale di risposte inviate dall'applicazione server.

Ad esempio, l'applicazione potrebbe essere apigee-runtime, apigee-synchronizer oapigee-udca. Utilizza l'etichetta pod_name per filtrare i risultati per applicazione.

/server/latencies method

response_code
type

La latenza è la latenza in millisecondi introdotta dall'applicazione del server.

Ad esempio, l'applicazione potrebbe essere apigee-runtime, apigee-synchronizer oapigee-udca. Utilizza l'etichetta pod_name per filtrare i risultati per applicazione.

/upstream/request_count method

type

Il numero di richieste inviate dall'applicazione server all'applicazione a monte.

Ad esempio, per apigee-synchronizer, il piano di controllo è a monte. Pertanto, upstream/request_count per apigee-synchronizer è una metrica che indica le richieste effettuate da apigee-synchronizer al piano di controllo.

/upstream/response_count method

response_code

type

Il numero di risposte ricevute dall'applicazione server dalla sua applicazione upstream.

Ad esempio, per apigee-synchronizer, il piano di controllo è in upstream. Pertanto, upstream/response_count per apigee-synchronizer è una metrica che indica le richieste ricevute da apigee-synchronizer dal control plane.

/upstream/latencies method

response_code
type

La latenza in millisecondi nell'applicazione del server a monte.

Ad esempio, per apigee-synchronizer, il piano di controllo è a monte. Pertanto, upstream/latencies per apigee-synchronizer è una metrica che indica la latenza del piano di controllo.

Metriche UDCA

Il servizio Prometheus raccoglie ed elabora le metriche (come descritto in Raccolta di metriche) per servizio UDCA proprio come avviene per gli altri servizi ibridi.

La tabella seguente descrive le metriche e le etichette utilizzate da Prometheus nella Dati delle metriche UDCA. Queste etichette vengono utilizzate nelle voci di log delle metriche.

Nome metrica Etichetta Utilizza
/udca/server/local_file_oldest_ts dataset

state

Il timestamp, in millisecondi dall'inizio dell'epoca Unix, del file più antico del set di dati.

Questo valore viene calcolato ogni 60 secondi e non riflette lo stato in tempo reale. Se la funzione UDCA è aggiornata e non ci sono file in attesa di essere caricati al momento del calcolo di questa metrica, questo valore sarà 0.

Se questo valore continua ad aumentare, i file precedenti rimangono sul disco.

/udca/server/local_file_latest_ts dataset

state

Il timestamp, in millisecondi dall'inizio dell'epoca Unix, per l'ultimo file sul disco in base allo stato.

Questo valore viene calcolato ogni 60 secondi e non riflette lo stato in tempo reale. Se l'UDCA è aggiornato e non ci sono file in attesa di essere caricati al momento del calcolo di questa metrica, il valore sarà 0.

/udca/server/local_file_count dataset

state

Un conteggio del numero di file su disco nel pod di raccolta dati.

Idealmente, il valore sarà vicino a 0. Un valore elevato costante indica che i file non vengono caricati o che l'UDCA non è in grado di caricarli abbastanza velocemente.

Questo valore viene calcolato ogni 60 secondi e non riflette lo stato dell'UDCA in tempo reale.

/udca/server/total_latencies dataset

L'intervallo di tempo, in secondi, tra la creazione del file di dati e il caricamento riuscito del file di dati.

I bucket saranno di 100 ms, 250 ms, 500 ms, 1 s, 2 s, 4 s, 8 s, 16 s, 32 s e 64 s.

Istogramma della latenza totale dal momento della creazione del file al momento del caricamento riuscito.

/udca/server/upload_latencies dataset

Il tempo totale, in secondi, impiegato dalla UDCA per il caricamento di un file di dati.

I bucket saranno di 100 ms, 250 ms, 500 ms, 1 s, 2 s, 4 s, 8 s, 16 s, 32 s e 64 s.

Le metriche mostreranno un istogramma della latenza di caricamento totale, incluse tutte le chiamate upstream.

/udca/upstream/http_error_count service

dataset

response_code

Il conteggio totale degli errori HTTP riscontrati dalla funzione UDCA. Questa metrica è utile per aiutarti a determinare la parte delle dipendenze esterne dell'UDCA che non funziona e il motivo.

Questi errori possono verificarsi per vari servizi (getDataLocation, Cloud storage, Token generator) e per vari set di dati (ad esempio api e trace) con vari codici di risposta.

/udca/upstream/http_latencies service

dataset

La latenza upstream dei servizi, in secondi.

I bucket saranno di 100 ms, 250 ms, 500 ms, 1 s, 2 s, 4 s, 8 s, 16 s, 32 s e 64 s.

Istogramma della latenza dei servizi a monte.

/udca/upstream/uploaded_file_sizes dataset

Le dimensioni del file caricato sui servizi Apigee, espresse in byte.

I bucket saranno da 1 KB, 10 KB, 100 KB, 1 MB, 10 MB, 100 MB e 1 GB.

Istogramma delle dimensioni dei file per set di dati, organizzazione e ambiente.

/udca/upstream/uploaded_file_count dataset Un conteggio dei file caricati da UDCA nei servizi Apigee.

Ricorda:

  • Il valore del set di dati event dovrebbe continuare a crescere.
  • Il valore del set di dati api dovrebbe continuare a crescere se il traffico tra le organizzazioni e l'ambiente è costante.
  • Il valore del set di dati trace dovrebbe aumentare quando utilizzi gli strumenti di traccia Apigee per eseguire il debug o l'ispezione delle tue richieste.
/udca/disk/used_bytes dataset

state

Lo spazio occupato dai file di dati sul disco del pod di raccolta dati, in byte.

Un aumento di questo valore nel tempo:

  • ready_to_upload implica che l'agente è in ritardo.
  • failed implica che i file si accumulano sul disco e non vengono caricati. Questo valore viene calcolato ogni 60 secondi.
/udca/server/pruned_file_count dataset

state

Conteggio dei file che sono stati eliminati perché la loro durata (TTL) superava una soglia impostata. Il set di dati può includere API, traccia e altri, mentre lo stato può essere UPLOADED, FAILED o DISCARDED.
/udca/server/retry_cache_size dataset

Un conteggio del numero di file, in base al set di dati, che l'UDCA sta riprovando a caricare.

Dopo 3 tentativi per ciascun file, UDCA sposta il file nella sottodirectory /failed e lo rimuove dalla cache. Un aumento di questo valore nel tempo indica che la cache non viene svuotata, il che si verifica quando i file vengono spostati nella sottodirectory /failed dopo 3 nuovi tentativi.

Metriche Cassandra

Il servizio Prometheus raccoglie ed elabora le metriche (come descritto in Raccolta di metriche) per Cassandra come per gli altri servizi ibridi.

La tabella seguente descrive le metriche e le etichette utilizzate da Prometheus nei dati delle metriche Cassandra. Queste etichette vengono utilizzate nelle voci dei log delle metriche.

Nome metrica (escluso il dominio) Etichetta Utilizza
/cassandra/process_max_fds Numero massimo di descrittori file aperti.
/cassandra/process_open_fds Apri i descrittori di file.
/cassandra/jvm_memory_pool_bytes_max pool Utilizzo massimo di memoria JVM per il pool.
/cassandra/jvm_memory_pool_bytes_init pol Utilizzo della memoria iniziale della JVM per il pool.
/cassandra/jvm_memory_bytes_max area Utilizzo massimo della memoria heap della JVM.
/cassandra/process_cpu_seconds_total Tempo di CPU dell'utente e del sistema impiegato in secondi.
/cassandra/jvm_memory_bytes_used area Utilizzo memoria heap JVM.
/cassandra/compaction_pendingtasks unit Compattazioni eccezionali per le sstable Cassandra. Per saperne di più, consulta Complessità.
/cassandra/jvm_memory_bytes_init area Utilizzo iniziale della memoria dell'heap JVM.
/cassandra/jvm_memory_pool_bytes_used pool Utilizzo memoria pool JVM.
/cassandra/jvm_memory_pool_bytes_committed pool Utilizzo della memoria impegnata del pool JVM.
/cassandra/clientrequest_latency scope

unit

Latenza della richiesta di lettura nell'intervallo del 75° percentile in microsecondi.
/cassandra/jvm_memory_bytes_committed area Utilizzo della memoria impegnata dell'heap JVM.