[ZBX-10017] Document that user parameters follow agent's Timeout and will be terminated then Created: 2015 Oct 29  Updated: 2017 May 30  Resolved: 2015 Nov 23

Status: Closed
Project: ZABBIX BUGS AND ISSUES
Component/s: Documentation (D)
Affects Version/s: None
Fix Version/s: None

Type: Incident report Priority: Trivial
Reporter: Oleksii Zagorskyi Assignee: Unassigned
Resolution: Fixed Votes: 0
Labels: timeout, userparameters
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

It's not very obvious if not test it with zabbix_get and recent agent versions 2.4+, so would be useful to document.
Especially a details that the forked process will be terminated.

As an example debuglog of agent 2.4.7rc1 (revision 54982):

# time zabbix_get -s localhost -k sleep[55]
ZBX_NOTSUPPORTED: Timeout while executing a shell script.

real    0m3.005s
user    0m0.004s
sys     0m0.000s

  3055:20151029:100154.734 listener #2 [processing request]
  3055:20151029:100154.734 Requested [sleep[55]]
  3055:20151029:100154.734 In zbx_popen() command:' sleep 55; echo 55'
  3055:20151029:100154.735 End of zbx_popen():9
  3058:20151029:100154.735 zbx_popen(): executing script
...
  3055:20151029:100157.734 In zbx_waitpid()
  3055:20151029:100157.734 zbx_waitpid() killed by signal 15
  3055:20151029:100157.735 End of zbx_waitpid():3058
  3055:20151029:100157.735 listener #2 [waiting for connection]

Here https://www.zabbix.com/documentation/2.4/manual/config/items/userparameters

For example we have such details documented for remote commands and that's useful, https://www.zabbix.com/documentation/2.4/manual/config/notifications/action/operation/remote_command

 Comments   
Comment by Martins Valkovskis [ 2015 Oct 30 ]

Updated documentation:

Please review, before copying to 2.0 and 2.2.

zalex_ua Looks good. Could be replicated and closed, IMO.

martins-v Thanks, copied to:

Comment by Oleksii Zagorskyi [ 2015 Nov 06 ]

(1)
Accidentally found that related details already mentioned at https://www.zabbix.com/documentation/2.4/manual/appendix/command_execution
Lack of hyperlinks or I'm too pedantic to document everything ?

I think that would be good to add internal link from https://www.zabbix.com/documentation/2.4/manual/config/items/userparameters and https://www.zabbix.com/documentation/2.4/manual/config/notifications/action/operation/remote_command to https://www.zabbix.com/documentation/2.4/manual/appendix/command_execution

Even more, I believe also for system.run[command,<mode>] key on https://www.zabbix.com/documentation/2.4/manual/config/items/itemtypes/zabbix_agent page we should add inter link to the https://www.zabbix.com/documentation/2.4/manual/appendix/command_execution

REOPENING issue to do address this sub issue.

martins-v RESOLVED

zalex_ua Looks good, thanks, may be closed.

martins-v CLOSED

Generated at Tue Apr 23 12:31:17 EEST 2024 using Jira 9.12.4#9120004-sha1:625303b708afdb767e17cb2838290c41888e9ff0.