Refactoring: Changed remaining check parameters starting with an 's' to the new rules...
[check_mk.git] / .werks / 5535
blobeaf323be42cde620a1e9508d2eb46e1e8631399b
1 Title: Check_MK hosts can now use multiple agents
2 Level: 2
3 Component: core
4 Compatible: compat
5 Edition: cre
6 Version: 1.5.0i2
7 Date: 1511273074
8 Class: feature
10 It is now possible to configure multiple Check_MK agents for a single host.
12 With this change, you can now configure e.g. a ESX VCenter to use the ESX special agent
13 together with the regular Check_MK agent installed on the monitored host.
15 All existing hosts remain using their existing configuration after an update. Also
16 new hosts only use a single Check_MK agent using the already existing logic where
17 a) The Check_MK agent was contacted via TCP or b) a configured data source program
18 (special agent or other program invocation) was used.
20 The new feature can be enabled by changing the host attribute (on hosts or folders)
21 "Check_MK Agent" to e.g. "Contact Check_MK agent and all datasource programs". This
22 will make Check_MK use all data sources matching on this host instead of just picking
23 the first matching one. There is also an alternative option "Use all enabled datasources"
24 available which can be used to execute only the data sources matching the host.
26 On the way to this change we have changed server previously existing things:
28 <ul>
29     <li>The host tag group <tt>agent</tt> has been split into multiple tag groups to be
30     more flexible.</li>
31     <li>The tag group <tt>ping</tt> and <tt>snmp</tt> have been added and provide the options
32     which were previously available in the single <tt>agent</tt> attribute.</li>
33     <li>All these tag groups are treated as <i>builtin</i> tag groups defined by Check_MK
34     (can not be modified anymore).</li>
35     <li>Existing configurations of hosts/folders will be translated seamlessly into the new
36     format.</li>
37     <li>During updates your site will only apply the changes above in case you have an unmodified
38     <tt>agent</tt> tag group. In case you have modified it in any way, these changes will not
39     be applied and you won't be able to use the changes introduced with this werk. You will then
40     have to clean up your local changes. Once you delete your local tag group "agent", the
41     builtin one will be used automatically.</li>
42     <li>The <i>Edit host</i> dialog has split up into more independent sections, the new ones
43     are <i>Address</i> and <i>Data sources</i> to better visualize the relation of the different
44     attributes.</li>
45 </ul>
47 <i>Please note:</i> In case you are using the Web-API calls to create or modify hosts or folders
48 while setting attributes we changed with this change, you may have to change your API calls.