7. Convenience functions

7.1. Logging: ocf_log

Resource agents should use the ocf_log function for logging purposes. This convenient logging wrapper is invoked as follows:

ocf_log <severity> "Log message"

It supports following the following severity levels:

  • debug — for debugging messages. Most logging configurations suppress this level by default.
  • info — for informational messages about the agent’s behavior or status.
  • warn — for warnings. This is for any messages which reflect unexpected behavior that does not constitute an unrecoverable error.
  • err — for errors. As a general rule, this logging level should only be used immediately prior to an exit with the appropriate error code.
  • crit — for critical errors. As with err, this logging level should not be used unless the resource agent also exits with an error code. Very rarely used.