Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This article is part of a series:
Part 1 - Creating Custom Service Monitors in up.time
Part 2 - Creating Custom Service Monitors with Retained Data Collection
Part 3 - Creating Plug-in Service Monitors in up.time

up.time provides many built in service monitors that allow you to monitor and alert on a wide array of services and applications within your enterprise. However, the standard up.time service monitors may not be adequate to monitor all of the systems, applications and proprietary devices in your environment. In some cases, you may want to capture metrics that are unique to your environment. To do this, you can define custom service monitors to monitor custom services and applications to provide the level of in depth performance monitoring that you require. Using custom service monitors, you can monitor and graph historical performance data from just about any device in your environment.

...

  • To get started with custom scripts, or for implementations with only a handful of custom monitor instances, use agentcmd. The agentcmd utility is commonly called in the format listed below to execute a command on the agent side system. Please note that this utility is a helper tool, if you are using many custom monitor instances we recommend using an alternate tool.
    This example uses the settings that were configured above to execute the agent side script:

    Format:

    Code Block
    languagetext
    /usr/local/uptime/scripts/agentcmd [-s/+s] -p [agent port] [agent hostname] rexec [password] [path]

    Example:

    Code Block
    languagetext
    /usr/local/uptime/scripts/agentcmd -p 9998 my-agent rexec secretpassword /opt/uptime-agent/my-scripts/show_temp.sh my-arguments

    For more information click on Using the syntax used with agentcmd, see this Knowledge Base articleagentcmd Utility.

  • If you plan on implementing a number of custom monitor instances, use netcat. netcat must be downloaded and installed on the monitoring station if it isn't already installed as part of your operating system. The netcat utility is commonly called in the format listed below to execute a command on the agent side system. This example uses the settings that were configured above to execute the agent side script:

    Format:

    Code Block
    languagetext
    echo -n rexec [password] [path] | /usr/local/uptime/bin/netcat [agent hostname] [agent port]

    Example:

    Code Block
    languagetext
    echo -n rexec secretpassword /opt/uptime-agent/my-scripts/show_temp.sh my-arguments | /usr/local/uptime/bin/netcat my-agent 9998

...