Salt (or SaltStack) is configuration management software that’s designed to automate infrastructure setup. Metricly’s formula will help get our Linux agent running on all of your minions quickly, so you can start seeing basic host data (as well as collector information if you so choose) for your whole environment using a single command.
- Add the netuitive-agent-formula to a directory on your Salt master.
mkdir -p /metricly/formulas cd /metricly/formulas git clone https://github.com/netuitive/netuitive-agent-formula.git
- Add the new directory to file_roots:
file_roots: base: - /srv/salt - /metricly/formulas/netuitive-agent-formula
- Restart the Salt Master.
- Include the formula in an existing state tree or from a top file. Read more about this as well as about using formulas here.
- Copy the contents of our example salt pillar and merge it into your pillar file.
- Edit the default pillar settings as necessary, ensuring you maintain proper nesting and formatting.
Nested collectors should have their own separate section in the pillar file.
- Replace the
api_keyvalue with the Linux integration API key from Metricly. To find this API key, point to the user account menu in the top right-hand corner of Metricly and select Integrations. Your Linux API key is found next to the integration listed as INFRASTRUCTURE.
- Run the init.sls script.
- Apply the formula to all of your salt minions.
sudo salt '*' state.apply netuitive-agentThe pillar applies to your minions universally. If you want a minion to use a different version of a collector from a separate pillar file, you’ll need to specify which minion in your top.sls file. If you update the pillar file, you’ll need to reapply the pillar to your minions.