What is pSConfig?

Introduction

pSConfig is a template framework for describing and configuring a topology of tasks. If you manage more than one perfSONAR host (or participate in a distributed community of perfSONAR measurement hosts), the following configuration tasks can quickly become unwieldy:

  1. Scheduling the tasks you want to run at each location.

  2. Maintaining visualization components to display results of the measurements from multiple hosts

pSConfig assists with these challenges by providing tools to automate each of the configuration tasks listed above.

Concepts and Terminology

It is helpful to understand a few basic terms when discussing pSConfig. Starting at the most fundamental level, a task in the context of pSConfig is a job to do consisting of a test to be carried out, scheduling information and other options. In fact, a task in pSConfig means the same thing as a task in pScheduler.

Beyond individual tasks, pSConfig is also concerned with how the tasks are interrelated and arranged, known as the task topology. Many tasks have common parameters or are related in some way, so it’s important to be able to look at the tasks as more than just a set of independent jobs. pSConfig cares about these relationships so it can be used as input to visualization components to relate the results in meaningful ways.

A pSConfig template is a description of the task topology in a machine readable format. pSConfig templates are expressed in JSON files. The templates are designed to be highly expressive and extensible so that new capabilities can easily be supported. pSConfig templates by themselves are just files, and they only become useful when something reads them and is able to perform action based on their content.

An agent is software that reads one or more pSConfig templates and uses the information to perform a specific function. There are currently multiple agents in perfSONAR:

  1. pscheduler-agent - An agent that parses one or more template(s) for measurements to be run and submits them to pScheduler

  2. grafana-agent - An agent that reads one or more template(s) and creates a Grafana dashboard to display the results

  3. hostmetrics-agent - An agent that reads one or more template(s) and configures Logstash to collect metrics about hosts

With the fundamentals out of the way, we can now bring them together to demonstrate the basic workflow of how pSConfig can be used to configure a perfSONAR deployment.

The pSConfig Workflow

The basic workflow of pSConfig is outlined in the diagram below:

_images/psconfig_intro-workflow.png

If you think you’re ready to jump right into this workflow you can see pSConfig Quickstart Guide. Otherwise, you can find more detailed information on the steps outlined by the diagram in the following sections: