Questo argomento spiega come visualizzare le metriche di Apigee Hybrid in una dashboard Stackdriver.
Informazioni su Stackdriver
Per ulteriori informazioni su metriche, dashboard e Stackdriver, consulta:
Abilitazione delle metriche ibride
Prima che le metriche ibride possano essere inviate a Stackdriver, devi prima abilitare la raccolta delle metriche. Per questa procedura, consulta la sezione Configurare la raccolta delle metriche.
Informazioni su nomi ed etichette delle metriche ibride
Se attivato, hybrid compila automaticamente le metriche di Stackdriver. Il prefisso del nome di dominio delle metriche create da ibrido è:
apigee.googleapis.com/
Ad esempio, la metrica /proxy/request_count contiene il numero totale di richieste ricevute da un proxy API. Il nome della metrica in Stackdriver è quindi:
apigee.googleapis.com/proxy/request_count
Stackdriver ti consente di filtrare e raggruppare i dati delle metriche in base alle etichette. Alcune etichette sono predefinite, mentre altre vengono aggiunte in modo esplicito da Hybrid. La sezione Metriche disponibili di seguito elenca tutte le metriche ibride disponibili e le etichette aggiunte specificamente per una metrica che puoi utilizzare per il filtraggio e il raggruppamento.
Visualizzazione delle metriche
L'esempio seguente mostra come visualizzare le metriche in Stackdriver:- Apri Esplora metriche di Monitoring in un browser. In alternativa, se ti trovi già nella console Stackdriver, seleziona Esplora metriche.
In Trova tipo di risorsa e metrica, individua e seleziona la metrica che vuoi esaminare. Scegli una metrica specifica elencata in Metriche disponibili o cerca una metrica. Ad esempio, cerca
proxy/latencies:
- Seleziona la metrica che ti interessa.
- Applica i filtri. Le scelte di filtro per ogni metrica sono elencate in Metriche disponibili.
Ad esempio, per la metrica
proxy_latencies, le scelte di filtro sono: org=org_name. - Stackdriver mostra il grafico per la metrica selezionata.
- Fai clic su Salva.
Creare una dashboard
Le 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.
Utilizzi un grafico per visualizzare una metrica Apigee nella dashboard personalizzata. Con le dashboard personalizzate, hai il controllo completo sui grafici visualizzati e sulla loro configurazione. Per saperne di più sulla creazione di grafici, vedi Creare grafici.
L'esempio seguente mostra come creare una dashboard in Stackdriver e poi aggiungere grafici per visualizzare i dati delle metriche:
- Apri Esplora metriche di Monitoring in un browser e seleziona Dashboard.
- Seleziona + Crea dashboard.
- Assegna un nome alla dashboard. Ad esempio: Traffico di richieste proxy ibride
- Fai clic su Conferma.
Per ogni grafico che vuoi aggiungere alla dashboard:
- Nella dashboard, seleziona Aggiungi grafico.
- Seleziona la metrica che ti interessa come descritto in Visualizzazione delle metriche.
- Completa la finestra di dialogo per definire il grafico.
- Fai clic su Salva. Stackdriver mostra i dati per la metrica selezionata.
Metriche disponibili
Le tabelle seguenti elencano le metriche per l'analisi del traffico proxy.
Metriche sul traffico di proxy, destinazione e server
Il servizio Prometheus raccoglie e tratta le metriche (come descritto in Raccolta delle metriche) per il traffico di proxy, target e server.
La seguente tabella descrive le metriche e le etichette utilizzate da Prometheus. Queste etichette vengono utilizzate nelle voci di 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 del proxy API ricevute. |
/proxy/latencies |
method |
Il numero totale di millisecondi necessari per rispondere a una chiamata. Questo tempo include l'overhead del proxy API Apigee e il tempo del server di destinazione. |
/target/request_count |
method
|
Il numero totale di richieste inviate alla destinazione del proxy. |
/target/response_count |
method
|
Il numero totale di risposte ricevute dal target del proxy. |
/target/latencies |
method
|
Il numero totale di millisecondi necessari per rispondere a una chiamata. Questo tempo non include l'overhead del proxy API Apigee. |
/policy/latencies |
policy_name |
Il numero totale di millisecondi impiegati per l'esecuzione di questa policy denominata. |
/server/fault_count |
source |
Il numero totale di errori per l'applicazione server. Ad esempio, l'applicazione potrebbe essere |
/server/nio |
state |
Il numero di socket aperti. |
/server/num_threads |
Il numero di thread non daemon attivi nel server. | |
/server/request_count |
method
|
Il numero totale di richieste ricevute dall'applicazione server. Ad esempio, l'applicazione potrebbe essere |
/server/response_count |
method
|
Numero totale di risposte inviate dall'applicazione server. Ad esempio, l'applicazione potrebbe essere |
/server/latencies |
method
|
Latenza in millisecondi introdotta dall'applicazione server. Ad esempio, l'applicazione potrebbe essere |
/upstream/request_count |
method
|
Il numero di richieste inviate dall'applicazione server alla sua applicazione upstream. Ad esempio, per |
/upstream/response_count |
method
|
Il numero di risposte ricevute dall'applicazione server dalla sua applicazione upstream. Ad esempio, per |
/upstream/latencies |
method
|
La latenza sostenuta nell'applicazione server upstream in millisecondi. Ad esempio, per |
Metriche UDCA
Il servizio Prometheus raccoglie ed elabora le metriche (come descritto in Raccolta delle metriche) per il servizio UDCA proprio come fa per altri servizi ibridi.
La seguente tabella descrive le metriche e le etichette utilizzate da Prometheus nei 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
|
Il timestamp, in millisecondi dall'inizio dell'epoca di Unix, del file meno recente del set di dati. 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, questo valore sarà 0. Se questo valore continua ad aumentare, significa che i vecchi file sono ancora sul disco. |
/udca/server/local_file_latest_ts |
dataset
|
Il timestamp, in millisecondi dall'inizio dell'epoca Unix, dell'ultimo file sul disco per stato. 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, questo valore sarà 0. |
/udca/server/local_file_count |
dataset
|
Un conteggio del numero di file sul disco nel pod di raccolta dei dati. Idealmente, il valore sarà vicino a 0. Un valore elevato e costante indica che i file non vengono caricati o che 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 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 da UDCA per caricare un file di dati. I bucket saranno 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 totale di caricamento, incluse tutte le chiamate upstream. |
/udca/upstream/http_error_count |
service
|
Il conteggio totale degli errori HTTP rilevati da UDCA. Questa metrica è utile per determinare quale parte delle dipendenze esterne UDCA non funziona e per quale motivo. Questi errori possono verificarsi per vari servizi (
|
/udca/upstream/http_latencies |
service
|
La latenza upstream dei servizi, in secondi. I bucket saranno 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 upstream. |
/udca/upstream/uploaded_file_sizes |
dataset |
Le dimensioni del file caricato nei servizi Apigee, in byte. I bucket saranno 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:
|
/udca/disk/used_bytes |
dataset
|
Lo spazio occupato dai file di dati sul disco del pod di raccolta dati, in byte. Un aumento di questo valore nel tempo:
|
/udca/server/pruned_file_count |
dataset
|
Conteggio dei file eliminati perché la durata (TTL) superava una soglia impostata.
Il set di dati può includere API, tracce e altro ancora e lo stato può essere UPLOADED,
FAILED o DISCARDED.
|
/udca/server/retry_cache_size |
dataset |
Un conteggio del numero di file, per set di dati, che UDCA sta tentando di caricare di nuovo. Dopo tre tentativi per ogni file, UDCA sposta il file nella sottodirectory |
Metriche Cassandra
Il servizio Prometheus raccoglie ed elabora le metriche (come descritto in Raccolta delle metriche) per Cassandra proprio come fa per altri servizi ibridi.
La tabella seguente descrive le metriche e le etichette utilizzate da Prometheus nei dati delle metriche di Cassandra. Queste etichette vengono utilizzate nelle voci di log delle metriche.
| Nome metrica (escluso il dominio) | Etichetta | Utilizza |
|---|---|---|
/cassandra/process_max_fds |
Numero massimo di descrittori di file aperti. | |
/cassandra/process_open_fds |
Descrittori di file aperti. | |
/cassandra/jvm_memory_pool_bytes_max |
pool |
Utilizzo massimo della memoria JVM per il pool. |
/cassandra/jvm_memory_pool_bytes_init |
pol |
Utilizzo iniziale della memoria JVM per il pool. |
/cassandra/jvm_memory_bytes_max |
area |
Utilizzo massimo della memoria heap della JVM. |
/cassandra/process_cpu_seconds_total |
Tempo CPU utente e sistema trascorso in secondi. | |
/cassandra/jvm_memory_bytes_used |
area |
Utilizzo della memoria heap della JVM. |
/cassandra/compaction_pendingtasks |
unit |
Compattazioni in attesa per le sstable di Cassandra. Per saperne di più, consulta Compattazione. |
/cassandra/jvm_memory_bytes_init |
area |
Utilizzo iniziale della memoria heap della JVM. |
/cassandra/jvm_memory_pool_bytes_used |
pool |
Utilizzo della memoria del pool JVM. |
/cassandra/jvm_memory_pool_bytes_committed |
pool |
Utilizzo della memoria di commit del pool JVM. |
/cassandra/clientrequest_latency |
scope
|
Latenza delle richieste di lettura nell'intervallo del 75° percentile in microsecondi. |
/cassandra/jvm_memory_bytes_committed |
area |
Utilizzo della memoria di heap JVM di cui è stato eseguito il commit. |