UUID in general
A universally unique identifier (UUID) is a 128-bit number used to identify information in computer systems. When generated according to the standard methods, UUIDs are, for practical purposes, unique. Unlike most other numbering schemes, their uniqueness does not depend on a central registration authority or coordination between the parties generating them. While the probability that a UUID will be duplicated is not zero, it is close enough to zero to be negligible.
How Rollbar uses UUID
In Rollbar, each item and the corresponding occurrences have UUIDs based on this pattern: aaaaaaaa-bbbb-cccc-dddd-eeeeffffeeee.
Our system uses UUIDs to differentiate occurrences from each other; while you can use them for searching and identifying those.
Finding items by UUID
First, let see where you can find UUIDs. The two most common places are the UI and Rollbar API responses.
Here you can see a UUID inside an occurrence:
Here is the UUID in an instance creation API response:
As every occurrence have its own UUID, regardless if those were created through an API or by a Rollbar SDK, your logs and error messages might show you some, or even your customers can send you one along with their issue.
To easily navigate to the corresponding occurrence on our UI, we created an easy-to-use search link.
In our last example, we will use the UUID from the first clip:
In Rollbar, we have two types of UUID search links. One for the Items: https://rollbar.com/item/uuid/?uuid=aaaaaaaa-bbbb-cccc-dddd-eeeeffffeeee
And one for the Occurrences: https://rollbar.com/occurrence/uuid/?uuid=aaaaaaaa-bbbb-cccc-dddd-eeeeffffeeee