[ZBX-9168] item key helper & manual differences Created: 2014 Dec 24 Updated: 2017 May 30 Resolved: 2015 Jan 16 |
|
Status: | Closed |
Project: | ZABBIX BUGS AND ISSUES |
Component/s: | Documentation (D), Frontend (F) |
Affects Version/s: | None |
Fix Version/s: | 2.0.15rc1, 2.2.9rc1, 2.4.4rc1, 2.5.0 |
Type: | Incident report | Priority: | Trivial |
Reporter: | richlv | Assignee: | Unassigned |
Resolution: | Fixed | Votes: | 0 |
Labels: | itemkeyhelper | ||
Remaining Estimate: | Not Specified | ||
Time Spent: | Not Specified | ||
Original Estimate: | Not Specified |
Description |
there are some differences between the item key helper and list of the keys in the manual
|
Comments |
Comment by richlv [ 2014 Dec 25 ] | ||||||||||||||||
note that description texts SHOULD NOT BE CHANGED at this time, even when they miss some detail - all of them should be reviewed and updated at once to reduce the amount of work translators have to do | ||||||||||||||||
Comment by richlv [ 2014 Dec 25 ] | ||||||||||||||||
decisions to be made (updated after discussing with maartinjsh) :
| ||||||||||||||||
Comment by richlv [ 2014 Dec 31 ] | ||||||||||||||||
zabbix 1.8 is not supported anymore, so this should be fixed in 2.0 and up (primarily because system.localtime is missing the param completely) | ||||||||||||||||
Comment by richlv [ 2014 Dec 31 ] | ||||||||||||||||
| ||||||||||||||||
Comment by Aleksandrs Saveljevs [ 2015 Jan 09 ] | ||||||||||||||||
(1) In 2.0 branch, some agent keys are missing in the item helper:
asaveljevs Not sure what "incorrect item keys" means. Therefore, listing differences that are still present between 2.0 manual at https://www.zabbix.com/documentation/2.0/manual/config/items/itemtypes/zabbix_agent and https://www.zabbix.com/documentation/2.0/manual/config/items/itemtypes/zabbix_agent/win_keys, and item helper:
<richlv> missing item keys added in r51550; only "description" column from the manual was used to keep things simpler for 2.0. "incorrect item keys" was meant to be keys that don't just use a different word to refer to a specific parameter (like "regexp" vs "pattern"), but keys that omitted the fact that item key had any parameters at all, for example. from the above list, all of the differences seem to be in how item key parameters are denoted/named - to keep the number of changes to 2.0 low, it is proposed not to modify key parameters for this branch. RESOLVED asaveljevs CLOSED | ||||||||||||||||
Comment by Aleksandrs Saveljevs [ 2015 Jan 09 ] | ||||||||||||||||
(2) Some lines in the 2.0 diff go like this: -ROW |7 |system.cpu.num ... +ROW |7 |system.cpu.num[<type>] ... HTML entities should probably be used instead of raw angle brackets: +ROW |7 |system.cpu.num[<type>] ... <richlv> ouch, sorry about that. should be fixed in r51549. asaveljevs CLOSED | ||||||||||||||||
Comment by richlv [ 2015 Jan 13 ] | ||||||||||||||||
(3) in 2.2 branch, the following keys are missing :
adding these would also add translatable strings, thus it is proposed to postpone this until all item descriptions are unified in item pages ( asaveljevs Fixing description for items like "system.swap.size[device,type]", where description still refers to the old "swap" and "mode", will have to be postponed until | ||||||||||||||||
Comment by richlv [ 2015 Jan 13 ] | ||||||||||||||||
(4) asterisk (*) was changed to "service" in service_state key parameters in :
RESOLVED asaveljevs CLOSED | ||||||||||||||||
Comment by richlv [ 2015 Jan 14 ] | ||||||||||||||||
merged to 2.0 in r51594, 2.2 in r51599, 2.4 in r51600, trunk in r51604. | ||||||||||||||||
Comment by richlv [ 2015 Jan 14 ] | ||||||||||||||||
(5) no translation changes asaveljevs Until r51604, everything is good, but see (7). CLOSED. <richlv> it was decided not to change anything in (7), still no changed strings, remains CLOSED | ||||||||||||||||
Comment by richlv [ 2015 Jan 14 ] | ||||||||||||||||
(6) conflicts were resolved when merging to 2.4 (net.tcp.service and net.tcp.service.perf keys) and trunk (net.dns and net.dns.record keys) - a quick check on that would be appreciated asaveljevs CLOSED | ||||||||||||||||
Comment by Aleksandrs Saveljevs [ 2015 Jan 14 ] | ||||||||||||||||
(7) In 2.2 and above, descriptions of passive and active versions of net.tcp.service[] differ. Unifying them would remove one translatable string. <richlv> it was discovered that actually the difference is between agent & simple check descriptions, and those indeed are slightly different -> nothing to change, CLOSED |