Zabbix Documentation 3.0

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


manual:discovery:auto_registration

Differences

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

Link to this comparison view

Next revision
Previous revision
manual:discovery:auto_registration [2014/09/25 14:42]
sasha Page moved from 2.4:manual:discovery:auto_registration to manual:discovery:auto_registration
manual:discovery:auto_registration [2019/03/06 07:54] (current)
martins-v removing incorrect information
Line 17: Line 17:
 == Specify server == == Specify server ==
  
-Make sure you have the Zabbix server identified in the agent [[:2.4/manual/appendix/config/zabbix_agentd|configuration file]] - zabbix_agentd.conf+Make sure you have the Zabbix server identified in the agent [[manual:appendix:config:zabbix_agentd|configuration file]] - zabbix_agentd.conf
  
   ServerActive=10.0.0.1   ServerActive=10.0.0.1
Line 27: Line 27:
 == Action for active agent auto-registration == == Action for active agent auto-registration ==
  
-When server receives an auto-registration request from an agent it calls an [[:2.4/manual/config/notifications/action|action]]. An action of event source "Auto registration"​ must be configured for agent auto-registration.+When server receives an auto-registration request from an agent it calls an [[manual:config:notifications:action|action]]. An action of event source "Auto registration"​ must be configured for agent auto-registration.
  
-<​note>​Setting up [[:​2.4/​manual/​discovery/​network_discovery|network discovery]] is not required to have active agents auto-register.</​note>​+<​note>​Setting up [[network_discovery|network discovery]] is not required to have active agents auto-register.</​note>​
  
 In the Zabbix frontend, go to //​Configuration -> Actions//, select //Auto registration//​ as the event source and click on //Create action//: In the Zabbix frontend, go to //​Configuration -> Actions//, select //Auto registration//​ as the event source and click on //Create action//:
Line 38: Line 38:
  
 <note tip>If the hosts that will be auto-registering are likely to be supported for active monitoring only (such as hosts that are firewalled from your Zabbix server) then you might want to create a specific template like //​Template_Linux-active//​ to link to.</​note>​ <note tip>If the hosts that will be auto-registering are likely to be supported for active monitoring only (such as hosts that are firewalled from your Zabbix server) then you might want to create a specific template like //​Template_Linux-active//​ to link to.</​note>​
 +
 +Created hosts are added to the //​Discovered hosts// group (by default, configurable in //​Administration//​ -> //General// -> //​[[:​manual/​web_interface/​frontend_sections/​administration/​general#​other_parameters|Other]]//​).
  
 === Using host metadata === === Using host metadata ===
Line 43: Line 45:
 When agent is sending an auto-registration request to the server it sends its hostname. In some cases (for example, Amazon cloud nodes) a hostname is not enough for Zabbix server to differentiate discovered hosts. Host metadata can be optionally used to send other information from an agent to the server. When agent is sending an auto-registration request to the server it sends its hostname. In some cases (for example, Amazon cloud nodes) a hostname is not enough for Zabbix server to differentiate discovered hosts. Host metadata can be optionally used to send other information from an agent to the server.
  
-Host metadata is configured in the agent [[:2.4/manual/appendix/config/zabbix_agentd|configuration file]] - zabbix_agentd.conf. There are 2 ways of specifying host metadata in the configuration file:+Host metadata is configured in the agent [[manual:appendix:config:zabbix_agentd|configuration file]] - zabbix_agentd.conf. There are 2 ways of specifying host metadata in the configuration file:
  
   HostMetadata   HostMetadata
Line 50: Line 52:
 See the description of the options in the link above. See the description of the options in the link above.
  
-<​note:​important>​An auto-registration attempt happens every time an active agent sends a request to refresh active checks to the server. The delay between requests is specified in the [[:2.4/manual/appendix/config/zabbix_agentd|RefreshActiveChecks]] parameter of the agent. The first request is sent immediately after the agent is restarted.</​note>​+<​note:​important>​An auto-registration attempt happens every time an active agent sends a request to refresh active checks to the server. The delay between requests is specified in the [[manual:appendix:config:zabbix_agentd|RefreshActiveChecks]] parameter of the agent. The first request is sent immediately after the agent is restarted.</​note>​
  
 == Example 1 == == Example 1 ==
Line 95: Line 97:
 Add the next line to the agent configuration file: Add the next line to the agent configuration file:
  
-  HostMetadataLinux    21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae+  HostMetadata=Linux    21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae
  
 where "​Linux"​ is a platform, and the rest of the string is some hard-to-guess secret text. where "​Linux"​ is a platform, and the rest of the string is some hard-to-guess secret text.