If you need to provision the same check across a list of hosts, templates can help you accomplish that. To start using templates, you’ll have to have checks created that will serve as the "master" for the template. Add these to a new template, then provide a list of hosts for which you would like to start collecting data. These templates can also have rulesets associated with them, which lets you quickly expand your cluster or infrastructure without having to reinvent the wheel.

  1. To set up a template, go to the "Templates" page in the UI under the "Collect" section in the main menu.
         
  2. The "New Template +" button will provide a dialog to create a new template based on the checks from a current host in the system.
              
  3. Begin typing the name of a host in the "Master Host:" field and Circonus will automatically search for and suggest a host in the system to match the entered text.
             
  4. Completing this dialog will result in a new blank template.
         
  5. Unfolding this template provides the ability to add checks from the selected master host and target hosts to which the template shall be applied.

  6. Click the "Add Host +" button to open a dialog, as shown below:
             
  7. Enter a new host, select one or more hosts form the list, or filter the list to find an existing host in the list.

  8. Click the "Add Bundle +" button to open a dialog, as shown below:
             
  9. The check bundles can be renamed in click-to-edit fashion using {target} as an interpolated variable. For example, if the check bundle is renamed to "{target} http", once it is applied to the target host "foo.com", then the resulting check in the template will be named "foo.com http", as shown below:
         
  10. If the "Include Rulesets" option is checked, all the rulesets on the master Check Bundles will be copied to the Target Hosts' Check Bundles when the template is applied or re-synced.



For more information on using templates, refer to the User Documentation for Templates.


Next Step: API