Identify Users

Users consist of a few critical pieces of information that construct a unique identity in Sentry. Each of these is optional, but one must be present for the Sentry SDK to capture the user:

id
Your internal identifier for the user.

username
The username. Typically used as a better label than the internal id.

email
An alternative, or addition, to the username. Sentry is aware of email addresses and can display things such as Gravatars and unlock messaging capabilities.

ip_address
The user's IP address. If the user is unauthenticated, Sentry uses the IP address as a unique identifier for the user. Sentry will attempt to pull this from the HTTP request data, if available. That might required sendDefaultPii set to true in the SDK options. If set to "{{auto}}", Sentry will infer the IP address from the connection between your app and Sentry's server, which is useful for client applications such as a website, desktop, or mobile.

Additionally, you can provide arbitrary key/value pairs beyond the reserved names, and the Sentry SDK will store those with the user.

To identify the user:

Copied
#include <sentry.h>

sentry_value_t user = sentry_value_new_object();
sentry_value_set_by_key(user, "ip_address", sentry_value_new_string("{{auto}}"));
sentry_value_set_by_key(user, "email", sentry_value_new_string("jane.doe@example.com"));
sentry_set_user(user);

You can also clear the currently set user:

Copied
sentry_remove_user();
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) to suggesting an update ("yeah, this would be better").