Table of Contents
13 Trapper items
Overview
Trapper items accept incoming data instead of querying for it.
It is useful for any data you might want to "push" into Áú»¢¶Ä²©.
To use a trapper item you must:
- have a trapper item set up in Áú»¢¶Ä²©
- send in the data into Áú»¢¶Ä²©
Configuration
Item configuration
To configure a trapper item:
- Go to: Configuration → Hosts
- Click on Items in the row of the host
- Click on Create item
- Enter parameters of the item in the form
The fields that require specific information for trapper items are:
| Type | Select Áú»¢¶Ä²© trapper here. |
| Key | Enter a key that will be used to recognize the item when sending in data. |
| Type of information | Select the type of information that will correspond the format of data that will be sent in. |
| Allowed hosts | If specified, the trapper will accept incoming data only from this comma-delimited list of hosts. Hosts are identified by IP address/DNS name. For example: Single IP: 192.168.1.33 List of IP addresses: 192.168.56.5, 192.168.56.6, 192.168.56.7 Single DNS name: testzabbix.zabbix.com List of DNS names: testzabbix, testzabbix.zabbix.com, testzabbix1.zabbix.com Spaces and user macros are allowed in this field since Áú»¢¶Ä²© 2.2.0. |
You may have to wait up to 60 seconds after saving the item until the server picks up the changes from a configuration cache update, before you can send in values.
Sending in data
In the simplest of cases, we may use zabbix_sender utility to send in some 'test value':
To send in the value we use these keys:
-z - to specify Áú»¢¶Ä²© server IP address
-p - to specify Áú»¢¶Ä²© server port number (10051 by default)
-s - to specify the host (make sure to use the 'technical' host name here, instead of the 'visible' name)
-k - to specify the key of the item we just defined
-o - to specify the actual value to send
Áú»¢¶Ä²© trapper process does not expand macros used in the item key in attempt to check corresponding item key existence for targeted host.
Display
This is the result in Monitoring → Latest data:
Timestamps
If values are sent using zabbix_sender from a file with timestamps, then these timestamps will be adjusted to match server time. For instance, if an item's timestamp is "10:30:50", the current time on zabbix_sender's machine is "10:40:03", and the current time on Áú»¢¶Ä²© server's machine is "10:40:05", then the item's value will be stored in the database with a timestamp of "10:30:52".
Similarly, if a value is first sent to Áú»¢¶Ä²© proxy, which later sends it to Áú»¢¶Ä²© server, the timestamp will be first adjusted to match Áú»¢¶Ä²© proxy time, and then it will be adjusted to match Áú»¢¶Ä²© server time.