Project Configurations

Getting the Most out of your Projects

Rollbar's multi-project support allows your teams to set up their projects to best suit their needs. This is especially convenient for microservice architectures that have a large number of independent codebases. Each codebase will have its own range of settings and alerts, so each team can have lots of control over its Rollbar experience.

Project Duplication

Projects that have been configured and properly setup can be used as a template when creating new Projects within Rollbar. New Projects can created quickly with important settings preconfigured including integrations, notifications, and user defined rate limits.

Duplicating Projects using the Rollbar REST API is supported by using the Create Project Endpoint when the Project ID of the source Project is supplied as a parameter.

Which settings are copied to a new Project?

  • Members/Teams
  • Access Token Rate Limits (user defined rate limits)
  • Environments
  • Source Control Integration (except the repository name)
  • Notifications (active and disabled)
  • Service Links
  • Auto-Resolve settings
  • IP Blocklist

Which settings are NOT copied to a new Project?

  • Source maps
  • dSyms
  • Flutter Symbols
  • ProGuard

📘

Using the Rollbar Terraform Provider is another way to define project configuration templates.

Project Access Tokens

Each project has its own set of access tokens for various purposes such as reporting occurrences and using the Rollbar API. The post_client_item and post_server_item tokens are used to send occurrences for front-end and back-end frameworks, respectively. The read and write tokens are used for API calls.

One of the more important concerns for a Rollbar account administrator is occurrence volume. Since billing and overages are dictated by occurrences, it's crucial to maintain responsible consumption of your allotment. Project access tokens have built-in rate limiting; the rate limit is editable for each token.

2416

A view of some active project access tokens, with the first having a user-defined rate limit of 2000 requests/day

Source Control

Each project will have its own source control integration since projects usually have their own repositories. You will need to follow the instructions in this guide to get the full benefit of the integration, and this process will also enable the Versions feature for Advanced and Enterprise accounts. By completing this integration, you will have detailed information about the code in the stack traces of your items.

Notifications

Notification rules control all of your alerting and issue tracking integrations, so it is very important to configure these responsibly and iterate on them as your project evolves. This article from the Rollbar Knowledge base reviews some best practices for configuring your notification rules.

Service Links

Service links allow users to quickly navigate from an item detail menu to other tools and services without losing context. By creating templated links using project fields, users will have dynamically generated URLs for quick navigation to other Rollbar menus and external addresses.

2120

A handful of service links

There are 3 different service links in the screenshot above, each one pointing to a different website. The first link does a simple Google search for the item's exception message. The second link executes an RQL query to retrieve all occurrences with the same exception message as the item. The third link opens a Datadog APM search around the request URL from the item.

Auto-Resolve

One easy way to reduce the amount of housekeeping efforts required for an account is to configure one or both of the auto-resolve options for items in your project. There are two options for auto-resolve, auto-resolving whenever there is a new deploy and auto-resolving inactive items after a certain time window. Each one is configurable by environment, giving you more control and allowing you to prioritize your higher environments.

Auto-Resolve on Deploy

This option essentially gives you a clean slate for a given project/environment whenever a new version of code is deployed. Any item that does not resurface after the deploy will stay resolved, regardless of whether or not it was actually fixed. This keeps users focused on the more frequent/impactful issues and reduces clutter caused by undergrouping.

2174

Auto-resolve on deploy

Auto-Resolve Inactive Items

The other option for auto-resolving in a Rollbar project is through a timer on inactive items. This essentially gives your items an expiration window, and all issues that fall out of that window are automatically resolved. You can set different time ranges for different environments, allowing you to focus more heavily on production issues.

2112

Auto-resolve settings for a sample project. The development environment has a substantially lower timeout window to make sure production issues are prioritized.