Skip to content

Program Configuration Attributes

Gurpartap edited this page Dec 22, 2012 · 10 revisions

The listed attributes may be specified when defining a process for Cognizant to monitor. See Loading Configuration into the Monitoring Daemon to see how to define these attributes.

Note that name and start_command are the only required attributes.

See the accompanying documentation links for default values and additional notes for these attributes.

Common Attributes

  • (true, false) autostart Whether or not to auto start the process on initial run.
  • (String) chdir The current working directory for the process to start with.
  • (String) chroot The chroot directory to change the process' idea of the file system root.
  • (true, false) daemonize Whether or not to daemonize the process.
  • (Hash) env Environment variables for process.
  • (String) errfile The file to log the daemon's STDERR stream into.
  • (String) gid Run the process as the given user group.
  • (String) group Group classification for the process.
  • (Array) groups Supplementary user groups for the process.
  • (String) logfile The file to log the process' STDOUT stream into.
  • (String) name Unique name for the process.
  • (String) pid_command The command that returns the pid of the process.
  • (String) pidfile The pid lock file for the process.
  • (String) ping_command The command to check the running status of the process with.
  • (String) uid Run the process as the given user.
  • (Integer) umask Limit the permission modes for files and directories created by the process.

See Cognizant::Process::Attributes documentation for up to date information about common configuration attributes.

Start Attributes

  • (String) start_before_command The command to run before the process is started.
  • (String) start_command The command to start the process with.
  • (String) start_after_command The command to run after the process is started.
  • (Hash) start_env Environment variables for process during start.
  • (String) start_with_input Start the process with this in it's STDIN.
  • (String) start_with_input_command Start the process with this command's output in it's (process') STDIN.
  • (String) start_with_input_file Start the process with this file's data in it's STDIN.
  • (String) start_timeout The grace time period in seconds for the process to start within.

See Cognizant::Process::Actions::Start documentation for up to date information about common configuration attributes.

Stop Attributes

  • (String) stop_before_command The command to run before the process is stopped.
  • (String) stop_command The command to stop the process with.
  • (String) stop_after_command The command to run after the process is stopped.
  • (Array) stop_signals The signals to pass to the process one by one attempting to stop it.
  • (Hash) stop_env Environment variables for process during stop.
  • (String) stop_timeout The grace time period in seconds for the process to stop within.

See Cognizant::Process::Actions::Stop documentation for up to date information about stop configuration attributes.

Restart Attributes

  • (String) restart_before_command The command to run before the process is restarted.
  • (String) restart_command The command to restart the process with.
  • (String) restart_after_command The command to run after the process is restarted.
  • (Array) restart_signals The signals to pass to the process one by one attempting to restart it.
  • (Hash) restart_env Environment variables for process during restart.
  • (String) restart_timeout The grace time period in seconds for the process to stop within (for restart).

See Cognizant::Process::Actions::Restart documentation for up to date information about restart configuration attributes.

Other Attributes

Attributes for specifying conditions are specified in the relevant documentation.