|
Current page that describes history.push method does not say a word about the error field in response. In my understanding:
Zabbix server will only perform validation and set the error in response if validation fails. Validation includes:
| Validation |
Error |
| User has read permission to item's host. |
No permissions to referred object or it does not exist. |
| Get item from configuration cache. |
No permissions to referred object or it does not exist. |
| Item status is Enabled. |
Item is disabled. |
| Item type is one of trapper or http agent. |
Unsupported item type. |
| If item type is http agent trapping is enabled. |
HTTP agent item trapping is not enabled. |
| Host status is Monitored. |
Host is not monitored. |
| Host status is not In maintenance without data collection. |
Host is in maintenance without data collection. |
| If item's Allowed hosts is set the client IP is allowed. |
Client IP is not in item's allowed hosts list. |
| There is no item that has values with duplicate timestamps on nanosecond level. |
Duplicate timestamp found. |
No error field in response only means the above mentioned validations succeeded. It might be so that an item will get an error during preprocessing or fail at attempt to save the value to the database later, resulting in an item becoming NOTSUPPORTED. In other words, there is no guarantee that if the response contains no error field, the value is in the database. Instead, it means the value was accepted for processing.
Also, the fact that it is enough to have a "read" permission on a host in order to push values to its items not obvious for everyone. Some would expect the user must have "write" permissions.
Is the above correct? I strongly believe this is valuable information to add to our documentation.
| 
image-2023-09-08-10-57-23-848.png
Team A