Prometheus guardará todos los datos de muestra recopilados en forma de series de tiempo, y cada serie de tiempo recibe el nombre de un indicador y un conjunto de etiquetas.
Cada punto de la serie temporal se denomina muestra y la muestra consta de las tres partes siguientes:
1) Métrica: nombre de la métrica y conjunto de etiquetas que describen las características de la muestra actual.
2) Marca de tiempo: una marca de tiempo con una precisión de milisegundos.
3) Valor de muestra (valor): un dato de punto flotante float64 representa el valor de la muestra actual.
Los datos de un indicador estandarizado generalmente contienen las tres partes siguientes:
1) #AYUDA, explica el propósito de este indicador.
2) #TYPE, indicando el tipo de dato del indicador.
3) Indicadores específicos recogidos.
El formato específico de los indicadores es el siguiente:
<nombre de métrica>{<nombre de etiqueta>=<valor de etiqueta>, ...} datos
Hay cuatro tipos de datos de indicadores, todos los cuales se muestran en la línea de tipo de la interfaz /metrics proporcionada por la exportación.
1）counter:encimera
2）gauge:panel
3）histogram:Histograma
4）summary:Resumen
encimera
Los contadores solo pueden aumentar pero no disminuir y, a menudo, se utilizan para indicar la cantidad de errores que se han producido, la cantidad de tareas completadas y la cantidad de solicitudes de servicio.
Después de instalar e iniciar Prometheus, puede visitar http://localhost:9090/metrics para ver los propios indicadores de Prometheus.
# HELP prometheus_http_requests_total Counter of HTTP requests.
# TYPE prometheus_http_requests_total counter
prometheus_http_requests_total{code="200",handler="/"} 0
prometheus_http_requests_total{code="200",handler="/-/healthy"} 0
prometheus_http_requests_total{code="200",handler="/-/quit"} 0
prometheus_http_requests_total{code="200",handler="/-/ready"} 4
prometheus_http_requests_total{code="200",handler="/-/reload"} 0
prometheus_http_requests_total{code="200",handler="/alerts"} 0
prometheus_http_requests_total{code="200",handler="/api/v1/*path"} 0indicador
El panel registra valores instantáneos. Cualquiera que sea el valor, puede ser grande o pequeño. A menudo se utiliza para registrar indicadores similares como el valor de carga de la CPU, el uso de la memoria, el uso del disco, el número de subprocesos, el número de conexiones, etc.
# HELP go_goroutines Number of goroutines that currently exist.
# TYPE go_goroutines gauge
go_goroutines 33
# HELP go_info Information about the Go environment.
# TYPE go_info gauge
go_info{version="go1.21.0"} 1
# HELP go_memstats_alloc_bytes Number of bytes allocated and still in use.
# TYPE go_memstats_alloc_bytes gauge
go_memstats_alloc_bytes 2.0341712e+07
# HELP go_memstats_buck_hash_sys_bytes Number of bytes used by the profiling bucket hash table.
# TYPE go_memstats_buck_hash_sys_bytes gauge
go_memstats_buck_hash_sys_bytes 1.533216e+06
# HELP go_memstats_gc_sys_bytes Number of bytes used for garbage collection system metadata.
# TYPE go_memstats_gc_sys_bytes gauge
go_memstats_gc_sys_bytes 5.9602e+06histograma
Los histogramas se agrupan según el intervalo del valor del índice de la muestra y cuentan el número de veces que aparece el valor del índice de la muestra en cada intervalo. Puede conocer claramente el patrón de distribución del intervalo del valor del índice. A menudo se utiliza para la distribución del intervalo de Tiempo de respuesta de la solicitud y bytes de respuesta de la solicitud Distribución de intervalos grandes y otros datos similares. Para obtener el cuantil del valor del indicador de la muestra es necesario calcularlo en el lado del servidor, lo que consumirá los recursos informáticos del lado del servidor.
El histograma contiene 3 tipos de indicadores:
1) El número de valores de índice de muestras en el grupo, denominado _bucket{le=""}, representa el número de todas las muestras cuyos valores de índice son menores o iguales que el límite superior.
2) La suma de los valores de los indicadores de todas las muestras se denomina _suma.
3) El número total de muestras, denominado _count.
Después de instalar e iniciar Prometheus, puede visitar http://localhost:9090/metrics para ver los propios indicadores de Prometheus. El siguiente ejemplo proviene de la información del histograma del tiempo de solicitud http que toma Prometheus, se puede ver que entre las solicitudes http con la ruta de solicitud "/", hay 2 tiempos de respuesta de menos de 0,1 segundos, 5 respuestas de menos de 0,2 segundos , y menos de 0,4 segundos, hay 9 de ellos, 11 de ellos son menos de 1 segundo, el número total de solicitudes es 11 y el tiempo total de solicitud es 2,000284668 segundos.
# HELP prometheus_http_request_duration_seconds Histogram of latencies for HTTP requests.
# TYPE prometheus_http_request_duration_seconds histogram
prometheus_http_request_duration_seconds_bucket{handler="/",le="0.1"} 2
prometheus_http_request_duration_seconds_bucket{handler="/",le="0.2"} 5
prometheus_http_request_duration_seconds_bucket{handler="/",le="0.4"} 9
prometheus_http_request_duration_seconds_bucket{handler="/",le="1"} 11
prometheus_http_request_duration_seconds_bucket{handler="/",le="3"} 11
prometheus_http_request_duration_seconds_bucket{handler="/",le="8"} 11
prometheus_http_request_duration_seconds_bucket{handler="/",le="20"} 11
prometheus_http_request_duration_seconds_bucket{handler="/",le="60"} 11
prometheus_http_request_duration_seconds_bucket{handler="/",le="120"} 11
prometheus_http_request_duration_seconds_bucket{handler="/",le="+Inf"} 11
prometheus_http_request_duration_seconds_sum{handler="/"} 2.000284668
prometheus_http_request_duration_seconds_count{handler="/"} 11resumen
Resumen, similar al histograma, registra los resultados de distribución de los valores del indicador de muestras dentro de un período de tiempo. El cliente calcula los resultados cuantiles de los valores del indicador de muestra y el servidor puede mostrarlos directamente sin consumir recursos informáticos.
Las muestras de tipo resumen también proporcionarán 3 indicadores, suponiendo que el nombre del indicador lo sea.
1) La distribución cuantil del valor de la muestra se denomina {quantile="<>"}.
2) La suma de los tamaños de todos los valores de muestra se denomina _sum.
3) El número total de muestras, denominado _count.
Después de instalar e iniciar Prometheus, puede visitar http://localhost:9090/metrics para ver los propios indicadores de Prometheus. El siguiente ejemplo proviene de la información resumida del GC que viene con Prometheus. Se puede ver que el número total de GC en lenguaje GO es 213, el tiempo total de GC es 0.25431598 segundos y el tiempo medio es (quantile = "0.5" ) es 0,001254684 segundos, lo que significa que el 50% de los 213 tiempos de GC son inferiores a 0,001254684 segundos.
# HELP go_gc_duration_seconds A summary of the pause duration of garbage collection cycles.
# TYPE go_gc_duration_seconds summary
go_gc_duration_seconds{quantile="0"} 1.9042e-05
go_gc_duration_seconds{quantile="0.25"} 0.000584189
go_gc_duration_seconds{quantile="0.5"} 0.001254684
go_gc_duration_seconds{quantile="0.75"} 0.001590227
go_gc_duration_seconds{quantile="1"} 0.006444609
go_gc_duration_seconds_sum 0.25431598
go_gc_duration_seconds_count 213