[ZBX-8811] agent item listing consistency issues Created: 2014 Sep 23 Updated: 2017 May 30 Resolved: 2015 Apr 02 |
|
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: | richlv | Assignee: | Unassigned |
Resolution: | Fixed | Votes: | 0 |
Labels: | items | ||
Remaining Estimate: | Not Specified | ||
Time Spent: | Not Specified | ||
Original Estimate: | Not Specified |
Description |
some inconsistencies in the item section at https://www.zabbix.com/documentation/2.4/manual/config/items/itemtypes/zabbix_agent a) empty parameters sometimes are denoted with an empty cell, sometimes with a single dash "-" b) "Return value" sometimes is just a description like "Integer", but sometimes a full sentence like "Returns '1' if agent is available, nothing if unavailable." - probably should be changed to "'1' if agent is available, nothing if unavailable." all item type pages should be reviewed for all versions |
Comments |
Comment by richlv [ 2014 Dec 25 ] |
overall, it should be decided what should "Return value" describe. just the type of the value (integer, string etc) or actually what is in there ("version", "unix timestamp of system boot time" etc |
Comment by Martins Valkovskis [ 2015 Feb 11 ] |
The emphasis is on the type of value (integer, float, text), however, in cases where more specific information is of benefit (say, when a set of values, like "0" or "1" is returned), that is presented. Return value content has been improved in: |
Comment by richlv [ 2015 Mar 25 ] |
(1) thanks for the improvements - looking much better. one more inconsistency
martins-v Unified to all. RESOLVED. <richlv> very neat, thanks -> CLOSED |
Comment by richlv [ 2015 Mar 25 ] |
(2) as discussed, in the "Return value" column, let's get rid of the ending dots for all cells; martins-v RESOLVED. <richlv> thanks, looks good - CLOSED |
Comment by richlv [ 2015 Mar 25 ] |
(3) for keys that can return 0 or 1, in some entries we list 0 first, in some - 1 goes first martins-v Reordered (in agent.ping and vfs.file.exists) to list the 'smaller' value first (Nothing/0) as in all the other cases. RESOLVED. <richlv> thanks, looks good -> CLOSED |
Comment by richlv [ 2015 Mar 26 ] |
(4) in https://www.zabbix.com/documentation/3.0/manual/config/items/itemtypes/zabbix_agent/win_keys and older versions :
martins-v RESOLVED. <richlv> looks good, CLOSED |
Comment by richlv [ 2015 Mar 27 ] |
(5)
martins-v RESOLVED. <richlv> system.localtime is still missing info on when it's float, when it's integer (other issues seem to be good) martins-v It seems like it's integer or string (rather than 'float') unless i'm missing something. <richlv> oh, right - sorry martins-v Done that. RESOLVED. <richlv> neat, CLOSED |
Comment by richlv [ 2015 Mar 27 ] |
(6) it has been decided to replace all instances of "Double" with "Float" martins-v RESOLVED. <richlv> thanks, CLOSED |
Comment by richlv [ 2015 Apr 01 ] |
(7) the item listings are much more clear now - thanks. that also makes some minor issues stand out more
martins-v RESOLVED. <richlv> thanks, CLOSED |
Comment by richlv [ 2015 Apr 01 ] |
(8) system.stat description says "Virtual memory statistics.", but apparently it can also return information about faults, cpu stats etc martins-v Changed to "System statistics". RESOLVED. <richlv> thanks, CLOSED |