0.46.1

Improvements

• Make it possible to == Transaction/Span/TransactionOrSpan (#942)

Dependencies

• Update reqwest from 0.12.15 to 0.12.25 (#951)

0.46.0

Breaking changes

• Removed the ClientOptions struct's trim_backtraces and extra_border_frames fields (#925).
  • These fields configured backtrace trimming, which is being removed in this release.

Improvements

• Removed backtrace trimming to align the Rust SDK with the general principle that Sentry SDKs should only truncate telemetry data when needed to comply with documented size limits (#925). This change ensures that as much data as possible remains available for debugging.
  • If you notice any new issues being created for existing errors after this change, please open an issue on GitHub.

Fixes

• fix: adjust sentry.origin for log integration (#919) by @lcian

0.45.0

Breaking changes

• Add custom variant to AttachmentType that holds an arbitrary String. (#916)

0.44.0

Breaking changes

• feat(log): support combined LogFilters and RecordMappings (#914) by @lcian
  • Breaking change: sentry::integrations::log::LogFilter has been changed to a bitflags struct.
  • It's now possible to map a log record to multiple items in Sentry by combining multiple log filters in the filter, e.g. log::Level::ERROR => LogFilter::Event | LogFilter::Log.
  • If using a custom mapper instead, it's possible to return a Vec<sentry::integrations::log::RecordMapping> to map a log record to multiple items in Sentry.

Behavioral changes

• ref(log): send logs by default when logs feature flag is enabled (#915) by @lcian
  • If the logs feature flag is enabled, the default Sentry log logger now sends logs for all events at or above INFO.
• ref(logs): enable logs by default if logs feature flag is used (#910) by @lcian
  • This changes the default value of sentry::ClientOptions::enable_logs to true.
  • This simplifies the setup of Sentry structured logs by requiring users to just add the log feature flag to the sentry dependency to opt-in to sending logs.
  • When the log feature flag is enabled, the tracing and log integrations will send structured logs to Sentry for all logs/events at or above INFO level by default.

0.43.0

Breaking changes

• ref(tracing): rework tracing to Sentry span name/op conversion (#887) by @lcian
  • The tracing integration now uses the tracing span name as the Sentry span name by default.
  • Before this change, the span name would be set based on the tracing span target (<module>::<function> when using the tracing::instrument macro).
  • The tracing integration now uses <span target>::<span name> as the default Sentry span op (i.e. <module>::<function> when using tracing::instrument).
  • Before this change, the span op would be set based on the tracing span name.
  • Read below to learn how to customize the span name and op.
  • When upgrading, please ensure to adapt any queries, metrics or dashboards to use the new span names/ops.
• ref(tracing): use standard code attributes (#899) by @lcian
  • Logs now carry the attributes code.module.name, code.file.path and code.line.number standardized in OTEL to surface the respective information, in contrast with the previously sent tracing.module_path, tracing.file and tracing.line.
• fix(actix): capture only server errors (#877) by @lcian
  • The Actix integration now properly honors the capture_server_errors option (enabled by default), capturing errors returned by middleware only if they are server errors (HTTP status code 5xx).
  • Previously, if a middleware were to process the request after the Sentry middleware and return an error, our middleware would always capture it and send it to Sentry, regardless if it was a client, server or some other kind of error.
  • With this change, we capture errors returned by middleware only if those errors can be classified as server errors.
  • There is no change in behavior when it comes to errors returned by services, in which case the Sentry middleware only captures server errors exclusively.
• fix: send trace origin correctly (#906) by @lcian
  • TraceContext now has an additional field origin, used to report which integration created a transaction.

Behavioral changes

• feat(tracing): send both breadcrumbs and logs by default (#878) by @lcian
  • If the logs feature flag is enabled, and enable_logs: true is set on your client options, the default Sentry tracing layer now sends logs for all events at or above INFO.

Features

• ref(tracing): rework tracing to Sentry span name/op conversion (#887) by @lcian

  • Additional special fields have been added that allow overriding certain data on the Sentry span:
    • sentry.op: override the Sentry span op.
    • sentry.name: override the Sentry span name.
    • sentry.trace: given a string matching a valid sentry-trace header (sent automatically by client SDKs), continues the distributed trace instead of starting a new one. If the value is not a valid sentry-trace header or a trace is already started, this value is ignored.
  • sentry.op and sentry.name can also be applied retroactively by declaring fields with value tracing::field::Empty and then recorded using tracing::Span::record.
  • Example usage:

    #[tracing::instrument(skip_all, fields(
        sentry.op = "http.server",
        sentry.name = "GET /payments",
        sentry.trace = headers.get("sentry-trace").unwrap_or(&"".to_owned()),
    ))]
    async fn handle_request(headers: std::collections::HashMap<String, String>) {
        // ...
    }

  • Additional attributes are sent along with each span by default:
    • sentry.tracing.target: corresponds to the tracing span's metadata.target()
    • code.module.name, code.file.path, code.line.number

• feat(core): add Response context (#874) by @lcian

  • The Response context can now be attached to events, to include information about HTTP responses such as headers, cookies and status code.
  • Example:

    let mut event = Event::new();
    let response = ResponseContext {
        cookies: Some(r#""csrftoken": "1234567""#.to_owned()),
        headers: Some(headers_map),
        status_code: Some(500),
        body_size: Some(15),
        data: Some("Invalid request"),
    };
    event
        .contexts
        .insert("response".to_owned(), response.into());

Fixes

• build(panic): Fix build without other dependencies (#883) by @liskin
  • The sentry-panic crate now builds successfully when used as a standalone dependency.
• fix(transport): add rate limits for logs (#894) by @giortzisg

0.42.0

Features

• feat(log): support kv feature of log (#851) by @lcian
  • Attributes added to a log record using the kv feature are now recorded as attributes on the log sent to Sentry.
• feat(types): add all the missing supported envelope headers (#867) by @lcian
• feat(types): add setters for envelope headers (#868) by @lcian
  • It's now possible to set all of the envelope headers supported by the protocol when constructing envelopes.
• feat(core): add some DSC fields to transaction envelope headers (#869) by @lcian
  • The SDK now sends additional envelope headers with transactions. This should solve some extrapolation issues for span metrics.

Behavioral changes

• feat: filter username and password in URLs (#864) by @lcian
  • Usernames and passwords that could be contained in URLs captured when using the Actix Web or axum integration are now always filtered out.
  • If the Request is created manually by the user, then these fields are not filtered out.
  • This information was already filtered by Relay, but should also be filtered by the SDK itself as a first line of defense.

Fixes

• docs: match description of debug option with behavior since PR #820 (#860) by @AlexTMjugador

0.41.0

Breaking changes

• feat(tracing): support combined EventFilters and EventMappings (#847) by @lcian
  • EventFilter has been changed to a bitflags struct.
  • It's now possible to map a tracing event to multiple items in Sentry by combining multiple event filters in the event_filter, e.g. tracing::Level::ERROR => EventFilter::Event | EventFilter::Log.
  • It's also possible to use EventMapping::Combined to map a tracing event to multiple items in Sentry.
  • ctx in the signatures of event_from_event, breadcrumb_from_event and log_from_event has been changed to take impl Into<Option<&'context Context<'context, S>>> to avoid cloning the Context when mapping to multiple items.

Features

• feat(core): emit debug log when calling capture_log but logs are disabled (#849) by @lcian

Fixes

• fix(logs): stringify u64 attributes greater than i64::MAX (#846) by @lcian

Dependencies

• chore(deps): bump anyhow and disable its backtrace feature (#632) by @LunaBorowska

0.40.0

Logs

We've released two new integrations for Sentry structured logs, the tracing and log integration. Read below on how to start sending logs to Sentry.

Breaking changes

• refactor(logs): apply user attributes to log regardless of send_default_pii (#843) by @lcian
  • User attributes should be applied to logs regardless of send_default_pii. Therefore, that parameter was removed from sentry_core::Scope::apply_to_log.

Features

• feat(tracing): add support for logs (#840) by @lcian
  • To capture tracing events as Sentry structured logs, enable the logs feature of the sentry crate.
  • Then, initialize the SDK with enable_logs: true in your client options.
  • Finally, set up a custom event filter to map events to logs based on criteria such as severity. For example:

      let sentry_layer = sentry_tracing::layer().event_filter(|md| match *md.level() {
          tracing::Level::ERROR => EventFilter::Event,
          tracing::Level::TRACE => EventFilter::Ignore,
          _ => EventFilter::Log,
      });

• feat(log): add support for logs (#841) by @lcian
  • To capture log records as Sentry structured logs, enable the logs feature of the sentry crate.
  • Then, initialize the SDK with enable_logs: true in your client options.
  • Finally, set up a custom event filter to map records to Sentry logs based on criteria such as severity. For example:

      let logger = sentry::integrations::log::SentryLogger::new().filter(|md| match md.level() {
          log::Level::Error => LogFilter::Event,
          log::Level::Trace => LogFilter::Ignore,
          _ => LogFilter::Log,
      });

• refactor(logs): cache default attributes and add OS attributes (#842) by @lcian
  • os.name and os.version are now being attached to logs as default attributes.

Fixes

• fix(logs): send environment in sentry.environment default attribute (#837) by @lcian

Behavioral changes

• refactor(tracing): refactor internal code and improve docs (#839) by @lcian
  • Errors carried by breadcrumbs will now be stored in the breadcrumb data under their original field name.
  • Before, they were all stored under a single key called errors.

Dependencies

• chore(deps): upgrade ureq to 3.x (#835) by @algesten

0.39.0

Logs

Support for Sentry structured logs has been added to the SDK.

• To set up logs, enable the logs feature of the sentry crate and set enable_logs to true in your client options.
• Then, use the logger_trace!, logger_debug!, logger_info!, logger_warn!, logger_error! and logger_fatal! macros to capture logs.
• To filter or update logs before they are sent, you can use the before_send_log client option.
• Please note that breaking changes could occur until the API is finalized.

Features

• feat(logs): add log protocol types (#821) by @lcian
• feat(logs): add ability to capture and send logs (#823) by @lcian & @Swatinem
• feat(logs): add macro-based API (#827) by @lcian & @szokeasaurusrex
• feat(logs): send logs in batches (#831) by @lcian

Behavioral changes

• refactor(core): remove support for traceparent (#807) by @lcian
  • The SDK doesn't support parsing the traceparent distributed tracing header anymore. This means that continue_from_headers (and, as a consequence, parse_headers) will only take into account the sentry-trace header from now on.
  • If you need to continue traces based on the information in the traceparent header, please parse the information from it and then use the API to manually create the desired transaction.
• feat(core): implement Tracing without Performance (#811) by @lcian
  • The SDK now implements Tracing without Performance, which makes it so that each Scope is associated with an object holding some tracing information.
  • This information is used as a fallback when capturing an event with tracing disabled or otherwise no ongoing span, to still allow related events to be linked by a trace.
  • A new API Scope::iter_trace_propagation_headers has been provided that will use the fallback tracing information if there is no current Span on the Scope.

Breaking changes

• refactor: remove debug-logs feature (#820) by @lcian
  • The deprecated debug-logs feature of the sentry crate, used for the SDK's own internal logging, has been removed.

0.38.1

Fixes

• build: include sentry-actix optionally when release-health is enabled (#806) by @lcian
  • sentry-actix is now being included as a dependency only when explicitly added, either as a direct dependency or through the actix feature flag of the sentry crate.
  • Due to a mistake in the Cargo.toml, it was previously being included as a dependency by default when using just the sentry crate with default features.