Capítulo 16. Funciones

Este trabajo se ha traducido utilizando IA. Agradecemos tus opiniones y comentarios: translation-feedback@oreilly.com

PromQL tiene 69 funciones a partir de la versión 2.37.0, y te ofrece una amplia variedad de funcionalidades, desde las matemáticas comunes hasta funciones específicas para tratar con contadores e histogramas métricos. En este capítulo aprenderás cómo funcionan todas las funciones y cómo se pueden utilizar.

Casi todas las funciones PromQL devuelven vectores instantáneos, y las tres que no lo hacen (time, pi, y scalar) devuelven escalares. Ninguna función devuelve vectores de rango, aunque varias funciones, incluidas rate y avg_over_time que ya has visto, toman un vector de rango como entrada.

Dicho de otro modo, las funciones suelen trabajar o bien a través de las muestras de una sola serie temporal a la vez, o bien a través de las muestras de un vector instantáneo. Si quieres procesar todo un vector de rangos a la vez, tendrías que utilizar subconsultas.

PromQL es de tipado estático, las funciones no cambian su valor de retorno en función de los tipos de entrada. De hecho, los tipos de entrada de cada función también son fijos. Cuando una función necesita trabajar con dos tipos distintos, se utilizan dos nombres diferentes. Por ejemplo, se utiliza el agregador avg en vectores instantáneos y la funciónavg_over_time en vectores de rango.

No hay categorías oficiales para las funciones, pero hemos agrupado las funciones relacionadas.

Cambio de ...

Get Prometeo: Up & Running, 2ª Edición now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.