Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Examples: Test Agents

Creating and Deploying a New Test Agent

To be able to perform measurements in Paragon Active Assurance, you first need to create one or more Test Agents in your Paragon Active Assurance account. This section tells how to create virtual Test Agents using the REST API.

We proceed in the following steps, which are detailed in the following:

  1. At the outset, the account "demo" has no Test Agents in its inventory.
  2. A Test Agent called "vta1" is created through the REST API. At this stage, no real Test Agent exists yet (that is, it has not yet been started).
  3. The Test Agent is deployed in OpenStack. (Deployment on that platform is chosen here as one possibility among others.)
  4. The Test Agent connects to the Control Center account "demo" and is now ready for use.

Step 1: At the outset, there are no Test Agents in the account "demo". See the screenshot below from the Control Center web GUI.

Step 2: A Test Agent is created in Control Center using the REST API POST operation for Test Agents.

We will do this in Python below. To write the Python code, it is helpful to inspect the full range of configuration options for a Test Agent in the REST API.

  • Go to https://<Control Center host IP>/rest.
  • Under test_agent, expand the POST operation for /accounts/{account}/test_agents/.

  • Under Description, click Model.

Below, we create a Test Agent having three physical interfaces "eth0", "eth1", and "eth2", where eth0 has a DHCP address. An NTP server is configured on eth0, and eth0 is also the management interface (that is, the interface that connects to Control Center).

(The import commands are omitted from subsequent examples unless they differ from the code below. The parser commands are also omitted, since they are always the same. Regarding the REST API token and how to obtain it, read more in the section Obtaining an Authorization Token.)


If no signed SSL certificates are present, you need to add verify=False to the "requests" command: see below. This is however strongly discouraged in a production environment. You should obtain proper, signed SSL certificates to ensure an encrypted and secure connection. See also the section on SSL certificate configuration in the Installation Guide, chapter Service Configuration.

Just to show that you might as well use a different programming language, here is how to accomplish the same thing in curl:

In the absence of signed SSL certificates, you need to add the --insecure flag here.

Once the Test Agent has been created, it will exist in the configuration database and in Control Center. See the screenshot below of the Test Agent inventory, showing the Test Agent "vta1":

Step 3: It is now time to deploy the Test Agent "vta1".

In this guide we will deploy the virtual Test Agent in OpenStack. However, it is equally possible to do the deployment in some other virtualized environment.

In OpenStack the Test Agent will use cloud-init user data to retrieve the information on how to connect to Control Center. Specifically, the user data text file has the following contents:


The #cloud-config and netrounds_test_agent lines must be present, and the remaining lines must be indented.

For further information, please refer to the document "How to Deploy Virtual Test Agents in OpenStack", available at

Once the Test Agent has been deployed and has connected to Control Center, the configuration will be pushed from Control Center to the Test Agent.

Step 4: The Test Agent is now online in Control Center and has obtained its configuration. The Test Agent is ready for use in tests and monitoring. See these sections:

Listing the Test Agents in Your Paragon Active Assurance Account

Below is example Python code for listing the Test Agents in a Paragon Active Assurance account:

Running this code gives output similar to that below:

Retrieving Configuration Data and Status for a Test Agent

By applying a GET operation to an individual Test Agent, you retrieve both configuration and status information for the Test Agent and its interfaces. The status information includes online status, uptime, CPU load, and memory usage.

The output will look something like this:

Modifying the Configuration of a Test Agent

To modify the configuration of a Test Agent you use the PUT command.

PUT requires that you supply the entire configuration in the JSON data, just as when creating the Test Agent as described in the section Creating and Deploying a New Test Agent. The code for doing this is therefore the same as for Test Agent creation, except that the URL points to a specific, existing Test Agent

and the PUT command

is used instead of POST.

Updating Test Agent Software

The REST API provides a POST operation for updating Test Agent software to the latest version, either for all Test Agents or for a specified subset.

Below is an example of how to apply a software update to a subset of Test Agents:

If you want to update software on all Test Agents, leave json_data empty and append the ?all switch to the URL:

Test Agents: Advanced Examples

In order to make use of all configuration options for the Test Agent (or indeed any other entity in the REST API), you need to be familiar with the REST API Swagger schema.

As previously mentioned, a link to the schema in JSON format is provided at the top of the page. This is rather hard to read; to make the content easier to parse, you can copy the file into the following page:

which will convert the schema to more human-readable YAML.

Note that in the examples below, some parts of the schemas have been rearranged for greater readability, rather than sorted alphabetically.

For example, say that we want to configure a Test Agent with a static IPv4 address.

We will do this by construcing the body of a HTTP POST request.

The end goal is to construct this request:

The question is, how do we know this is how we should format it?

To find out the correct syntax, we need to consult the Test Agent schema. In fact, we need to check out the extended version of it; search for TestAgentExtendedSchema in the Swagger schema:

To begin with, this schema has name and description as attributes. The HTTP request body should therefore begin as follows:

Some of the properties are defined as read-only. These can be omitted from the request, since they will be ignored by the server.

Now for the interface configuration, and more specifically the IP address, which take a bit more work.

The address is specified in the interface_config property, which contains a reference to InterfaceConfigSchema as seen below:

We can start by adding to our request:

This would add an empty interface_config, so to understand how to construct the interface_config JSON object we must go to the InterfaceConfigSchema part of the schema:

The schema has a property named type which is required. This is used to specify which type of interface we want to define. This type has a list of valid choices, which is represented in the schema as an enum.

The discriminator part of the schema is used to point us to the specific type we need to use.

For people familiar with object-oriented programming (OOP) an analogy to this would be "inheritance", or polymorphism.

The InterfaceConfigSchema has a list of subtypes which are defined in the enum.

In our case, we want a "normal" network interface, so we should specify physical as our type.

So now we can look up the schema for the physical type:

Here the allOf attribute is used to say that the physical interface type has all properties from InterfaceConfigSchema, as well as the properties listed inline.

That is, it "inherits" the properties from InterfaceConfigSchema in OOP terminology.

So we can continue constructing our HTTP POST request body. Since we want a static IPv4 address, we specify address rather than address6 which is for IPv6.

So, using the same process we now look up InterfaceIPv4AddressSchema:

Again, we specify the type, which is used to identify the specific schema to use. We want static_ip4 as found in the enum:

We then look up the schema for static_ip4:

Here we can see that we need to specify the ip property. In general, in Netrounds, IP addresses are entered using the CIDR notation.

All the other properties here are optional.

So now we can finalize our JSON:

Deleting a Test Agent

After a test has completed, it might be relevant in some use cases to delete the Test Agent.

Below is code for doing this through the REST API: