Release Notes 326 (May 2024)

These are public release notes for ProTop 326. They include changes, fixes, and additions to the client-side code that monitors your OpenEdge resources and sends metric data and alerts to your ProTop portal.

Feature Added support for API keys for portal communication.
Feature Improved the monitoring of Pro2 queue status.
Added visibility for the cdcadmin queue when CDC is in use.
Updated the data-sharing between the cdcq and pro2qmon data collectors.
Feature Added support for the local definition of special key mappings (comma-prefixed command keys for ProTop RT) via file etc/keys.local.cfg.
Feature
Added detail counters for classic App Server status values: Starting, Receiving, Connecting, Connected, Running, Limbo. These can be found in alert.cfg. Also added the capability for translation of these values.
Feature Added logging to dc/pasoe.p at dbgMode >= 4 to write pseudo-curl commands and record JSON responses for OEM err responses.
Use echo 4 > tmp/protop.name.dbg or tmp/pt3agent.name.dbg to enable it. This works for ProTop RT and pt3agent.
Feature
Added logging in dc/pasoe.p at dbgMode >= 3 to write pseudo-curl commands and record JSON responses written to $TMPDIR/pasoe.<shortname>.details.
Feature Added a dbgMode >= 5 for "unknown response type" in the socket code.
Feature
Added German translation for classic app server, including support for dd.mm.yyyy date formatting; added translation file estub/translate.cfg.german.
Feature
Updated the protermcap to improve the visibility of INPUT fields with PuTTY, split xterm color definitions from the base xterm definition, and created an xterm-mono variation.
Feature
Updated the default output directory so that when utilities and reports run stand-alone, they will use ProTop directories if the environment variables are set.
Feature
Added the environment variable UPLOADUIO=yes|no. If not set to "yes" it suppresses the upload of tt_uio (_UserIO data) to the portal. This allows the userIOActivity data collector to be enabled in pt3agent.cfg, thus populating related alert enhancers without sending ridiculous amounts of data to the portal.
Feature
Fixed the startup process to honor the usual cfg file hierarchy for logmon. Also added an optional “friendlyName” parameter to bin/logmon.sh so that both logmon.cfg & log_*.cfg can be fine-grained and multiple instances (with distinct names) can be run.
Feature Added support for "script" alerts to util/logmon.p.
Feature Added the diskfree alert enhancer to dc/df.p.
Feature Added support for portal port, options, and proxy settings to util/maintenance.p.
Feature Changed the log monitors' nag checks to be specific to the monitored log file.
Feature
Added headers to portal messages to aid in detecting cloned servers and/or cloned ProTop installs so we can detect when multiple agents may be updating the same resource.
Feature Added support for Consultingwerk's Service Telemetry.
Feature
Added monochrome xterm option to support putty and SecureCRT better. Set your terminal to xterm-256color in your emulator settings (SecureCRT: Terminal > Emulation > Advanced > Terminal Type) to use ProTop colors or e.g. set TERM=xterm-256color in your .bash_profile
   
Bug fix We fixed the logic in config.p so we can correctly parse the tainted flags in the master block to detect a failed idxbuild state.
Bug fix Fixed a typo in the definition of the INPUT color in protermcap.protop.
Bug fix
Fix for the file handle leak in dbmonitor.p/pt3clean.p. pt3clean.p no longer stops and restarts dbmonitor. Also, some ProTop log deletions only happen when they are older than 14 days to aid debugging.
Bug fix Updated the ProTop help URL in the help screen in ProTop RT.
Bug fix Fixed a bug that prevented syncio.bat from working (in ProTop 326-preview3 and later).
Bug fix Improved error handling to deal with data collectors that are defined but missing.
Bug fix Adjusted the column width for the zResourceDetails alert enhancer "Resource" column.
Bug fix Accommodate overstuffed character field in the alert context.
Bug fix Made improvements to the fileio data collector performance.
Bug fix Added some context variables so that webget can follow the hierarchy.
Bug fix Improved error handling for invalid HTTP responses.
Bug fix Added some missing key definitions to protermcap.protop.
Bug fix
We added the "raw" argument to LENGTH() functions in HTTP response handling to size strings going into MEMPTRs properly, allowing us to handle multi-byte characters.