salt.modules.node

Module for full system inspection.

salt.modules.node.inspect(mode='all', priority=19, **kwargs)

Start node inspection and save the data to the database for further query.

Parameters:

  • mode: Clarify inspection mode: configuration, payload, all (default)

    payload
    • filter: Comma-separated directories to track payload.

  • priority: (advanced) Set priority of the inspection. Default is low priority.

CLI Example:

salt '*' node.inspect
salt '*' node.inspect configuration
salt '*' node.inspect payload filter=/opt,/ext/oracle
salt.modules.node.query(scope, **kwargs)

Query the node for specific information.

Parameters:

  • scope: Specify scope of the query.

    • System: Return system data.

    • Software: Return software information.

    • Services: Return known services.

    • Identity: Return user accounts information for this system.
      accounts

      Can be either 'local', 'remote' or 'all' (equal to "local,remote"). Remote accounts cannot be resolved on all systems, but only those, which supports 'passwd -S -a'.

      disabled

      True (or False, default) to return only disabled accounts.

    • payload: Payload scope parameters:
      filter

      Include only results which path starts from the filter string.

      time

      Display time in Unix ticks or format according to the configured TZ (default) Values: ticks, tz (default)

      size

      Format size. Values: B, KB, MB, GB

      type

      Include payload type. Values (comma-separated): directory (or dir), link, file (default) Example (returns everything): type=directory,link,file

      owners

      Resolve UID/GID to an actual names or leave them numeric (default). Values: name (default), id

      brief

      Return just a list of payload elements, if True. Default: False.

    • all: Return all information (default).

CLI Example:

salt '*' node.query scope=os
salt '*' node.query payload type=file,link filter=/etc size=Kb brief=False