This section explains how to configure vCenter Hyperic to run a custom measurement script on a scheduled basis and save metrics in in the vCenter Hyperic database along with plugin-reported metrics.

You can configure vCenter Hyperic to run a custom measurement script on a scheduled basis and save metrics in in the vCenter Hyperic database along with plugin-reported metrics. To integrate a custom script, you create a platform service of type "Script", and define the script location and any arguments on the Configuration Properties page for the service. If your script returns results, the first value in the result stream is reported as a "Result Value" metric.

If you wish to run scripts in vCenter Hyperic that provide richer monitoring than available from a configured script service, you can build a custom script plugin that reports as many metrics as you like. A script plugin includes an XML descriptor and at least one script, which can be defined externally or embedded in the XML file. The plugin can use multiple scripts or a single script; the script must output key=output pairs.

Unicode characters encountered in a script will be decoded during script processing. For example, the string "%3D" is decoded to an equals sign (=). To preserve the value of s string that might be interpreted as a Unicode character, escape the string with a double backslash, for example: \\%3D