PixoMonitorDocs

Teams

Teams help you organize your monitoring by group, department, or project. Assign monitors and members to teams to keep your PixoMonitor workspace organized as it grows.

What Are Teams?

Teams are a way to organize your PixoMonitor workspace:

  • Group monitors by project, service, or responsibility
  • Control access by assigning members with specific roles
  • Simplify alerts by routing notifications to team channels
  • Filter views to show only relevant monitors

Example teams:

  • "Backend API Team"
  • "Frontend Team"
  • "DevOps"
  • "Customer Success" (view-only access to status)

Creating a Team

1

Navigate to Teams

Go to Settings → Teams and click Create Team.

2

Name your team

Choose a clear, descriptive name:

  • Name after the project: "Payment Service Team"
  • Name after the function: "Infrastructure Team"
  • Name after the group: "Engineering"
3

Add a description (optional)

Describe what this team is responsible for. This helps new members understand the team's scope.

4

Add team members

Invite members and assign their roles.

5

Assign monitors

Add existing monitors to the team or create new ones within the team.

Team Roles

Each team member has a role that determines what they can do within the team.

Owner

The team owner has full control over the team.

Can:

  • Manage all team settings
  • Add and remove members
  • Change member roles
  • Delete the team
  • Create, edit, and delete monitors
  • Manage alert channels
  • View all data

Best for: Team leads, managers, or the person responsible for the team's monitoring.

Each team must have at least one owner. The person who creates the team is automatically made the owner.

Admin

Admins have most of the same permissions as owners, with some restrictions.

Can:

  • Add and remove members (except owners)
  • Create, edit, and delete monitors
  • Manage alert channels
  • Configure team settings
  • View all data

Cannot:

  • Remove or demote owners
  • Delete the team
  • Transfer ownership

Best for: Senior engineers, tech leads who manage the team's monitoring day-to-day.

Member

Members can work with monitors but have limited administrative access.

Can:

  • Create and edit monitors
  • Acknowledge and resolve incidents
  • View all team data
  • Configure their own alert preferences

Cannot:

  • Add or remove team members
  • Delete monitors they didn't create
  • Change team settings
  • Manage alert channels

Best for: Engineers who work with the monitoring but don't need to manage the team.

Viewer

Viewers have read-only access to the team's data.

Can:

  • View monitors and their status
  • View incidents and history
  • View status pages
  • View SLA reports

Cannot:

  • Create or modify monitors
  • Acknowledge or resolve incidents
  • Change any settings
  • Add or remove members

Best for: Stakeholders, customer success, managers who need visibility without edit access.

Managing Team Members

Inviting Members

1

Open team settings

Go to your team and click Settings or Members.

2

Click Add Member

You can add existing workspace users or invite new ones via email.

3

Select their role

Choose the appropriate role (Owner, Admin, Member, or Viewer).

4

Send invitation

The person will receive an email to join the team.

Changing Roles

To change a member's role:

  1. Go to Team Settings → Members
  2. Find the member
  3. Click the role dropdown
  4. Select the new role

Only owners can promote someone to owner or demote another owner. Be careful when assigning owner roles.

Removing Members

To remove a member from a team:

  1. Go to Team Settings → Members
  2. Find the member
  3. Click Remove or the trash icon
  4. Confirm the removal

The removed member:

  • Loses access to the team's monitors
  • Is removed from team alert channels
  • Can no longer view team data

Leaving a Team

Members can leave teams they no longer need access to:

  1. Go to the team's page
  2. Click Leave Team
  3. Confirm

Owners cannot leave a team until they transfer ownership to another member or delete the team.

Assigning Monitors to Teams

Adding Existing Monitors

1

Open the monitor

Go to the monitor you want to assign.

2

Edit monitor settings

Click Edit or Settings.

3

Select the team

In the team dropdown, select the team to assign this monitor to.

4

Save changes

The monitor now belongs to the selected team.

Creating Monitors Within a Team

When creating a new monitor:

  1. Choose the team before creating
  2. Or select the team in the monitor creation form

The monitor will be created within that team's scope.

Unassigned Monitors

Monitors don't have to belong to a team. Unassigned monitors are:

  • Visible to all workspace members
  • Managed according to workspace-level permissions
  • Good for shared infrastructure or global services

Team-Based Filtering

Dashboard Filtering

Filter your dashboard to show only specific team's monitors:

  1. Use the team filter dropdown
  2. Select one or more teams
  3. View only those monitors

Alert Filtering

Set up alerts to go to team-specific channels:

  • Team Slack channel
  • Team email distribution list
  • Team PagerDuty schedule

Best Practices

Team Structure

By service/project:

  • "API Team" owns all API monitors
  • "Web Team" owns frontend monitors
  • "Database Team" owns database monitors

By responsibility:

  • "DevOps" owns infrastructure monitors
  • "Engineering" owns application monitors
  • "QA" has viewer access to all

By customer/product:

  • "Product A Team"
  • "Product B Team"
  • "Enterprise Team"

Start simple with 2-3 teams. You can always reorganize as your needs become clearer.

Role Assignment

Give minimum necessary access. If someone only needs to view status, make them a Viewer. If they need to create monitors, make them a Member.

Limit owners. Each team should have 1-2 owners maximum. Too many owners creates confusion about who's responsible.

Use Admin for day-to-day management. Admins can do most things without the risk of team deletion.

Cross-Team Monitors

Some monitors might be relevant to multiple teams. Options:

  1. Keep unassigned — Available to everyone
  2. Assign to a shared team — Create an "Infrastructure" team for shared resources
  3. Duplicate monitors — Each team gets their own (not recommended, harder to maintain)

Onboarding New Members

When someone joins:

  1. Add them to relevant teams
  2. Start with Viewer or Member role
  3. Upgrade permissions as needed
  4. Point them to the team's monitors and documentation

Offboarding Members

When someone leaves:

  1. Remove them from all teams
  2. Review monitors they created
  3. Reassign ownership if needed
  4. Update alert channels (remove their personal email, etc.)

Team vs. Workspace Permissions

PixoMonitor has two levels of permissions:

Workspace level:

  • Applies to the entire PixoMonitor account
  • Controls who can access the workspace at all
  • Manages billing and global settings

Team level:

  • Applies within specific teams
  • Controls access to team monitors and data
  • Someone can have different roles in different teams

Example: Alice might be:

  • A Viewer in the "Marketing" team (sees their status page)
  • An Admin in the "Engineering" team (manages their monitors)
  • An Owner in the "Infrastructure" team (full control)

Troubleshooting

"You don't have permission"

This error means your role doesn't allow that action. Ask a team Owner or Admin to:

  • Grant you a higher role
  • Perform the action for you

Can't see a monitor

The monitor might belong to a team you're not part of:

  • Ask to be added to the team
  • Or ask the team to share access

Removed from team by mistake

Contact a team Owner to re-add you. Your previous role and settings can be restored.

Team has no owner

If the only owner left, contact PixoMonitor support. They can help assign a new owner.

Next Steps

Creating Monitors

Set up monitors for your team

Alert Channels

Configure team notification channels

On-Call Schedules

Set up on-call rotations for your team