How do I list all connected Salt Stack minions?

Question

Sometimes my saltmaster hangs for a while on salt '*' test.ping waiting for downed minions to reply. Is there a way so see a list of connected minions, regardless of whether they respond to test.ping?

score 103 · Accepted Answer · answered Oct 23 '13 at 19:09

103

The official answer:

salt-run manage.up

Also useful are:

salt-run manage.status

salt-run manage.down

answered Oct 23 '13 at 19:09

Dan Garthwaite

3,002

2

"salt-run -d" Gives a full list of all the modules you can run with salt-run, well worth a read – Chris Huang-Leaver Oct 23 '15 at 06:12
7

salt-run manage.versions is also quite useful (reports minions' running versions and compares them to the master's) – sxc731 Nov 07 '16 at 14:29
2

Note that salt-run manage.up and manage.status appears to do a test.ping under the hood. At least, when I ran manage.up, it showed on the minions logs as test.ping..... If you want to ensure it doesn't need to send anything, use alived or one of the other manage functions – sdfgeoff Apr 26 '19 at 08:04

score 13 · Answer 2 · answered Aug 09 '13 at 19:45

13

From the master type:

ls -1 /var/cache/salt/master/minions

or:

ls -1 /etc/salt/pki/master/minions

Entering a faulty salt query (ex. salt '*' -) will also return a list of all the minions each followed by a message stating that the command is not available. You can grep/cut away the extraneous characters. Neither of these options are particularly elegant and the later doesn't address the timeout but it works while I'm looking for an answer to a similar question; "How to list all associated minions via the saltstack python api?".

answered Aug 09 '13 at 19:45

Will

301

I think something must have changed /var/cache/salt/master/minions appears to be a non-existent location now, /etc/salt/pki/master/minions is still good to go. – Oly Dungey Nov 30 '15 at 16:46
@OlyDungey Maybe it is distribution dependent. What Linux distribution were you using at that time ? – SebMa Sep 02 '22 at 08:52

score 10 · Answer 3 · answered Sep 04 '18 at 03:09

There are few new commands that makes it much more easier,

salt-run manage.alived Print a list of all minions that are up according to Salt's presence detection (no commands will be sent to minions)

salt-run manage.allowed Print a list of all minions that are up according to Salt's presence detection (no commands will be sent to minions)

salt-run manage.not_alived Print a list of all minions that are NOT up according to Salt's presence detection (no commands will be sent)

salt-run manage.not_allowed Print a list of all minions that are NOT up according to Salt's presence detection (no commands will be sent)

salt-run manage.not_joined Print a list of all minions that are NOT up according to Salt's presence detection (no commands will be sent)

score 7 · Answer 4 · answered Aug 27 '13 at 23:10

7

"salt-key -L" will list all minions that whose public keys you've accepted on your master.

answered Aug 27 '13 at 23:10

Utah_Dave

532

2

Thanks, but this lists accepted minion keys, not connected minions. – Petrus Theron Aug 28 '13 at 09:37

score 6 · Answer 5 · answered Feb 17 '17 at 06:48

6

I think one can use the grains module to achieve this:

salt '*' grains.get id

answered Feb 17 '17 at 06:48

Kurt Zhong

279
3
3

score -6 · Answer 6 · answered Jul 22 '16 at 12:28

-6

To make ping to all minions, try on salt master node:

salt '*' test.ping

answered Jul 22 '16 at 12:28

Михаил Ветчинов

1

5

Have you read the question? It specifically is about alternatives to your method because this doesn't work in some cases. – Sven Jul 22 '16 at 12:58

How do I list all connected Salt Stack minions?

6 Answers6