Treating Heartbeat "Unknown Errors" as Connection Failures

This setting was previously called "Password Change Error Code Translation (regex)."

The Secret Server "Heartbeat Unknown Error to Unable to Connect Translation (regex)" setting can translate UnknownError heartbeat errors into connection errors based on text, such as the error code, in the error message. Using a regular expression, which you define, Secret Server scans heartbeat UnknownError messages for specific text strings. When there is a match, Secret Server changes the UnknownError to an "Unable to Connect" heartbeat error. This setting is useful if a custom command error is interpreted as UnknownError but the message indicates it actually was unable to connect. The translated connection error will cause Secret Server to attempt another heartbeat.

Figure: Heartbeat Unknown Error to Unable to Connect Translation (regex) Setting

image-20191105131917774

The UnknownError error is very common when running scripts and commands, making the regex discrimination desirable.

Logic:

(RPC UnknownError) AND (Regex match in error message) => RPC status changed to "Unable to Connect"

Example:

.*error code is 10060.* (any error with the code 10060 changes the RPC status to "Unable to Connect")

Procedure

To configure the unknown errors to trigger connection failures:

  1. Go to Admin > Remote Password Changing. The Remote Password Changing Configuration page appears:

    image-20191203153013109

  2. Click the Configure Password Changers button. The Password Changers Configuration page appears:

    image-20191105140347335

  3. Click the link for the desired password type. Its Account page appears:

    image-20191105131917774

  4. If necessary, click the Advanced Settings link.

  5. Click the pencil icon next to Heartbeat Unknown Error to Unable to Connect Translation (regex). The Value text box appears.

  6. Determine the desired text string to search for.

  7. Type the desired regex in the Value text box.

  8. Click the Save icon next to the text box