Using the Log to Text Action

The Log to Text File Action uses Percent Variables to gather information about your network devices and logs a custom message to a specified text file with the Percent Variable results. You can specify the name and location of an existing text file or create a new file and location to which the message will be written.

This action is useful if you would rather receive network messages in a text file that can be saved, as an alternative to receiving an email or SMS alert.

To configure a Log to Text Action:

  1. Go to the Action Library:
    • From the web interface, click GO. The GO menu appears.
    • If the WhatsUp section is not visible, click WhatsUp. The WhatsUp section of the GO menu appears.
    • Select Configure > Action Library. The Action Library appears.

      - or -

    • From the main menu bar of the console, select Configure > Action Library. The Action Library appears.
  2. In the Action Library, do one of the following:
    • Click New, then select Log to Text.

      - or -

    • Select an existing Log to Test Action, then click Edit. The action properties page appears.
  3. Specify or select the appropriate information in the dialog fields.
    • Specify a Name for the action as it will appear in the Action Library.
    • Specify a short Description for the action as it will appear in the Action Library.
    • Specify the full path to the Log file to which the text will be written.

      Tip: On the console, click the Browse button to browse to the log file.

    • Select the Log file write mode. Select Append to have log messages appended to the Log file. Select Overwrite to have log messages overwrite existing log messages.
    • Enter the Log Message..that will be written to the log file. This message supports percent variables. The default log message is:

      %Device.ActiveMonitorDownNames is %Device.State on %Device.Type: %Device.HostName (%Device.Address).

      Details:

      Monitors that are down include: %Device.ActiveMonitorDownNames

      Monitors that are up include: %Device.ActiveMonitorUpNames

      Notes on this device (from device property page):

      %Device.Notes

      ----------------------------------------

      This message was logged on %System.Date at %System.Time

      Ipswitch WhatsUp Gold

      Tip: Right-click in the Log Message field to select the percent variables you would like to use in the action.

  4. Click OK to save changes.