relay_event_schema/protocol/
event.rs

1use std::fmt;
2use std::str::FromStr;
3
4use relay_common::time;
5use relay_protocol::{
6    Annotated, Array, Empty, FiniteF64, FromValue, Getter, GetterIter, IntoValue, Object, Val,
7    Value,
8};
9use sentry_release_parser::Release as ParsedRelease;
10use uuid::Uuid;
11
12use crate::processor::ProcessValue;
13use crate::protocol::{
14    AppContext, Breadcrumb, Breakdowns, BrowserContext, ClientSdkInfo, Contexts, Csp, DebugMeta,
15    DefaultContext, DeviceContext, EventType, Exception, Fingerprint, GpuContext, LenientString,
16    Level, LogEntry, Measurements, Metrics, MonitorContext, OsContext, ProfileContext, RelayInfo,
17    Request, ResponseContext, RuntimeContext, Span, SpanId, Stacktrace, Tags, TemplateInfo, Thread,
18    Timestamp, TraceContext, TransactionInfo, User, Values,
19};
20
21/// Wrapper around a UUID with slightly different formatting.
22#[derive(Debug, Copy, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
23pub struct EventId(pub Uuid);
24
25impl EventId {
26    /// Creates a new event id using a UUID v4.
27    #[inline]
28    pub fn new() -> Self {
29        Self(Uuid::new_v4())
30    }
31
32    /// Creates a new completely zeroed event id.
33    pub fn nil() -> Self {
34        Self(Uuid::nil())
35    }
36
37    /// Tests if the UUID is nil.
38    #[inline]
39    pub fn is_nil(&self) -> bool {
40        self.0.is_nil()
41    }
42}
43
44impl Default for EventId {
45    #[inline]
46    fn default() -> Self {
47        Self::new()
48    }
49}
50
51relay_protocol::derive_string_meta_structure!(EventId, "event id");
52
53impl ProcessValue for EventId {}
54
55impl fmt::Display for EventId {
56    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
57        write!(f, "{}", self.0.as_simple())
58    }
59}
60
61impl FromStr for EventId {
62    type Err = <Uuid as FromStr>::Err;
63
64    fn from_str(uuid_str: &str) -> Result<Self, Self::Err> {
65        uuid_str.parse().map(EventId)
66    }
67}
68
69relay_common::impl_str_serde!(EventId, "an event identifier");
70
71impl TryFrom<&SpanId> for EventId {
72    type Error = <EventId as FromStr>::Err;
73
74    fn try_from(value: &SpanId) -> Result<Self, Self::Error> {
75        // TODO: Represent SpanId as bytes / u64 so we can call `Uuid::from_u64_pair`.
76        let s = format!("0000000000000000{value}");
77        s.parse()
78    }
79}
80
81#[derive(Debug, FromValue, IntoValue, ProcessValue, Empty, Clone, PartialEq)]
82pub struct ExtraValue(#[metastructure(max_depth = 7, max_bytes = 16_384)] pub Value);
83
84impl<T: Into<Value>> From<T> for ExtraValue {
85    fn from(value: T) -> ExtraValue {
86        ExtraValue(value.into())
87    }
88}
89
90/// An event processing error.
91#[derive(Clone, Debug, Default, PartialEq, Empty, FromValue, IntoValue, ProcessValue)]
92pub struct EventProcessingError {
93    /// The error kind.
94    #[metastructure(field = "type", required = true)]
95    pub ty: Annotated<String>,
96
97    /// Affected key or deep path.
98    pub name: Annotated<String>,
99
100    /// The original value causing this error.
101    pub value: Annotated<Value>,
102
103    /// Additional data explaining this error.
104    #[metastructure(additional_properties, pii = "maybe")]
105    pub other: Object<Value>,
106}
107
108/// The grouping config that should be used for grouping this event.
109///
110/// This is currently only supplied as part of normalization and the payload
111/// only permits the ID of the algorithm to be set and no parameters yet.
112#[derive(Clone, Debug, Default, PartialEq, Empty, FromValue, IntoValue, ProcessValue)]
113pub struct GroupingConfig {
114    /// The id of the grouping config.
115    #[metastructure(max_chars = 128)]
116    pub id: Annotated<String>,
117    /// The enhancements configuration.
118    pub enhancements: Annotated<String>,
119}
120
121/// The sentry v7 event structure.
122#[derive(Clone, Debug, Default, PartialEq, Empty, FromValue, IntoValue, ProcessValue)]
123#[metastructure(process_func = "process_event", value_type = "Event")]
124pub struct Event {
125    /// Unique identifier of this event.
126    ///
127    /// Hexadecimal string representing a uuid4 value. The length is exactly 32 characters. Dashes
128    /// are not allowed. Has to be lowercase.
129    ///
130    /// Even though this field is backfilled on the server with a new uuid4, it is strongly
131    /// recommended to generate that uuid4 clientside. There are some features like user feedback
132    /// which are easier to implement that way, and debugging in case events get lost in your
133    /// Sentry installation is also easier.
134    ///
135    /// Example:
136    ///
137    /// ```json
138    /// {
139    ///   "event_id": "fc6d8c0c43fc4630ad850ee518f1b9d0"
140    /// }
141    /// ```
142    #[metastructure(field = "event_id")]
143    pub id: Annotated<EventId>,
144
145    /// Severity level of the event. Defaults to `error`.
146    ///
147    /// Example:
148    ///
149    /// ```json
150    /// {"level": "warning"}
151    /// ```
152    pub level: Annotated<Level>,
153
154    /// Version
155    pub version: Annotated<String>,
156
157    /// Type of the event. Defaults to `default`.
158    ///
159    /// The event type determines how Sentry handles the event and has an impact on processing, rate
160    /// limiting, and quotas. There are three fundamental classes of event types:
161    ///
162    ///  - **Error monitoring events**: Processed and grouped into unique issues based on their
163    ///    exception stack traces and error messages.
164    ///  - **Security events**: Derived from Browser security violation reports and grouped into
165    ///    unique issues based on the endpoint and violation. SDKs do not send such events.
166    ///  - **Transaction events** (`transaction`): Contain operation spans and collected into traces
167    ///    for performance monitoring.
168    ///
169    /// Transactions must explicitly specify the `"transaction"` event type. In all other cases,
170    /// Sentry infers the appropriate event type from the payload and overrides the stated type.
171    /// SDKs should not send an event type other than for transactions.
172    ///
173    /// Example:
174    ///
175    /// ```json
176    /// {
177    ///   "type": "transaction",
178    ///   "spans": []
179    /// }
180    /// ```
181    #[metastructure(field = "type")]
182    pub ty: Annotated<EventType>,
183
184    /// Manual fingerprint override.
185    ///
186    /// A list of strings used to dictate how this event is supposed to be grouped with other
187    /// events into issues. For more information about overriding grouping see [Customize Grouping
188    /// with Fingerprints](https://docs.sentry.io/data-management/event-grouping/).
189    ///
190    /// ```json
191    /// {
192    ///     "fingerprint": ["myrpc", "POST", "/foo.bar"]
193    /// }
194    #[metastructure(skip_serialization = "empty")]
195    pub fingerprint: Annotated<Fingerprint>,
196
197    /// Custom culprit of the event.
198    ///
199    /// This field is deprecated and shall not be set by client SDKs.
200    #[metastructure(max_chars = 200, pii = "maybe")]
201    pub culprit: Annotated<String>,
202
203    /// Transaction name of the event.
204    ///
205    /// For example, in a web app, this might be the route name (`"/users/<username>/"` or
206    /// `UserView`), in a task queue it might be the function + module name.
207    #[metastructure(max_chars = 200, trim_whitespace = true)]
208    pub transaction: Annotated<String>,
209
210    /// Additional information about the name of the transaction.
211    #[metastructure(skip_serialization = "null")]
212    pub transaction_info: Annotated<TransactionInfo>,
213
214    /// Time since the start of the transaction until the error occurred.
215    pub time_spent: Annotated<u64>,
216
217    /// Custom parameterized message for this event.
218    #[metastructure(legacy_alias = "sentry.interfaces.Message", legacy_alias = "message")]
219    #[metastructure(skip_serialization = "empty")]
220    pub logentry: Annotated<LogEntry>,
221
222    /// Logger that created the event.
223    #[metastructure(
224        max_chars = 64, // DB-imposed limit
225        deny_chars = "\r\n",
226    )]
227    pub logger: Annotated<String>,
228
229    /// Name and versions of all installed modules/packages/dependencies in the current
230    /// environment/application.
231    ///
232    /// ```json
233    /// { "django": "3.0.0", "celery": "4.2.1" }
234    /// ```
235    ///
236    /// In Python this is a list of installed packages as reported by `pkg_resources` together with
237    /// their reported version string.
238    ///
239    /// This is primarily used for suggesting to enable certain SDK integrations from within the UI
240    /// and for making informed decisions on which frameworks to support in future development
241    /// efforts.
242    #[metastructure(skip_serialization = "empty_deep", max_depth = 7, max_bytes = 8192)]
243    pub modules: Annotated<Object<String>>,
244
245    /// Platform identifier of this event (defaults to "other").
246    ///
247    /// A string representing the platform the SDK is submitting from. This will be used by the
248    /// Sentry interface to customize various components in the interface, but also to enter or
249    /// skip stacktrace processing.
250    ///
251    /// Acceptable values are: `as3`, `c`, `cfml`, `cocoa`, `csharp`, `elixir`, `haskell`, `go`,
252    /// `groovy`, `java`, `javascript`, `native`, `node`, `objc`, `other`, `perl`, `php`, `python`,
253    /// `ruby`
254    pub platform: Annotated<String>,
255
256    /// Timestamp when the event was created.
257    ///
258    /// Indicates when the event was created in the Sentry SDK. The format is either a string as
259    /// defined in [RFC 3339](https://tools.ietf.org/html/rfc3339) or a numeric (integer or float)
260    /// value representing the number of seconds that have elapsed since the [Unix
261    /// epoch](https://en.wikipedia.org/wiki/Unix_time).
262    ///
263    /// Timezone is assumed to be UTC if missing.
264    ///
265    /// Sub-microsecond precision is not preserved with numeric values due to precision
266    /// limitations with floats (at least in our systems). With that caveat in mind, just send
267    /// whatever is easiest to produce.
268    ///
269    /// All timestamps in the event protocol are formatted this way.
270    ///
271    /// # Example
272    ///
273    /// All of these are the same date:
274    ///
275    /// ```json
276    /// { "timestamp": "2011-05-02T17:41:36Z" }
277    /// { "timestamp": "2011-05-02T17:41:36" }
278    /// { "timestamp": "2011-05-02T17:41:36.000" }
279    /// { "timestamp": 1304358096.0 }
280    /// ```
281    pub timestamp: Annotated<Timestamp>,
282
283    /// Timestamp when the event has started (relevant for event type = "transaction")
284    #[metastructure(omit_from_schema)] // we only document error events for now
285    pub start_timestamp: Annotated<Timestamp>,
286
287    /// Timestamp when the event has been received by Sentry.
288    pub received: Annotated<Timestamp>,
289
290    /// Server or device name the event was generated on.
291    ///
292    /// This is supposed to be a hostname.
293    #[metastructure(pii = "true", max_chars = 256, max_chars_allowance = 20)]
294    pub server_name: Annotated<String>,
295
296    /// The release version of the application.
297    ///
298    /// **Release versions must be unique across all projects in your organization.** This value
299    /// can be the git SHA for the given project, or a product identifier with a semantic version.
300    #[metastructure(
301        max_chars = 200,  // release ends in tag
302        // release allowed chars are validated in the sentry-release-parser crate!
303        required = false,
304        trim_whitespace = true,
305        nonempty = true,
306        skip_serialization = "empty"
307    )]
308    pub release: Annotated<LenientString>,
309
310    /// Program's distribution identifier.
311    ///
312    /// The distribution of the application.
313    ///
314    /// Distributions are used to disambiguate build or deployment variants of the same release of
315    /// an application. For example, the dist can be the build number of an XCode build or the
316    /// version code of an Android build.
317    #[metastructure(
318        allow_chars = "a-zA-Z0-9_.-",
319        trim_whitespace = true,
320        required = false,
321        nonempty = true
322    )]
323    pub dist: Annotated<String>,
324
325    /// The environment name, such as `production` or `staging`.
326    ///
327    /// ```json
328    /// { "environment": "production" }
329    /// ```
330    #[metastructure(
331        max_chars = 64,
332        // environment allowed chars are validated in the sentry-release-parser crate!
333        nonempty = true,
334        required = false,
335        trim_whitespace = true
336    )]
337    pub environment: Annotated<String>,
338
339    /// Deprecated in favor of tags.
340    #[metastructure(max_chars = 256, max_chars_allowance = 20)]
341    #[metastructure(omit_from_schema)] // deprecated
342    pub site: Annotated<String>,
343
344    /// Information about the user who triggered this event.
345    #[metastructure(legacy_alias = "sentry.interfaces.User")]
346    #[metastructure(skip_serialization = "empty")]
347    pub user: Annotated<User>,
348
349    /// Information about a web request that occurred during the event.
350    #[metastructure(legacy_alias = "sentry.interfaces.Http")]
351    #[metastructure(skip_serialization = "empty")]
352    pub request: Annotated<Request>,
353
354    /// Contexts describing the environment (e.g. device, os or browser).
355    #[metastructure(legacy_alias = "sentry.interfaces.Contexts")]
356    pub contexts: Annotated<Contexts>,
357
358    /// List of breadcrumbs recorded before this event.
359    #[metastructure(legacy_alias = "sentry.interfaces.Breadcrumbs")]
360    #[metastructure(skip_serialization = "empty")]
361    pub breadcrumbs: Annotated<Values<Breadcrumb>>,
362
363    /// One or multiple chained (nested) exceptions.
364    #[metastructure(legacy_alias = "sentry.interfaces.Exception")]
365    #[metastructure(field = "exception")]
366    #[metastructure(skip_serialization = "empty")]
367    pub exceptions: Annotated<Values<Exception>>,
368
369    /// Event stacktrace.
370    ///
371    /// DEPRECATED: Prefer `threads` or `exception` depending on which is more appropriate.
372    #[metastructure(skip_serialization = "empty")]
373    #[metastructure(legacy_alias = "sentry.interfaces.Stacktrace")]
374    pub stacktrace: Annotated<Stacktrace>,
375
376    /// Simplified template error location information.
377    /// DEPRECATED: Non-Raven clients are not supposed to send this anymore, but rather just report
378    /// synthetic frames.
379    #[metastructure(legacy_alias = "sentry.interfaces.Template")]
380    #[metastructure(omit_from_schema)]
381    pub template: Annotated<TemplateInfo>,
382
383    /// Threads that were active when the event occurred.
384    #[metastructure(skip_serialization = "empty")]
385    pub threads: Annotated<Values<Thread>>,
386
387    /// Custom tags for this event.
388    ///
389    /// A map or list of tags for this event. Each tag must be less than 200 characters.
390    #[metastructure(skip_serialization = "empty", pii = "maybe")]
391    pub tags: Annotated<Tags>,
392
393    /// Arbitrary extra information set by the user.
394    ///
395    /// ```json
396    /// {
397    ///     "extra": {
398    ///         "my_key": 1,
399    ///         "some_other_value": "foo bar"
400    ///     }
401    /// }```
402    #[metastructure(max_depth = 7, max_bytes = 262_144)]
403    #[metastructure(pii = "true", skip_serialization = "empty")]
404    pub extra: Annotated<Object<ExtraValue>>,
405
406    /// Meta data for event processing and debugging.
407    #[metastructure(skip_serialization = "empty")]
408    pub debug_meta: Annotated<DebugMeta>,
409
410    /// Information about the Sentry SDK that generated this event.
411    #[metastructure(field = "sdk")]
412    #[metastructure(skip_serialization = "empty")]
413    pub client_sdk: Annotated<ClientSdkInfo>,
414
415    /// Information about the Relays that processed this event during ingest.
416    #[metastructure(max_depth = 5, max_bytes = 2048)]
417    #[metastructure(skip_serialization = "empty", omit_from_schema)]
418    pub ingest_path: Annotated<Array<RelayInfo>>,
419
420    /// Errors encountered during processing. Intended to be phased out in favor of
421    /// annotation/metadata system.
422    #[metastructure(skip_serialization = "empty_deep")]
423    pub errors: Annotated<Array<EventProcessingError>>,
424
425    /// Project key which sent this event.
426    #[metastructure(omit_from_schema)] // not part of external schema
427    pub key_id: Annotated<String>,
428
429    /// Project which sent this event.
430    #[metastructure(omit_from_schema)] // not part of external schema
431    pub project: Annotated<u64>,
432
433    /// The grouping configuration for this event.
434    #[metastructure(omit_from_schema)] // not part of external schema
435    pub grouping_config: Annotated<Object<Value>>,
436
437    /// Legacy checksum used for grouping before fingerprint hashes.
438    #[metastructure(max_chars = 128)]
439    #[metastructure(omit_from_schema)] // deprecated
440    pub checksum: Annotated<String>,
441
442    /// CSP (security) reports.
443    #[metastructure(legacy_alias = "sentry.interfaces.Csp")]
444    #[metastructure(omit_from_schema)] // we only document error events for now
445    pub csp: Annotated<Csp>,
446
447    /// Spans for tracing.
448    #[metastructure(max_bytes = 819200)]
449    #[metastructure(omit_from_schema)] // we only document error events for now
450    pub spans: Annotated<Array<Span>>,
451
452    /// Measurements which holds observed values such as web vitals.
453    ///
454    /// Measurements are only available on transactions. They contain measurement values of observed
455    /// values such as Largest Contentful Paint (LCP).
456    #[metastructure(skip_serialization = "empty")]
457    #[metastructure(omit_from_schema)] // we only document error events for now
458    pub measurements: Annotated<Measurements>,
459
460    /// Breakdowns which holds product-defined values such as span operation breakdowns.
461    #[metastructure(skip_serialization = "empty")]
462    #[metastructure(omit_from_schema)] // we only document error events for now
463    pub breakdowns: Annotated<Breakdowns>,
464
465    /// Information about attempts to scrape a JS source or sourcemap file from the web.
466    /// This field is populated by sentry.
467    #[metastructure(omit_from_schema)] // not part of external schema
468    pub scraping_attempts: Annotated<Value>,
469
470    /// Internal ingestion and processing metrics.
471    ///
472    /// This value should not be ingested and will be overwritten by the store normalizer.
473    #[metastructure(omit_from_schema)]
474    pub _metrics: Annotated<Metrics>,
475
476    /// Value of the `DynamicSamplingContext` for this event.
477    #[metastructure(omit_from_schema)]
478    pub _dsc: Annotated<Value>,
479
480    /// Temporary flag that controls where performance issues are detected.
481    ///
482    /// When the flag is set to true, this transaction event will be skipped for performance issue
483    /// detection in favor of the spans pipeline.
484    #[metastructure(
485        field = "_performance_issues_spans",
486        skip_serialization = "empty",
487        trim = false
488    )]
489    pub performance_issues_spans: Annotated<bool>,
490
491    /// Additional arbitrary fields for forwards compatibility.
492    #[metastructure(additional_properties, pii = "true")]
493    pub other: Object<Value>,
494}
495
496impl Event {
497    /// Returns the value of a tag with the given key.
498    ///
499    /// If tags are specified in a pair list and the tag is declared multiple times, this function
500    /// returns the first match.
501    pub fn tag_value(&self, tag_key: &str) -> Option<&str> {
502        if let Some(tags) = self.tags.value() {
503            tags.get(tag_key)
504        } else {
505            None
506        }
507    }
508
509    /// Returns `true` if [`modules`](Self::modules) contains the given module.
510    pub fn has_module(&self, module_name: &str) -> bool {
511        self.modules
512            .value()
513            .map(|m| m.contains_key(module_name))
514            .unwrap_or(false)
515    }
516
517    /// Returns the identifier of the client SDK if available.
518    ///
519    /// Sentry's own SDKs use a naming schema prefixed with `sentry.`. Defaults to `"unknown"`.
520    pub fn sdk_name(&self) -> &str {
521        if let Some(client_sdk) = self.client_sdk.value()
522            && let Some(name) = client_sdk.name.as_str()
523        {
524            return name;
525        }
526
527        "unknown"
528    }
529
530    /// Returns the version of the client SDK if available.
531    ///
532    /// Defaults to `"unknown"`.
533    pub fn sdk_version(&self) -> &str {
534        if let Some(client_sdk) = self.client_sdk.value()
535            && let Some(version) = client_sdk.version.as_str()
536        {
537            return version;
538        }
539
540        "unknown"
541    }
542
543    /// Returns the raw user agent string.
544    ///
545    /// Returns `Some` if the event's request interface contains a `user-agent` header. Returns
546    /// `None` otherwise.
547    pub fn user_agent(&self) -> Option<&str> {
548        let headers = self.request.value()?.headers.value()?;
549
550        for item in headers.iter() {
551            if let Some((o_k, v)) = item.value()
552                && let Some(k) = o_k.as_str()
553                && k.eq_ignore_ascii_case("user-agent")
554            {
555                return v.as_str();
556            }
557        }
558
559        None
560    }
561
562    /// Returns extra data at the specified path.
563    ///
564    /// The path is evaluated recursively where each path component is joined by a period (`"."`).
565    /// Periods in extra keys are not supported.
566    pub fn extra_at(&self, path: &str) -> Option<&Value> {
567        let mut path = path.split('.');
568
569        // Get the top-level item explicitly, since those have a different type
570        let mut value = &self.extra.value()?.get(path.next()?)?.value()?.0;
571
572        // Iterate recursively to fetch nested values
573        for key in path {
574            if let Value::Object(object) = value {
575                value = object.get(key)?.value()?;
576            } else {
577                return None;
578            }
579        }
580
581        Some(value)
582    }
583
584    /// Returns parsed components of the Release string in [`Self::release`].
585    pub fn parse_release(&self) -> Option<ParsedRelease<'_>> {
586        sentry_release_parser::Release::parse(self.release.as_str()?).ok()
587    }
588
589    /// Returns the numeric measurement value.
590    ///
591    /// The name is provided without a prefix, for example `"lcp"` loads `event.measurements.lcp`.
592    pub fn measurement(&self, name: &str) -> Option<FiniteF64> {
593        let annotated = self.measurements.value()?.get(name)?;
594        Some(*annotated.value()?.value.value()?)
595    }
596
597    /// Returns the numeric breakdown value.
598    pub fn breakdown(&self, breakdown: &str, measurement: &str) -> Option<FiniteF64> {
599        let breakdown = self.breakdowns.value()?.get(breakdown)?.value()?;
600        Some(*breakdown.get(measurement)?.value()?.value.value()?)
601    }
602
603    /// Returns a reference to the context if it exists in its default key.
604    pub fn context<C: DefaultContext>(&self) -> Option<&C> {
605        self.contexts.value()?.get()
606    }
607
608    /// Returns a mutable reference to the context if it exists in its default key.
609    pub fn context_mut<C: DefaultContext>(&mut self) -> Option<&mut C> {
610        self.contexts.value_mut().as_mut()?.get_mut()
611    }
612}
613
614fn or_none(string: &Annotated<impl AsRef<str>>) -> Option<&str> {
615    match string.as_str() {
616        None | Some("") => None,
617        Some(other) => Some(other),
618    }
619}
620
621impl Getter for Event {
622    fn get_value(&self, path: &str) -> Option<Val<'_>> {
623        Some(match path.strip_prefix("event.")? {
624            // Simple fields
625            "level" => self.level.value()?.name().into(),
626            "release" => self.release.as_str()?.into(),
627            "dist" => self.dist.as_str()?.into(),
628            "environment" => self.environment.as_str()?.into(),
629            "transaction" => self.transaction.as_str()?.into(),
630            "logger" => self.logger.as_str()?.into(),
631            "platform" => self.platform.as_str().unwrap_or("other").into(),
632
633            // Fields in top level structures (called "interfaces" in Sentry)
634            "logentry.formatted" => self.logentry.value()?.formatted.value()?.as_ref().into(),
635            "logentry.message" => self.logentry.value()?.message.value()?.as_ref().into(),
636            "user.email" => or_none(&self.user.value()?.email)?.into(),
637            "user.id" => or_none(&self.user.value()?.id)?.into(),
638            "user.ip_address" => self.user.value()?.ip_address.as_str()?.into(),
639            "user.name" => self.user.value()?.name.as_str()?.into(),
640            "user.segment" => or_none(&self.user.value()?.segment)?.into(),
641            "user.geo.city" => self.user.value()?.geo.value()?.city.as_str()?.into(),
642            "user.geo.country_code" => self
643                .user
644                .value()?
645                .geo
646                .value()?
647                .country_code
648                .as_str()?
649                .into(),
650            "user.geo.region" => self.user.value()?.geo.value()?.region.as_str()?.into(),
651            "user.geo.subdivision" => self.user.value()?.geo.value()?.subdivision.as_str()?.into(),
652            "request.method" => self.request.value()?.method.as_str()?.into(),
653            "request.url" => self.request.value()?.url.as_str()?.into(),
654            "transaction.source" => self
655                .transaction_info
656                .value()?
657                .source
658                .value()?
659                .as_str()
660                .into(),
661            "sdk.name" => self.client_sdk.value()?.name.as_str()?.into(),
662            "sdk.version" => self.client_sdk.value()?.version.as_str()?.into(),
663
664            // Computed fields (after normalization).
665            "sentry_user" => self.user.value()?.sentry_user.as_str()?.into(),
666
667            // Partial implementation of contexts.
668            "contexts.app.in_foreground" => {
669                self.context::<AppContext>()?.in_foreground.value()?.into()
670            }
671            "contexts.app.device_app_hash" => self
672                .context::<AppContext>()?
673                .device_app_hash
674                .as_str()?
675                .into(),
676            "contexts.device.arch" => self.context::<DeviceContext>()?.arch.as_str()?.into(),
677            "contexts.device.battery_level" => self
678                .context::<DeviceContext>()?
679                .battery_level
680                .value()?
681                .into(),
682            "contexts.device.brand" => self.context::<DeviceContext>()?.brand.as_str()?.into(),
683            "contexts.device.charging" => self.context::<DeviceContext>()?.charging.value()?.into(),
684            "contexts.device.family" => self.context::<DeviceContext>()?.family.as_str()?.into(),
685            "contexts.device.model" => self.context::<DeviceContext>()?.model.as_str()?.into(),
686            "contexts.device.locale" => self.context::<DeviceContext>()?.locale.as_str()?.into(),
687            "contexts.device.online" => self.context::<DeviceContext>()?.online.value()?.into(),
688            "contexts.device.orientation" => self
689                .context::<DeviceContext>()?
690                .orientation
691                .as_str()?
692                .into(),
693            "contexts.device.name" => self.context::<DeviceContext>()?.name.as_str()?.into(),
694            "contexts.device.screen_density" => self
695                .context::<DeviceContext>()?
696                .screen_density
697                .value()?
698                .into(),
699            "contexts.device.screen_dpi" => {
700                self.context::<DeviceContext>()?.screen_dpi.value()?.into()
701            }
702            "contexts.device.screen_width_pixels" => self
703                .context::<DeviceContext>()?
704                .screen_width_pixels
705                .value()?
706                .into(),
707            "contexts.device.screen_height_pixels" => self
708                .context::<DeviceContext>()?
709                .screen_height_pixels
710                .value()?
711                .into(),
712            "contexts.device.simulator" => {
713                self.context::<DeviceContext>()?.simulator.value()?.into()
714            }
715            "contexts.gpu.vendor_name" => {
716                self.context::<GpuContext>()?.vendor_name.as_str()?.into()
717            }
718            "contexts.gpu.name" => self.context::<GpuContext>()?.name.as_str()?.into(),
719            "contexts.monitor.id" => self.context::<MonitorContext>()?.get("id")?.value()?.into(),
720            "contexts.monitor.slug" => self
721                .context::<MonitorContext>()?
722                .get("slug")?
723                .value()?
724                .into(),
725            "contexts.os" => self.context::<OsContext>()?.os.as_str()?.into(),
726            "contexts.os.build" => self.context::<OsContext>()?.build.as_str()?.into(),
727            "contexts.os.kernel_version" => {
728                self.context::<OsContext>()?.kernel_version.as_str()?.into()
729            }
730            "contexts.os.name" => self.context::<OsContext>()?.name.as_str()?.into(),
731            "contexts.os.version" => self.context::<OsContext>()?.version.as_str()?.into(),
732            "contexts.os.rooted" => self.context::<OsContext>()?.rooted.value()?.into(),
733            "contexts.browser" => self.context::<BrowserContext>()?.browser.as_str()?.into(),
734            "contexts.browser.name" => self.context::<BrowserContext>()?.name.as_str()?.into(),
735            "contexts.browser.version" => {
736                self.context::<BrowserContext>()?.version.as_str()?.into()
737            }
738            "contexts.profile.profile_id" => {
739                (&self.context::<ProfileContext>()?.profile_id.value()?.0).into()
740            }
741            "contexts.device.uuid" => self.context::<DeviceContext>()?.uuid.value()?.into(),
742            "contexts.trace.status" => self
743                .context::<TraceContext>()?
744                .status
745                .value()?
746                .as_str()
747                .into(),
748            "contexts.trace.op" => self.context::<TraceContext>()?.op.as_str()?.into(),
749            "contexts.response.status_code" => self
750                .context::<ResponseContext>()?
751                .status_code
752                .value()?
753                .into(),
754            "contexts.unreal.crash_type" => match self.contexts.value()?.get_key("unreal")? {
755                super::Context::Other(context) => context.get("crash_type")?.value()?.into(),
756                _ => return None,
757            },
758            "contexts.runtime" => self.context::<RuntimeContext>()?.runtime.as_str()?.into(),
759            "contexts.runtime.name" => self.context::<RuntimeContext>()?.name.as_str()?.into(),
760
761            // Computed fields (see Discover)
762            "duration" => {
763                let start = self.start_timestamp.value()?;
764                let end = self.timestamp.value()?;
765                if start <= end && self.ty.value() == Some(&EventType::Transaction) {
766                    time::chrono_to_positive_millis(*end - *start).into()
767                } else {
768                    return None;
769                }
770            }
771
772            // Dynamic access to certain data bags
773            path => {
774                if let Some(rest) = path.strip_prefix("release.") {
775                    let release = self.parse_release()?;
776                    match rest {
777                        "build" => release.build_hash()?.into(),
778                        "package" => release.package()?.into(),
779                        "version.short" => release.version()?.raw_short().into(),
780                        _ => return None,
781                    }
782                } else if let Some(rest) = path.strip_prefix("measurements.") {
783                    let name = rest.strip_suffix(".value")?;
784                    self.measurement(name)?.into()
785                } else if let Some(rest) = path.strip_prefix("breakdowns.") {
786                    let (breakdown, measurement) = rest.split_once('.')?;
787                    self.breakdown(breakdown, measurement)?.into()
788                } else if let Some(rest) = path.strip_prefix("extra.") {
789                    self.extra_at(rest)?.into()
790                } else if let Some(rest) = path.strip_prefix("tags.") {
791                    self.tags.value()?.get(rest)?.into()
792                } else {
793                    let rest = path.strip_prefix("request.headers.")?;
794                    self.request
795                        .value()?
796                        .headers
797                        .value()?
798                        .get_header(rest)?
799                        .into()
800                }
801            }
802        })
803    }
804
805    fn get_iter(&self, path: &str) -> Option<GetterIter<'_>> {
806        Some(match path.strip_prefix("event.")? {
807            "exception.values" => {
808                GetterIter::new_annotated(self.exceptions.value()?.values.value()?)
809            }
810            _ => return None,
811        })
812    }
813}
814
815#[cfg(test)]
816mod tests {
817    use chrono::{TimeZone, Utc};
818    use relay_protocol::{ErrorKind, HexId, Map, Meta};
819    use similar_asserts::assert_eq;
820    use std::collections::BTreeMap;
821    use uuid::uuid;
822
823    use super::*;
824    use crate::protocol::{
825        Headers, IpAddr, JsonLenientString, PairList, TagEntry, TransactionSource,
826    };
827
828    #[test]
829    fn test_event_roundtrip() {
830        // NOTE: Interfaces will be tested separately.
831        let json = r#"{
832  "event_id": "52df9022835246eeb317dbd739ccd059",
833  "level": "debug",
834  "fingerprint": [
835    "myprint"
836  ],
837  "culprit": "myculprit",
838  "transaction": "mytransaction",
839  "logentry": {
840    "formatted": "mymessage"
841  },
842  "logger": "mylogger",
843  "modules": {
844    "mymodule": "1.0.0"
845  },
846  "platform": "myplatform",
847  "timestamp": 946684800.0,
848  "server_name": "myhost",
849  "release": "myrelease",
850  "dist": "mydist",
851  "environment": "myenv",
852  "tags": [
853    [
854      "tag",
855      "value"
856    ]
857  ],
858  "extra": {
859    "extra": "value"
860  },
861  "other": "value",
862  "_meta": {
863    "event_id": {
864      "": {
865        "err": [
866          "invalid_data"
867        ]
868      }
869    }
870  }
871}"#;
872
873        let event = Annotated::new(Event {
874            id: Annotated(
875                Some("52df9022-8352-46ee-b317-dbd739ccd059".parse().unwrap()),
876                Meta::from_error(ErrorKind::InvalidData),
877            ),
878            level: Annotated::new(Level::Debug),
879            fingerprint: Annotated::new(vec!["myprint".to_owned()].into()),
880            culprit: Annotated::new("myculprit".to_owned()),
881            transaction: Annotated::new("mytransaction".to_owned()),
882            logentry: Annotated::new(LogEntry {
883                formatted: Annotated::new("mymessage".to_owned().into()),
884                ..Default::default()
885            }),
886            logger: Annotated::new("mylogger".to_owned()),
887            modules: {
888                let mut map = Map::new();
889                map.insert("mymodule".to_owned(), Annotated::new("1.0.0".to_owned()));
890                Annotated::new(map)
891            },
892            platform: Annotated::new("myplatform".to_owned()),
893            timestamp: Annotated::new(Utc.with_ymd_and_hms(2000, 1, 1, 0, 0, 0).unwrap().into()),
894            server_name: Annotated::new("myhost".to_owned()),
895            release: Annotated::new("myrelease".to_owned().into()),
896            dist: Annotated::new("mydist".to_owned()),
897            environment: Annotated::new("myenv".to_owned()),
898            tags: {
899                let items = vec![Annotated::new(TagEntry(
900                    Annotated::new("tag".to_owned()),
901                    Annotated::new("value".to_owned()),
902                ))];
903                Annotated::new(Tags(items.into()))
904            },
905            extra: {
906                let mut map = Map::new();
907                map.insert(
908                    "extra".to_owned(),
909                    Annotated::new(ExtraValue(Value::String("value".to_owned()))),
910                );
911                Annotated::new(map)
912            },
913            other: {
914                let mut map = Map::new();
915                map.insert(
916                    "other".to_owned(),
917                    Annotated::new(Value::String("value".to_owned())),
918                );
919                map
920            },
921            ..Default::default()
922        });
923
924        assert_eq!(event, Annotated::from_json(json).unwrap());
925        assert_eq!(json, event.to_json_pretty().unwrap());
926    }
927
928    #[test]
929    fn test_event_default_values() {
930        let json = "{}";
931        let event = Annotated::new(Event::default());
932
933        assert_eq!(event, Annotated::from_json(json).unwrap());
934        assert_eq!(json, event.to_json_pretty().unwrap());
935    }
936
937    #[test]
938    fn test_event_default_values_with_meta() {
939        let json = r#"{
940  "event_id": "52df9022835246eeb317dbd739ccd059",
941  "fingerprint": [
942    "{{ default }}"
943  ],
944  "platform": "other",
945  "_meta": {
946    "event_id": {
947      "": {
948        "err": [
949          "invalid_data"
950        ]
951      }
952    },
953    "fingerprint": {
954      "": {
955        "err": [
956          "invalid_data"
957        ]
958      }
959    },
960    "platform": {
961      "": {
962        "err": [
963          "invalid_data"
964        ]
965      }
966    }
967  }
968}"#;
969
970        let event = Annotated::new(Event {
971            id: Annotated(
972                Some("52df9022-8352-46ee-b317-dbd739ccd059".parse().unwrap()),
973                Meta::from_error(ErrorKind::InvalidData),
974            ),
975            fingerprint: Annotated(
976                Some(vec!["{{ default }}".to_owned()].into()),
977                Meta::from_error(ErrorKind::InvalidData),
978            ),
979            platform: Annotated(
980                Some("other".to_owned()),
981                Meta::from_error(ErrorKind::InvalidData),
982            ),
983            ..Default::default()
984        });
985
986        assert_eq!(event, Annotated::<Event>::from_json(json).unwrap());
987        assert_eq!(json, event.to_json_pretty().unwrap());
988    }
989
990    #[test]
991    fn test_event_type() {
992        assert_eq!(
993            EventType::Default,
994            *Annotated::<EventType>::from_json("\"default\"")
995                .unwrap()
996                .value()
997                .unwrap()
998        );
999    }
1000
1001    #[test]
1002    fn test_fingerprint_empty_string() {
1003        let json = r#"{"fingerprint":[""]}"#;
1004        let event = Annotated::new(Event {
1005            fingerprint: Annotated::new(vec!["".to_owned()].into()),
1006            ..Default::default()
1007        });
1008
1009        assert_eq!(json, event.to_json().unwrap());
1010        assert_eq!(event, Annotated::from_json(json).unwrap());
1011    }
1012
1013    #[test]
1014    fn test_fingerprint_null_values() {
1015        let input = r#"{"fingerprint":[null]}"#;
1016        let output = r#"{}"#;
1017        let event = Annotated::new(Event {
1018            fingerprint: Annotated::new(vec![].into()),
1019            ..Default::default()
1020        });
1021
1022        assert_eq!(event, Annotated::from_json(input).unwrap());
1023        assert_eq!(output, event.to_json().unwrap());
1024    }
1025
1026    #[test]
1027    fn test_empty_threads() {
1028        let input = r#"{"threads": {}}"#;
1029        let output = r#"{}"#;
1030
1031        let event = Annotated::new(Event::default());
1032
1033        assert_eq!(event, Annotated::from_json(input).unwrap());
1034        assert_eq!(output, event.to_json().unwrap());
1035    }
1036
1037    #[test]
1038    fn test_lenient_release() {
1039        let input = r#"{"release":42}"#;
1040        let output = r#"{"release":"42"}"#;
1041        let event = Annotated::new(Event {
1042            release: Annotated::new("42".to_owned().into()),
1043            ..Default::default()
1044        });
1045
1046        assert_eq!(event, Annotated::from_json(input).unwrap());
1047        assert_eq!(output, event.to_json().unwrap());
1048    }
1049
1050    #[test]
1051    fn test_extra_at() {
1052        let json = serde_json::json!({
1053            "extra": {
1054                "a": "string1",
1055                "b": 42,
1056                "c": {
1057                    "d": "string2",
1058                    "e": null,
1059                },
1060            },
1061        });
1062
1063        let event = Event::from_value(json.into());
1064        let event = event.value().unwrap();
1065
1066        assert_eq!(
1067            Some(&Value::String("string1".to_owned())),
1068            event.extra_at("a")
1069        );
1070        assert_eq!(Some(&Value::I64(42)), event.extra_at("b"));
1071        assert!(matches!(event.extra_at("c"), Some(&Value::Object(_))));
1072        assert_eq!(None, event.extra_at("d"));
1073        assert_eq!(
1074            Some(&Value::String("string2".to_owned())),
1075            event.extra_at("c.d")
1076        );
1077        assert_eq!(None, event.extra_at("c.e"));
1078        assert_eq!(None, event.extra_at("c.f"));
1079    }
1080
1081    #[test]
1082    fn test_scrape_attempts() {
1083        let json = serde_json::json!({
1084            "scraping_attempts": [
1085                {"status": "not_attempted", "url": "http://example.com/embedded.js"},
1086                {"status": "not_attempted", "url": "http://example.com/embedded.js.map"},
1087            ]
1088        });
1089
1090        let event = Event::from_value(json.into());
1091        assert!(!event.value().unwrap().scraping_attempts.meta().has_errors());
1092    }
1093
1094    #[test]
1095    fn test_field_value_provider_event_filled() {
1096        let event = Event {
1097            level: Annotated::new(Level::Info),
1098            release: Annotated::new(LenientString("1.1.1".to_owned())),
1099            environment: Annotated::new("prod".to_owned()),
1100            user: Annotated::new(User {
1101                ip_address: Annotated::new(IpAddr("127.0.0.1".to_owned())),
1102                id: Annotated::new(LenientString("user-id".into())),
1103                segment: Annotated::new("user-seg".into()),
1104                sentry_user: Annotated::new("id:user-id".into()),
1105                ..Default::default()
1106            }),
1107            client_sdk: Annotated::new(ClientSdkInfo {
1108                name: Annotated::new("sentry-javascript".into()),
1109                version: Annotated::new("1.87.0".into()),
1110                ..Default::default()
1111            }),
1112            exceptions: Annotated::new(Values {
1113                values: Annotated::new(vec![Annotated::new(Exception {
1114                    value: Annotated::new(JsonLenientString::from(
1115                        "canvas.contentDocument".to_owned(),
1116                    )),
1117                    ..Default::default()
1118                })]),
1119                ..Default::default()
1120            }),
1121            logentry: Annotated::new(LogEntry {
1122                formatted: Annotated::new("formatted".to_owned().into()),
1123                message: Annotated::new("message".to_owned().into()),
1124                ..Default::default()
1125            }),
1126            request: Annotated::new(Request {
1127                headers: Annotated::new(Headers(PairList(vec![Annotated::new((
1128                    Annotated::new("user-agent".into()),
1129                    Annotated::new("Slurp".into()),
1130                ))]))),
1131                url: Annotated::new("https://sentry.io".into()),
1132                ..Default::default()
1133            }),
1134            transaction: Annotated::new("some-transaction".into()),
1135            transaction_info: Annotated::new(TransactionInfo {
1136                source: Annotated::new(TransactionSource::Route),
1137                ..Default::default()
1138            }),
1139            tags: {
1140                let items = vec![Annotated::new(TagEntry(
1141                    Annotated::new("custom".to_owned()),
1142                    Annotated::new("custom-value".to_owned()),
1143                ))];
1144                Annotated::new(Tags(items.into()))
1145            },
1146            contexts: Annotated::new({
1147                let mut contexts = Contexts::new();
1148                contexts.add(DeviceContext {
1149                    name: Annotated::new("iphone".to_owned()),
1150                    family: Annotated::new("iphone-fam".to_owned()),
1151                    model: Annotated::new("iphone7,3".to_owned()),
1152                    screen_dpi: Annotated::new(560),
1153                    screen_width_pixels: Annotated::new(1920),
1154                    screen_height_pixels: Annotated::new(1080),
1155                    locale: Annotated::new("US".into()),
1156                    uuid: Annotated::new(uuid!("abadcade-feed-dead-beef-baddadfeeded")),
1157                    charging: Annotated::new(true),
1158                    ..DeviceContext::default()
1159                });
1160                contexts.add(OsContext {
1161                    name: Annotated::new("iOS".to_owned()),
1162                    version: Annotated::new("11.4.2".to_owned()),
1163                    kernel_version: Annotated::new("17.4.0".to_owned()),
1164                    ..OsContext::default()
1165                });
1166                contexts.add(ProfileContext {
1167                    profile_id: Annotated::new(EventId(uuid!(
1168                        "abadcade-feed-dead-beef-8addadfeedaa"
1169                    ))),
1170                    ..ProfileContext::default()
1171                });
1172                let mut monitor_context_fields = BTreeMap::new();
1173                monitor_context_fields.insert(
1174                    "id".to_owned(),
1175                    Annotated::new(Value::String("123".to_owned())),
1176                );
1177                monitor_context_fields.insert(
1178                    "slug".to_owned(),
1179                    Annotated::new(Value::String("my_monitor".to_owned())),
1180                );
1181                contexts.add(MonitorContext(monitor_context_fields));
1182                contexts
1183            }),
1184            ..Default::default()
1185        };
1186
1187        assert_eq!(Some(Val::String("info")), event.get_value("event.level"));
1188
1189        assert_eq!(Some(Val::String("1.1.1")), event.get_value("event.release"));
1190        assert_eq!(
1191            Some(Val::String("prod")),
1192            event.get_value("event.environment")
1193        );
1194        assert_eq!(
1195            Some(Val::String("user-id")),
1196            event.get_value("event.user.id")
1197        );
1198        assert_eq!(
1199            Some(Val::String("id:user-id")),
1200            event.get_value("event.sentry_user")
1201        );
1202        assert_eq!(
1203            Some(Val::String("user-seg")),
1204            event.get_value("event.user.segment")
1205        );
1206        assert_eq!(
1207            Some(Val::String("some-transaction")),
1208            event.get_value("event.transaction")
1209        );
1210        assert_eq!(
1211            Some(Val::String("iphone")),
1212            event.get_value("event.contexts.device.name")
1213        );
1214        assert_eq!(
1215            Some(Val::String("iphone-fam")),
1216            event.get_value("event.contexts.device.family")
1217        );
1218        assert_eq!(
1219            Some(Val::String("iOS")),
1220            event.get_value("event.contexts.os.name")
1221        );
1222        assert_eq!(
1223            Some(Val::String("11.4.2")),
1224            event.get_value("event.contexts.os.version")
1225        );
1226        assert_eq!(
1227            Some(Val::String("custom-value")),
1228            event.get_value("event.tags.custom")
1229        );
1230        assert_eq!(None, event.get_value("event.tags.doesntexist"));
1231        assert_eq!(
1232            Some(Val::String("sentry-javascript")),
1233            event.get_value("event.sdk.name")
1234        );
1235        assert_eq!(
1236            Some(Val::String("1.87.0")),
1237            event.get_value("event.sdk.version")
1238        );
1239        assert_eq!(
1240            Some(Val::String("17.4.0")),
1241            event.get_value("event.contexts.os.kernel_version")
1242        );
1243        assert_eq!(
1244            Some(Val::I64(560)),
1245            event.get_value("event.contexts.device.screen_dpi")
1246        );
1247        assert_eq!(
1248            Some(Val::Bool(true)),
1249            event.get_value("event.contexts.device.charging")
1250        );
1251        assert_eq!(
1252            Some(Val::U64(1920)),
1253            event.get_value("event.contexts.device.screen_width_pixels")
1254        );
1255        assert_eq!(
1256            Some(Val::U64(1080)),
1257            event.get_value("event.contexts.device.screen_height_pixels")
1258        );
1259        assert_eq!(
1260            Some(Val::String("US")),
1261            event.get_value("event.contexts.device.locale")
1262        );
1263        assert_eq!(
1264            Some(Val::HexId(HexId(
1265                uuid!("abadcade-feed-dead-beef-baddadfeeded").as_bytes()
1266            ))),
1267            event.get_value("event.contexts.device.uuid")
1268        );
1269        assert_eq!(
1270            Some(Val::String("https://sentry.io")),
1271            event.get_value("event.request.url")
1272        );
1273        assert_eq!(
1274            Some(Val::HexId(HexId(
1275                uuid!("abadcade-feed-dead-beef-8addadfeedaa").as_bytes()
1276            ))),
1277            event.get_value("event.contexts.profile.profile_id")
1278        );
1279        assert_eq!(
1280            Some(Val::String("route")),
1281            event.get_value("event.transaction.source")
1282        );
1283
1284        let mut exceptions = event.get_iter("event.exception.values").unwrap();
1285        let exception = exceptions.next().unwrap();
1286        assert_eq!(
1287            Some(Val::String("canvas.contentDocument")),
1288            exception.get_value("value")
1289        );
1290        assert!(exceptions.next().is_none());
1291
1292        assert_eq!(
1293            Some(Val::String("formatted")),
1294            event.get_value("event.logentry.formatted")
1295        );
1296        assert_eq!(
1297            Some(Val::String("message")),
1298            event.get_value("event.logentry.message")
1299        );
1300        assert_eq!(
1301            Some(Val::String("123")),
1302            event.get_value("event.contexts.monitor.id")
1303        );
1304        assert_eq!(
1305            Some(Val::String("my_monitor")),
1306            event.get_value("event.contexts.monitor.slug")
1307        );
1308    }
1309
1310    #[test]
1311    fn test_field_value_provider_event_empty() {
1312        let event = Event::default();
1313
1314        assert_eq!(None, event.get_value("event.release"));
1315        assert_eq!(None, event.get_value("event.environment"));
1316        assert_eq!(None, event.get_value("event.user.id"));
1317        assert_eq!(None, event.get_value("event.user.segment"));
1318
1319        // now try with an empty user
1320        let event = Event {
1321            user: Annotated::new(User {
1322                ..Default::default()
1323            }),
1324            ..Default::default()
1325        };
1326
1327        assert_eq!(None, event.get_value("event.user.id"));
1328        assert_eq!(None, event.get_value("event.user.segment"));
1329        assert_eq!(None, event.get_value("event.transaction"));
1330    }
1331}
relay_event_schema/protocol/event.rs

relay_event_schema/protocol/
event.rs
