knowledge base |

Finding items by UUID

Finding items by UUID

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:

UUID inside an occurrence

Here is the UUID in an instance creation API response:

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:
fe3b5d6b-4f14-4594-b5c2-bd632c012a15

Find occurrence

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

Learn more

Learn more about UUIDs in Rollbar.
Learn how to create an item with a custom UUID.

"Rollbar allows us to go from alerting to impact analysis and resolution in a matter of minutes. Without it we would be flying blind."

Start continuously improving your code today.

Get Started Shape