[comment]: # translation:outdated [comment]: # attributes: notoc [comment]: # ({56ac0bd9-ef4bef6c}) # 6 Funciones matemáticas Todas las funciones enumeradas aquí son compatibles con: - [Expresiones de iniciador](/manual/config/triggers/expression) - [Métricas calculadas](/manual/config/items/itemtypes/calculated) Las funciones matemáticas son compatibles con tipos de valores flotantes y enteros, a menos que se diga lo contrario. Las funciones se enumeran sin información adicional. Haga clic en la función para ver los detalles completos. |Función|Descripción| |--|--------| |[abs](#abs)|El valor absoluto de un valor.| |[acos](#acos)|El arcocoseno de un valor como ángulo, expresado en radianes.| |[asin](#asin)|El arcoseno de un valor como ángulo, expresado en radianes.| |[atan](#atan)|El arcotangente de un valor como ángulo, expresado en radianes.| |[atan2](#atan2)|El arcotangente de las coordenadas de ordenadas (valor) y abscisas especificadas como un ángulo, expresado en radianes.| |[avg](#avg)|El valor promedio de los valores de los elementos referenciados.| |[cbrt](#cbrt)|La raíz cúbica de un valor.| |[ceil](#ceil)|Redondea el valor al entero mayor o igual más cercano.| |[cos](#cos)|El coseno de un valor, donde el valor es un ángulo expresado en radianes.| |[cosh](#cosh)|El coseno hiperbólico de un valor.| |[cot](#cot)|La cotangente de un valor, donde el valor es un ángulo expresado en radianes.| |[degrees](#degrees)|Convierte un valor de radianes a grados.| |[e](#e)|El número de Euler (2.718281828459045).| |[exp](#exp)|El número de Euler elevado a una potencia de un valor.| |[expm1](#expm1)|El número de Euler elevado a una potencia de un valor menos 1.| |[floor](#floor)|Redondea el valor hacia abajo al entero menor o igual más cercano.| |[log](#log)|El logaritmo natural.| |[log10](#log10)|El logaritmo decimal.| |[max](#max)|El valor más alto de los valores de elementos referenciados.| |[min](#min)|El valor más bajo de los valores de elementos referenciados.| |[mod](#mod)|El resto de la división.| |[pi](#pi)|La constante Pi (3.14159265358979).| |[power](#power)|El poder de un valor.| |[radians](#radians)|Convierte un valor de grados a radianes.| |[rand](#rand)|Devuelve un valor entero aleatorio.| |[round](#round)|Redondea el valor a decimales.| |[signum](#signum)|Devuelve '-1' si un valor es negativo, '0' si un valor es cero, '1' si un valor es positivo.| |[sin](#sin)|El seno de un valor, donde el valor es un ángulo expresado en radianes.| |[sinh](#sinh)|El seno hiperbólico de un valor, donde el valor es un ángulo expresado en radianes.| |[sqrt](#sqrt)|La raíz cuadrada de un valor.| |[sum](#sum)|La suma de los valores de los elementos referenciados.| |[tan](#tan)|La tangente de un valor.| |[truncate](#truncate)|Trunca el valor a posiciones decimales.| [comment]: # ({/56ac0bd9-ef4bef6c}) [comment]: # ({e635e2a6-b94e027b}) ### Detalles de la función Algunas notas generales sobre los parámetros de la función: - Los parámetros de la función están separados por una coma. - Se aceptan expresiones como parámetros. - Los parámetros de función opcionales (o partes de parámetros) se indican mediante `<` `>` [comment]: # ({/e635e2a6-b94e027b}) [comment]: # ({3813a030-ef1976cf}) ##### abs(valor) {#abs} El valor absoluto de un valor.
Tipos de valores admitidos: *Float*, *Integer*, *String*, *Text*, *Log*.
Para cadenas devuelve: 0 - los valores son iguales; 1 - los valores difieren. Parámetro: - **valor** - el valor a comprobar Se calculará la diferencia numérica absoluta, como se ve con estos valores de ejemplo entrantes (valor 'anterior' y 'último' = diferencia absoluta): '1' y '5' = `4`; '3' y '1' = `2`; '0' y '-2,5' = `2,5` Ejemplo: abs(last(/host/key))>10 [comment]: # ({/3813a030-ef1976cf}) [comment]: # ({754d73c7-799c1d3c}) ##### acos(valor) {#acos} El arcocoseno de un valor como ángulo, expresado en radianes. Parámetro: - **valor** - el valor a comprobar El valor debe estar entre -1 y 1. Por ejemplo, el arcocoseno de un valor '0,5' será '2,0943951'. Ejemplo: acos(last(/host/key)) [comment]: # ({/754d73c7-799c1d3c}) [comment]: # ({f32d79d9-96ac62bc}) ##### asin(valor) {#asin} El arcoseno de un valor como ángulo, expresado en radianes. Parámetro: - **valor** - el valor a comprobar El valor debe estar entre -1 y 1. Por ejemplo, el arcoseno de un valor '0,5' será '-0,523598776'. Ejemplo: asin(last(/host/key)) [comment]: # ({/f32d79d9-96ac62bc}) [comment]: # ({8e7917ff-1fc197d5}) ##### atan(valor) {#atan} El arcotangente de un valor como ángulo, expresado en radianes. Parámetro: - **valor** - el valor a comprobar El valor debe estar entre -1 y 1. Por ejemplo, el arcotangente de un valor '1' será '0,785398163'. Ejemplo: atan(last(/host/key)) [comment]: # ({/8e7917ff-1fc197d5}) [comment]: # ({d4066088-a0956f60}) ##### atan2(valor,abscisa) {#atan2} El arcotangente de las coordenadas de ordenadas (valor) y abscisas especificadas como un ángulo, expresadas en radianes. Parámetro: - **valor** - el valor a comprobar; - **abscisa** - el valor de la abscisa. Por ejemplo, el arcotangente de las coordenadas de ordenadas y abscisas de un valor '1' será '2,21429744'. Ejemplo: atan(last(/host/key),2) [comment]: # ({/d4066088-a0956f60}) [comment]: # ({7008b223-d3ee3e17}) ##### avg(,,...) {#avg} El valor promedio de los valores de las métricas referenciadas. Parámetro: - **valueX**: el valor devuelto por otra función que trabaja con el historial de métricas. Ejemplo: avg(avg(/host/key),avg(/host2/key2)) [comment]: # ({/7008b223-d3ee3e17}) [comment]: # ({ef0cb9ef-bd8056a7}) ##### cbrt(valor) {#cbrt} La raíz cúbica de un valor. Parámetro: - **valor** - el valor a comprobar Por ejemplo, la raíz cúbica de '64' será '4', de '63' será '3.97905721'. Ejemplo: cbrt(last(/host/key)) [comment]: # ({/ef0cb9ef-bd8056a7}) [comment]: # ({696b523c-476b353b}) ##### ceil(valor) {#ceil} Redondea el valor al número entero mayor o igual más cercano. Parámetro: - **valor** - el valor a comprobar Por ejemplo, '2,4' se redondeará a '3'. Véase también [piso()](#piso). Ejemplo: ceil(last(/host/key)) [comment]: # ({/696b523c-476b353b}) [comment]: # ({dee428c3-5dcd529a}) ##### cos(valor) {#cos} El coseno de un valor, donde el valor es un ángulo expresado en radianes. Parámetro: - **valor** - el valor a comprobar Por ejemplo, el coseno de un valor '1' será '0,54030230586'. Ejemplo: cos(last(/host/key)) [comment]: # ({/dee428c3-5dcd529a}) [comment]: # ({a9e4704e-0bcb804d}) ##### cosh(valor) {#cosh} El coseno hiperbólico de un valor. Devuelve el valor como un número real, no como notación científica. Parámetro: - **valor** - el valor a comprobar Por ejemplo, el coseno hiperbólico de un valor '1' será '1,54308063482'. Ejemplo: cosh(last(/host/key)) [comment]: # ({/a9e4704e-0bcb804d}) [comment]: # ({b169abdb-e77ec290}) ##### cot(valor) {#cot} La cotangente de un valor, donde el valor es un ángulo expresado en radianes. Parámetro: - **valor** - el valor a comprobar Por ejemplo, la cotangente de un valor '1' será '0,54030230586'. Ejemplo: cot(last(/host/key)) [comment]: # ({/b169abdb-e77ec290}) [comment]: # ({49d843a0-1d5ff49e}) ##### degrees(valor) {#degrees} Convierte un valor de radianes a grados. Parámetro: - **valor** - el valor a comprobar Por ejemplo, un valor '1' convertido a grados será '57,2957795'. Ejemplo: degrees(last(/host/key)) [comment]: # ({/49d843a0-1d5ff49e}) [comment]: # ({7078d3f3-818dfba1}) ##### e {#e} El número de Euler (2.718281828459045). Ejemplo: e() [comment]: # ({/7078d3f3-818dfba1}) [comment]: # ({329513b5-46e0e80f}) ##### exp(valor) {#exp} El número de Euler en potencia de un valor. Parámetro: - **valor** - el valor a comprobar Por ejemplo, el número de Euler en una potencia de un valor '2' será '7.38905609893065'. Ejemplo: exp(last(/host/key)) [comment]: # ({/329513b5-46e0e80f}) [comment]: # ({ae4a884c-7a699dd2}) ##### expm1(valor) {#expm1} El número de Euler elevado a una potencia de valor menos 1. Parámetro: - **valor** - el valor a comprobar Por ejemplo, el número de Euler en una potencia de un valor '2' menos 1 será '6.38905609893065'. Ejemplo: expm1(last(/host/key)) [comment]: # ({/ae4a884c-7a699dd2}) [comment]: # ({d6651028-0ec4e450}) ##### floor(valor) {#floor} Redondea el valor hacia abajo al número entero menor o igual más cercano. Parámetro: - **valor** - el valor a comprobar Por ejemplo, '2,6' se redondeará a la baja a '2'. Véase también [ceil()](#ceil). Ejemplo: floor(last(/host/key)) [comment]: # ({/d6651028-0ec4e450}) [comment]: # ({fb4ffc82-b0a6f934}) ##### log(valor) {#log} El logaritmo natural. Parámetro: - **valor** - el valor a comprobar Por ejemplo, el logaritmo natural de un valor '2' será '0,69314718055994529'. Ejemplo: log(last(/host/key)) [comment]: # ({/fb4ffc82-b0a6f934}) [comment]: # ({e44235f6-f5d65956}) ##### log10(valor) {#log10} El logaritmo decimal. Parámetro: - **valor** - el valor a comprobar Por ejemplo, el logaritmo decimal de un valor '5' será '0,69897000433'. Ejemplo: log10(last(/host/key)) [comment]: # ({/e44235f6-f5d65956}) [comment]: # ({290c584f-05ca2759}) ##### max(,,...) {#max} El valor más alto de los valores de las métricas referenciadas. Parámetro: - **valueX**: el valor devuelto por otra función que trabaja con el historial de métricas. Ejemplo: max(avg(/host/key),avg(/host2/key2)) [comment]: # ({/290c584f-05ca2759}) [comment]: # ({0e3e22ad-21fb2e91}) ##### min(,,...) {#min} El valor más bajo de los valores de las métricas referenciadas. Parámetro: - **valueX**: el valor devuelto por otra función que trabaja con el historial de métricas. Ejemplo: min(avg(/host/key),avg(/host2/key2)) [comment]: # ({/0e3e22ad-21fb2e91}) [comment]: # ({7e4ca5a9-cbed4c8c}) ##### mod(valor,denominador) {#mod} El resto de la división. Parámetro: - **valor** - el valor a comprobar; - **denominador** - el denominador de la división. Por ejemplo, el resto de la división de un valor '5' con denominador de división '2' será '1'. Ejemplo: mod(last(/host/key),2) [comment]: # ({/7e4ca5a9-cbed4c8c}) [comment]: # ({5fae5f18-8460a32c}) ##### pi {#pi} La constante Pi (3,14159265358979). Ejemplo: pi() [comment]: # ({/5fae5f18-8460a32c}) [comment]: # ({0cb82367-d9b2cdad}) ##### power(valor,valor de potencia) {#power} El poder de un valor. Parámetro: - **valor** - el valor a comprobar; - **valor de potencia** - la enésima potencia a utilizar. Por ejemplo, la tercera potencia de un valor '2' será '8'. Ejemplo: power(last(/host/key),3) [comment]: # ({/0cb82367-d9b2cdad}) [comment]: # ({2e3144c2-fc32afde}) ##### radians(valor) {#radians} Convierte un valor de grados a radianes. Parámetro: - **valor** - el valor a comprobar Por ejemplo, un valor '1' convertido a radianes será '0,0174532925'. Ejemplo: radians(last(/host/key)) [comment]: # ({/2e3144c2-fc32afde}) [comment]: # ({91941daf-6eb2edcd}) ##### rand {#rand} Devuelve un valor entero aleatorio. Un número generado pseudoaleatorio que utiliza el tiempo como semilla (suficiente para fines matemáticos, pero no criptográficos). Ejemplo: rand() [comment]: # ({/91941daf-6eb2edcd}) [comment]: # ({7f0a355c-f724e644}) ##### round(valor, decimales) {#round} Redondea el valor a lugares decimales. Parámetro: - **valor** - el valor a comprobar; - **lugares decimales**: especifique los lugares decimales para el redondeo (también es posible 0). Por ejemplo, un valor '2,5482' redondeado a 2 decimales será '2,55'. Ejemplo: ronda(last(/host/key),2) [comment]: # ({/7f0a355c-f724e644}) [comment]: # ({12a89282-09e5becb}) ##### signum(valor) {#signum} Devuelve '-1' si un valor es negativo, '0' si un valor es cero, '1' si un valor es positivo. Parámetro: - **valor**: el valor a comprobar. Ejemplo: signum(last(/host/key)) [comment]: # ({/12a89282-09e5becb}) [comment]: # ({8b506ba0-79bdc912}) ##### sin(valor) {#sin} El seno de un valor, donde el valor es un ángulo expresado en radianes. Parámetro: - **valor** - el valor a comprobar Por ejemplo, el seno de un valor '1' será '0,8414709848'. Ejemplo: sin(last(/host/key)) [comment]: # ({/8b506ba0-79bdc912}) [comment]: # ({09da637d-b7b48127}) ##### sinh(valor) {#sinh} El seno hiperbólico de un valor, donde el valor es un ángulo expresado en radianes. Parámetro: - **valor** - el valor a comprobar Por ejemplo, el seno hiperbólico de un valor '1' será '1,17520119364'. Ejemplo: sinh(last(/host/key)) [comment]: # ({/09da637d-b7b48127}) [comment]: # ({b3339bb1-2848f7af}) ##### sqrt(valor) {#sqrt} La raíz cuadrada de un valor.
Esta función fallará con un valor negativo. Parámetro: - **valor** - el valor a comprobar Por ejemplo, la raíz cuadrada de un valor '3,5' será '1,87082869339'. Ejemplo: sqrt(last(/host/key)) [comment]: # ({/b3339bb1-2848f7af}) [comment]: # ({70ac8084-8c82ac77}) ##### sum(,,...) {#sum} La suma de los valores de las métricas a las que se hace referencia. Parámetro: - **valueX**: el valor devuelto por otra función que trabaja con el historial de métricas. Ejemplo: sum(avg(/host/key),avg(/host2/key2)) [comment]: # ({/70ac8084-8c82ac77}) [comment]: # ({f06f407d-f1010957}) ##### tan(valor) {#tan} La tangente de un valor. Parámetro: - **valor** - el valor a comprobar Por ejemplo, la tangente de un valor '1' será '1,55740772465'. Ejemplo: tan(last(/host/key)) [comment]: # ({/f06f407d-f1010957}) [comment]: # ({a6a9c548-c483c31f}) ##### truncate(valor, decimales) {#truncate} Trunca el valor a decimales. Parámetro: - **valor** - el valor a comprobar; - **lugares decimales**: especifique los lugares decimales para truncar (también es posible 0). Por ejemplo, un valor '2,5482' truncado a 2 decimales será '2,54'. Ejemplo: truncate(last(/host/clave),2) [comment]: # ({/a6a9c548-c483c31f}) [comment]: # ({544a48ff-dbea2171}) Consulte [todas las funciones admitidas](/manual/appendix/functions). [comment]: # ({/544a48ff-dbea2171})