SaltStack Config uses a web application user interface that provides the front end to RaaS, the backend API server for SaltStack Config. The interface is the central workspace to manage minions, users, roles, jobs, and more. Management tasks are available through different workspaces.

Saltstack Config Terminology

SaltStack Config contains various terminology and workspaces that you might not be familiar with.
Terminology Description
Dashboard The Dashboard can visualize various kinds of system metrics and network data, and display reports. The Dashboard creates visual reports using system metrics collected by the RaaS server. The reports can only display system data from the last 24 hours or less. To get a more detailed view of your system metrics over a longer period of time, you can use the /metrics endpoint command to export system metrics to third-party tools such as Prometheus or other monitoring and alerting tools. For more information, see Dashboard Reports.
Reports The Reports workspace provides an overview of important metrics in your SaltStack Config environment, such as number of licenses available and used, or the Salt version installed on different nodes.

You can view reports under the Home screen. Reports update automatically to reflect the current state of your system. Report data is provided for all minions. However, some reports can be filtered by target group.

In the Reports workspace, you can view important metrics in your SaltStack Config environment. The workspace provides downloads and a graph for each report type. You can also adjust the columns displayed for each report, as well as filter column data. Reports are available in either JSON or CSV format.

SaltStack Config includes these report types:
  • Key State - State of all minion keys. A minion key allows encrypted communication between a Salt master and Salt minion.
  • Licenses - Number of SaltStack Config licenses used and number of licenses available.
  • Salt master version - Salt master version installed on all Salt masters.
  • Minion version - Salt minion version in the selected target group.
  • OS version - Operating system installed on nodes in the selected target group.
  • Presence - Presence status of minions in the selected target group. Presence indicates whether SaltStack Config has received any job data from a minion recently, in a defined interval called raas_presence_expiration.
Minions The Minions workspace is used to view minion details, search for or sort minions by ID or other properies, run ad-hoc jobs or commands, and create new targets.

You can also use this workspace to adjust target settings, such as attached pillars, run jobs, accept or reject keys, as well as assign a role or pillar to a target. See Minions for more information. The Minions workspace includes a list of all Salt minions that are running the minion service and that are currently managed by SaltStack Config.

Minions are nodes running the minion service, which can listen to commands from a Salt master and perform the requested tasks. Salt masters can run the minion service, which makes it possible to configure and manage the node running the Salt contoller service as needed. A target is the group of minions, across one or many Salt masters, that a job’s Salt command applies to. By default, when you open the workspace, the All Minions target is active. The All Minions target lists all the minions you have permission to access.

In the Minions workspace, you can run an ad-hoc job or command on:

  • A single minion
  • A list of minions
  • A Salt master or all Salt masters (using salt-run)
  • A target
Minion Keys The Minion Keys workspace is used to manage minion keys. A minion key allows encrypted communication between a Salt master and Salt minion. The workspace provides an overview of all minions filtered by their respective key states. On initial connection, a Salt minion sends its public key to the Salt master, which the Salt master can accept, reject, or deny.
Activity The Activity workspace is used to monitor the status of jobs and other activities. The Activity workspace gives visibility to many types of events and activities, such as scheduled jobs, ad-hoc jobs, compliance or vulnerability assessments.
Jobs Jobs are used to run remote execution tasks, apply states, and start Salt runners. The Jobs workspace is where you can create, configure, and save job settings for reuse. Jobs are generally intended for system operations that need to be automated and executed multiple times and saves configuration time. For more information, see How do I create jobs.
Schedules Schedules are used to automate job execution. You can use the Schedules workspace to schedule one-off or recurring jobs to monitor your environment, run jobs continuously at any time, enable/disable schedules, or run a scheduled job. For more information, see How do I create jobs.
Pillars The Pillars workspace allows you to create and manage pillar data that is stored natively in SaltStack Config. Pillars are structures of data defined on the Salt master and passed through to one or more minions, using targets. They allow confidential, targeted data to be securely sent only to the relevant minion. For more information, see How do I create pillar data.
File Server The file server is a location for storing both Salt-specific files, such as top files or state files, as well as files that can be distributed to minions, such as system configuration files. In the File Server workspace, you can view, author, and save state files (YAML), and text files. Files in SaltStack Config are useful for configuring states you can then apply through jobs. Jobs are used to run remote execution tasks, apply states, and start Salt runners.

In the File Server workspace, you can create new files and clone existing ones. You can also edit and delete files.