manual:discovery:low_level_discovery

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:discovery:low_level_discovery [2020/04/22 08:35]
martins-v update interval can only be set to 0 if flexible or scheduled intervals exist with a non-zero value (ZBX-17601)
manual:discovery:low_level_discovery [2021/01/27 19:24] (current)
Line 25: Line 25:
 To configure the discovery, do the following: To configure the discovery, do the following:
  
-  * Go to: //​Configuration//​ -> //​Templates//​  +  * Go to: //​Configuration//​ -> //Templates// or //Hosts// 
-  * Click on //​Discovery//​ in the row of an appropriate template+  * Click on //​Discovery//​ in the row of an appropriate template/host
  
 {{manual:​discovery:​low_level_discovery:​fs_templates.png|}} {{manual:​discovery:​low_level_discovery:​fs_templates.png|}}
Line 46: Line 46:
 |//​Key// ​ |Enter the discovery item key.\\ For example, you may use the built-in %%"​%%vfs.fs.discovery%%"​%% item key to return a JSON with the list of file systems present on the computer and their types.\\ Note that another option for filesystem discovery is using discovery results by the %%"​%%vfs.fs.get%%"​%% agent key, supported since Zabbix 4.0.17 (see [[:​manual/​discovery/​low_level_discovery/​mounted_filesystems|example]]). ​ | |//​Key// ​ |Enter the discovery item key.\\ For example, you may use the built-in %%"​%%vfs.fs.discovery%%"​%% item key to return a JSON with the list of file systems present on the computer and their types.\\ Note that another option for filesystem discovery is using discovery results by the %%"​%%vfs.fs.get%%"​%% agent key, supported since Zabbix 4.0.17 (see [[:​manual/​discovery/​low_level_discovery/​mounted_filesystems|example]]). ​ |
 |//Update interval// ​ |This field specifies how often Zabbix performs discovery. In the beginning, when you are just setting up file system discovery, you might wish to set it to a small interval, but once you know it works you can set it to 30 minutes or more, because file systems usually do not change very often.\\ [[:​manual/​appendix/​suffixes|Time suffixes]] are supported, e.g. 30s, 1m, 2h, 1d, since Zabbix 3.4.0.\\ [[:​manual/​config/​macros/​usermacros|User macros]] are supported, since Zabbix 3.4.0.\\ //Note//: The update interval can only be set to '​0'​ if custom intervals exist with a non-zero value. If set to '​0',​ and a custom interval (flexible or scheduled) exists with a non-zero value, the item will be polled during the custom interval duration.\\ //Note// that for an existing discovery rule the discovery can be performed immediately by pushing the //Check now// [[#​form_buttons|button]]. | |//Update interval// ​ |This field specifies how often Zabbix performs discovery. In the beginning, when you are just setting up file system discovery, you might wish to set it to a small interval, but once you know it works you can set it to 30 minutes or more, because file systems usually do not change very often.\\ [[:​manual/​appendix/​suffixes|Time suffixes]] are supported, e.g. 30s, 1m, 2h, 1d, since Zabbix 3.4.0.\\ [[:​manual/​config/​macros/​usermacros|User macros]] are supported, since Zabbix 3.4.0.\\ //Note//: The update interval can only be set to '​0'​ if custom intervals exist with a non-zero value. If set to '​0',​ and a custom interval (flexible or scheduled) exists with a non-zero value, the item will be polled during the custom interval duration.\\ //Note// that for an existing discovery rule the discovery can be performed immediately by pushing the //Check now// [[#​form_buttons|button]]. |
-|//Custom intervals// ​ |You can create custom rules for checking the item:\\ **Flexible** - create an exception to the //Update interval// (interval with different frequency)\\ **Scheduling** - create a custom polling schedule.\\ For detailed information see [[manual:​config:​items:​item:​custom_intervals|Custom intervals]]. Scheduling is supported since Zabix 3.0.0. ​ |+|//Custom intervals// ​ |You can create custom rules for checking the item:\\ **Flexible** - create an exception to the //Update interval// (interval with different frequency)\\ **Scheduling** - create a custom polling schedule.\\ For detailed information see [[manual:​config:​items:​item:​custom_intervals|Custom intervals]]. Scheduling is supported since Zabbix ​3.0.0. ​ |
 |//Keep lost resources period// ​ |This field allows you to specify the duration for how long the discovered entity will be retained (won't be deleted) once its discovery status becomes %%"​%%Not discovered anymore%%"​%% (between 1 hour to 25 years; or %%"​%%0%%"​%%).\\ [[:​manual/​appendix/​suffixes|Time suffixes]] are supported, e.g. 2h, 1d, since Zabbix 3.4.0.\\ [[:​manual/​config/​macros/​usermacros|User macros]] are supported, since Zabbix 3.4.0.\\ //Note:// If set to %%"​%%0%%"​%%,​ entities will be deleted immediately. Using %%"​%%0%%"​%% is not recommended,​ since just wrongly editing the filter may end up in the entity being deleted with all the historical data.   | |//Keep lost resources period// ​ |This field allows you to specify the duration for how long the discovered entity will be retained (won't be deleted) once its discovery status becomes %%"​%%Not discovered anymore%%"​%% (between 1 hour to 25 years; or %%"​%%0%%"​%%).\\ [[:​manual/​appendix/​suffixes|Time suffixes]] are supported, e.g. 2h, 1d, since Zabbix 3.4.0.\\ [[:​manual/​config/​macros/​usermacros|User macros]] are supported, since Zabbix 3.4.0.\\ //Note:// If set to %%"​%%0%%"​%%,​ entities will be deleted immediately. Using %%"​%%0%%"​%% is not recommended,​ since just wrongly editing the filter may end up in the entity being deleted with all the historical data.   |
 |//​Description// ​ |Enter a description. ​ | |//​Description// ​ |Enter a description. ​ |