Properties

Properties are key-value pairs that can be used to add additional information to your services, experiments and runs. They can be used to store metadata about the service or experiment, such as the service owner, experiment's purpose, the team responsible for it, the outcome, or just a note of a specific run or any other relevant information.

In general, a user can only assign properties and capture values that have been defined by an administrator. Once you — or your administrator — have defined the property, you can assign and capture values per experiment design or experiment run.

Examples

• Defining a service's business criticality

  • Your administrator has defined a property definition called serviceCriticality with the data type Enumeration.

  • Your administrator has assigned the property definition serviceCriticality to all services and marked it as required.

  • Whenever an administrator or team owner adds or edits a service, they can capture the value of the property (e.g. Tier 0 - Mission Critical).

• Adding a mandatory cost center field to each experiment

  • Your administrator has defined a property definition called costCenter with the data type Number.

  • Your administrator has assigned the property definition costCenter to all experiment designs and marked it as required.

  • You need to fill out the cost center for each experiment you want to run.

• Adding a note to a single experiment run

  • Your administrator has defined a property definition called note with the data type Rich Text.

  • You can add the property note to a single experiment run that you are allowed to edit, and fill out a Markdown value like "This experiment was really great!".

Assign Properties

Properties defined by your administrator can be assigned to a single service by administrators or team owners, and to an experiment design or run by any team member. This way, everyone can add additional context to your experiment designs or for a specific run. Properties assigned to an experiment design or an experiment run can be removed later on. Properties copied from the experiment design to a run cannot be removed later.

Property Assignments in Experiment's 'Manage Properties'

A property assignment configuration consists of the following fields:

• Property Definition Key: The referenced property definition assigned to the experiment design or run.

• Mandatory: A checkbox indicating whether a value is required or not. If checked, the property must be filled in before the experiment can be run.

• Allow editing the value in the experiment run: A checkbox indicating whether the property can be edited at run-level. If checked, the property can be edited in the run details page.

Edit a Property Assignment

API

Properties can also be assigned using the following API endpoints. Check out Integrate with Steadybit / API to learn how to access the API.

• Assign properties to a service

• Assign properties to an experiment design

• Assign properties to an experiment run

Property Values

Property values are the actual values of the properties that are saved as part of an experiment design and copied to each experiment run. Variables are fully supported for the input fields of all properties (including overrides for single runs or via schedules).

Properties in the experiment editor

Properties in the run view

API

Properties' values can also be read and edited using the following API endpoints. Check out Integrate with Steadybit / API to learn how to access the API.

• Update the properties of a service

• Update the properties of an experiment design

• Get the properties of an experiment run

• Update properties of an experiment run after it has completed