Available data transformations for SAM component monitors
SAM provides a number of predefined data transformation functions that may be applied to one or more component monitors to generate mathematically manipulated results.
The following table lists available transformation functions:
Data Transformation | Syntax | Definition |
---|---|---|
Euler’s Number |
E()
|
Euler’s number, also called "the number e," is defined as the base of the natural logarithm as the limit of a certain sequence, or as the sum of a certain series. |
Pi |
Pi()
|
Pi is the mathematical constant whose value is the ratio of any circle's circumference to its diameter. |
Rounding |
|
Provides a number that is rounded to the specified number of decimal places. |
Truncate |
|
Truncates a monitored value to a designated number of decimal places. |
Square Root |
Sqrt({value})
|
Provides the square root of a given number. |
Exponentiation |
Pow({base value}, {exponent value})
|
Provides the result from repeated multiplication of the base number. |
Temperature: Celsius to |
CToF({value})
|
Provides the Fahrenheit result originally presented in Celsius |
Temperature: Fahrenheit to |
FToC({value})
|
Provides the Celsius result originally presented in Fahrenheit |
X to Kilobyte |
XToKilo({value})
|
Provides the number of KB originally presented in Bytes |
X to Megabyte |
XToMega({value})
|
Provides the number of MB originally presented in Bytes |
X to Gigabyte |
XToGiga({value})
|
Provides the number of GB, originally presented in Bytes |
X to Terabyte |
XToTera({value})
|
Provides the number of TB, originally presented in Bytes |
Kilobyte to |
KiloToMega({value})
|
Provides the number of MB, originally presented in Kilobytes |
Kilobyte to |
KiloToGiga({value})
|
Provides the number of GB, originally presented in Kilobytes |
Kilobyte to |
KiloToTera({value})
|
Provides the number of TB, originally presented in Kilobytes |
Megabyte to |
MegaToGiga({value})
|
Provides the number of GB, originally presented in Megabytes |
Megabyte to |
MegaToTera({value})
|
Provides the number of TB, originally presented in Megabytes |
Gigabyte to |
GigaToTera({value})
|
Provides the number of TB, originally presented in GB |
Terabyte to Kilobyte |
TeraToKilo({value})
|
Provides the number of KB, originally presented in TB |
Terabyte to Megabyte |
TeraToMega({value})
|
Provides the number of MB, originally presented in TB |
Terabyte to Gigabyte |
TeraToGiga({value})
|
Provides the number of GB, originally presented in TB |
Nest multiple data transformations
To apply multiple data transformations, you can nest them within each other.
For example, if a value is originally presented in bytes and you want to convert it to gigabytes, and then truncate the results, you can use the following transformations together:
X to Gigabyte
Truncate
The format for X to Gigabyte would be XToGiga({value})
If you add Truncate to the transformation, the format would be Truncate(XToGiga({value}),{number of decimal places})
In most cases “{value}”
would be replaced by ${statistic}
for a SAM component monitor so the ending format would be:
Truncate(XToGiga(${statistic}),{number of decimal places})