Organizations and teams

More Tutorials
Organizations and teams

Invite team members and start collaborating on experiments and findings.

What are organizations and teams?

The system's resilience should never be the role of a single person. Even if you are the only one whose job title explicitly mentions Resilience or Chaos Engineering, it should be a company-wide goal. When several people are running chaos engineering experiments, they might want to see what the others are up to. A manager, even if not running experiments themselves, might want to have a global view of the team's achievements.

In ChaosIQ, organizations allow a high level view of everything that is happening. Most of the time, your organization will represent your company. In your organization view, you can get a list of all experiments and all executions ever run and published.

Teams are where the work happens. They are shared workspaces where people can collaborate on experiments and findings. Invite members of your organization to your team and unleash the Chaos on your system. With caution.

Creating an organization

An organization is created when a person signs in to ChaosIQ without having been previously invited to join an organization.

Viewing members and inviting people to your organization

From the organization view, click on the People link in the sidebar to display a list of the members of your organization.

Click on the Invite people button to invite people to join the organization.

Joining an organization

When you have been invited to join an organization, signing in to ChaosIQ will automatically make you a member of this organization.

Creating a team

You can create an unlimited number of teams in your organization. Teams can be used to gather real-life teams or members of different teams working on common projects. They are a flexible model that should be able to fit the way you and your teammates want to work.

Opening the Teams dropdown in the top-left corner of the window will list your available teams as well as allow you to create a new one.

Click the Add a team button. On the Create a new Team page, you are asked to choose a name for your organization.

When you are happy with your team name, click the Create Team button. A message will appear, telling you your organization was successfully created.

This new organization is now listed in the top-left Teams menu.

Clicking on its name will take you to the new teams's Dashboard.

Alternatively, you can use the Teams link in the top menu to view a list of the organizations you belong too and create new ones.

Adding members to a team

In a team view, click on the People link in the sidebar menu to display the list of all this team's members.

Click on the Add members button to display a list of all people that can be added to this team (they are the people in your organization that are not yet members of this team).

Publishing experiments to a team

For Chaos Toolkit to send Experiments and Executions data to a team, you must have the ChaosIQ Cloud extension installed.

$ pip install -U chaosiq-cloud

Then, sign in to ChaosIQ

$ chaos signin

You will be asked the URL of ChaosIQ. It defaults to, for SaaS users. If you use an on-premise ChaosIQ, change it to your URL and your choice will be remembered next time you sign in.

ChaosIQ then asks for a token to identify you. To generate a new token, click on the Tokens link from the top menu.

Click on Generate a Token to create a new token.

Once you have chosen a name for your token, click on the Generate Token button. A message is displayed with your token. Copy it, then switch back to your terminal and paste it.

Chaos Toolkit will then retrieve the list of organizations you belong to and asks you to choose which one you will publish to. If you only belong to one organization, ChaosIQ will skip this step. You are then asked to select which team you want to publish your experiments to. Select the one you want, and you are ready to run experiments.

If you run an experiment with the chaos run command, it will now be published to ChaosIQ and available on the Executions page.

Switching teams

Run the chaos team command again to be able to choose a new default team to publish to.

Switching Organizations

If you want to select a team from another organizations, use the chaos org command and you will be asked to select an organization and a team.