fastlane-plugin-sentry_api 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d77dd2a4ddeeeebbae493992d767270bbb900115a8609b569da69c3fe289097f
-  data.tar.gz: 9d5cd96f9c4122c36b1046f2d35a9ea52128ec72ec3ad6b89f2d75161e7da929
+  metadata.gz: d2d7e86861535827a08cfc5f104e19fc76aa7425ce1145eb423bd2245c3ca4f4
+  data.tar.gz: fb60b07c170ecbeec59c94b79e50486764baeefac2c350b682e92fc474574bc2
 SHA512:
-  metadata.gz: 6710416b679ef754a02c988f66f8c982f8067539670214fd124acebaedd236aee4b3ddcba82fa523f1385f7f6b589bdbf3cdbccac55b8c22d3b558ef7d99b55b
-  data.tar.gz: 35cea7b42c2aecbf03b0afef2995f43e1596cc77527bb6983c390af085037f6f0aee86b239380977c1aa540c195df83b74b1d0d0696ba889097b1674096ac883
+  metadata.gz: 7b5dce5c216e5a457fe1422aef19ed565706df708157f75fda3159a702076001051496a0aafee13966f5113d8d07c6093369d7703d0a5b959b05e7e7f87df4dd
+  data.tar.gz: c6bf3a529b30953e46a1728e73d35fb0e7462a519f0fe527fd208b391098c8bc0f68bae736a8e914e4d70513c85ab75017dbbc4716ef78b13321f307769e634c

data/README.md

@@ -89,7 +89,7 @@ Query crash-free session and user rates from the Sentry Sessions API. Supports a
 | `per_page` | `Integer` | No | `10` | Number of groups to return (max 100) |
 | `order_by` | `String` | No | `-sum(session)` | Sort order for grouped results |
 
-**Output (SharedValues):** `SENTRY_CRASH_FREE_SESSION_RATE`, `SENTRY_CRASH_FREE_USER_RATE`, `SENTRY_TOTAL_SESSIONS`, `SENTRY_TOTAL_USERS`, `SENTRY_SESSION_GROUPS`
+**Output (SharedValues):** `SENTRY_CRASH_FREE_SESSION_RATE`, `SENTRY_CRASH_FREE_USER_RATE`, `SENTRY_TOTAL_SESSIONS`, `SENTRY_TOTAL_USERS`, `SENTRY_SESSION_GROUPS`, `SENTRY_CRASH_FREE_SESSIONS_STATUS_CODE`, `SENTRY_CRASH_FREE_SESSIONS_JSON`
 
 **Examples:**
 
@@ -130,7 +130,7 @@ Convenience action for fetching user-centric crash-free metrics. For full sessio
 | `start_date` | `String` | No | — | ISO 8601 start date |
 | `end_date` | `String` | No | — | ISO 8601 end date |
 
-**Output (SharedValues):** `SENTRY_CRASH_FREE_USER_RATE_ONLY`, `SENTRY_TOTAL_USERS_ONLY`
+**Output (SharedValues):** `SENTRY_CRASH_FREE_USER_RATE_ONLY`, `SENTRY_TOTAL_USERS_ONLY`, `SENTRY_CRASH_FREE_USERS_STATUS_CODE`, `SENTRY_CRASH_FREE_USERS_JSON`
 
 **Example:**
 
@@ -162,8 +162,9 @@ Query TTID (Time to Initial Display) percentiles per screen from the Sentry Even
 | `per_page` | `Integer` | No | `20` | Number of screens to return (max 100) |
 | `sort` | `String` | No | `-count()` | Sort order |
 | `include_overall` | `Boolean` | No | `false` | Also fetch overall/aggregate TTID percentiles across all screens |
+| `ttid_exclude_screens` | `Array` | No | `[]` | Array of screen (transaction) names to exclude from TTID queries |
 
-**Output (SharedValues):** `SENTRY_TTID_DATA` (array of `{ transaction:, avg:, p50:, p75:, p95:, count: }`), `SENTRY_TTID_OVERALL` (hash with `{ avg:, p50:, p75:, p95:, count: }` when `include_overall` is true)
+**Output (SharedValues):** `SENTRY_TTID_DATA` (array of `{ transaction:, p50:, p75:, p95:, count: }`), `SENTRY_TTID_OVERALL` (hash with `{ p50:, p75:, p95:, count: }` when `include_overall` is true), `SENTRY_TTID_STATUS_CODE`, `SENTRY_TTID_JSON`
 
 **Examples:**
 
@@ -171,7 +172,7 @@ Query TTID (Time to Initial Display) percentiles per screen from the Sentry Even
 # Top 10 screens by load count
 screens = sentry_ttid_percentiles(stats_period: "7d", per_page: 10)
 screens.each do |s|
-  UI.message("#{s[:transaction]}: avg=#{s[:avg]}ms p50=#{s[:p50]}ms p95=#{s[:p95]}ms (#{s[:count]} loads)")
+  UI.message("#{s[:transaction]}: p50=#{s[:p50]}ms p75=#{s[:p75]}ms p95=#{s[:p95]}ms (#{s[:count]} loads)")
 end
 
 # With overall aggregate TTID
@@ -187,6 +188,13 @@ sentry_ttid_percentiles(
   start_date: "2026-02-24T00:00:00Z",
   end_date: "2026-03-03T00:00:00Z"
 )
+
+# Exclude specific screens (e.g. container or splash screens that inflate TTID)
+sentry_ttid_percentiles(
+  stats_period: "7d",
+  include_overall: true,
+  ttid_exclude_screens: ["AppContainerViewController", "SplashScreenViewController"]
+)
 ```
 
 ---
@@ -208,7 +216,7 @@ Query app launch latency (cold start & warm start) percentiles from the Sentry E
 | `end_date` | `String` | No | — | ISO 8601 end date |
 | `release` | `String` | No | — | Filter by release version |
 
-**Output (SharedValues):** `SENTRY_APP_LAUNCH_DATA` (hash with `:cold_start` and `:warm_start`, each containing `{ p50:, p75:, p95:, count: }`)
+**Output (SharedValues):** `SENTRY_APP_LAUNCH_DATA` (hash with `:cold_start` and `:warm_start`, each containing `{ p50:, p75:, p95:, count: }`), `SENTRY_APP_LAUNCH_STATUS_CODE`, `SENTRY_APP_LAUNCH_JSON`
 
 **Examples:**
 
@@ -249,7 +257,7 @@ Fetch issues from a Sentry project. Supports filtering by release version, query
 | `per_page` | `Integer` | No | `25` | Number of issues to return (max 100) |
 | `cursor` | `String` | No | — | Pagination cursor |
 
-**Output (SharedValues):** `SENTRY_ISSUES` (array of issue hashes), `SENTRY_ISSUE_COUNT`
+**Output (SharedValues):** `SENTRY_ISSUES` (array of issue hashes with `:id`, `:short_id`, `:title`, `:culprit`, `:level`, `:status`, `:event_count`, `:user_count`, `:first_seen`, `:last_seen`, `:permalink`, `:metadata`), `SENTRY_ISSUE_COUNT`, `SENTRY_ISSUES_STATUS_CODE`, `SENTRY_ISSUES_JSON`
 
 **Examples:**
 
@@ -303,6 +311,8 @@ Includes target checking with ✅/⚠️ indicators and optional JSON file outpu
 | `ttid_screen_count` | `Integer` | No | `10` | Number of top screens in TTID report |
 | `issue_count` | `Integer` | No | `10` | Number of top issues per release |
 | `crash_issue_count` | `Integer` | No | `5` | Number of top crash (unhandled error) issues to include |
+| `crash_query` | `String` | No | `is:unresolved issue.category:error error.unhandled:true` | Custom Sentry search query for top crash issues |
+| `ttid_exclude_screens` | `Array` | No | `[]` | Array of screen (transaction) names to exclude from TTID queries |
 | `output_json` | `String` | No | — | Path to write JSON report file |
 
 **Output (SharedValues):** `SENTRY_SLO_REPORT` (complete hash with `:availability`, `:latency`, `:issues`)
@@ -356,6 +366,13 @@ report = sentry_slo_report(
 )
 rate = report[:availability][:current][:crash_free_session_rate]
 UI.important("Crash-free: #{(rate * 100).round(2)}%")
+
+# Exclude specific screens from TTID metrics
+sentry_slo_report(
+  crash_free_target: 0.998,
+  ttid_exclude_screens: ["AppContainerViewController", "SplashScreenViewController"],
+  output_json: "slo_report.json"
+)
 ```
 
 ---
@@ -375,11 +392,11 @@ end
 lane :ttid_check do
   screens = sentry_ttid_percentiles(stats_period: "7d", per_page: 10, include_overall: true)
   screens.each do |s|
-    UI.message("#{s[:transaction]}: avg=#{s[:avg]}ms p50=#{s[:p50]}ms p95=#{s[:p95]}ms (#{s[:count]} loads)")
+    UI.message("#{s[:transaction]}: p50=#{s[:p50]}ms p75=#{s[:p75]}ms p95=#{s[:p95]}ms (#{s[:count]} loads)")
   end
 
   overall = lane_context[SharedValues::SENTRY_TTID_OVERALL]
-  UI.important("Overall TTID: avg=#{overall[:avg]}ms p50=#{overall[:p50]}ms p95=#{overall[:p95]}ms") if overall
+  UI.important("Overall TTID: p50=#{overall[:p50]}ms p75=#{overall[:p75]}ms p95=#{overall[:p95]}ms") if overall
 end
 
 lane :app_launch_check do

data/lib/fastlane/plugin/sentry_api/actions/sentry_slo_report_action.rb

@@ -76,14 +76,16 @@ module Fastlane
           report[:latency][:current] = fetch_ttid(
             auth_token: auth_token, org_slug: org_slug, project_id: project_id,
             environment: environment, stats_period: stats_period,
-            per_page: params[:ttid_screen_count]
+            per_page: params[:ttid_screen_count],
+            exclude_screens: params[:ttid_exclude_screens]
           )
           log_ttid("Current #{stats_period}", report[:latency][:current], params[:ttid_p95_target_ms])
 
           # Overall/aggregate TTID
           report[:latency][:overall] = fetch_ttid_overall(
             auth_token: auth_token, org_slug: org_slug, project_id: project_id,
-            environment: environment, stats_period: stats_period
+            environment: environment, stats_period: stats_period,
+            exclude_screens: params[:ttid_exclude_screens]
           )
           log_ttid_overall("Current #{stats_period}", report[:latency][:overall], params[:ttid_p95_target_ms])
 
@@ -93,14 +95,16 @@ module Fastlane
               auth_token: auth_token, org_slug: org_slug, project_id: project_id,
               environment: environment,
               start_date: prev_dates[:start], end_date: prev_dates[:end],
-              per_page: params[:ttid_screen_count]
+              per_page: params[:ttid_screen_count],
+              exclude_screens: params[:ttid_exclude_screens]
             )
             log_ttid("Previous #{stats_period}", report[:latency][:previous], params[:ttid_p95_target_ms])
 
             report[:latency][:overall_previous] = fetch_ttid_overall(
               auth_token: auth_token, org_slug: org_slug, project_id: project_id,
               environment: environment,
-              start_date: prev_dates[:start], end_date: prev_dates[:end]
+              start_date: prev_dates[:start], end_date: prev_dates[:end],
+              exclude_screens: params[:ttid_exclude_screens]
             )
             log_ttid_overall("Previous #{stats_period}", report[:latency][:overall_previous], params[:ttid_p95_target_ms])
           end
@@ -133,7 +137,8 @@ module Fastlane
 
           report[:issues][:top_crashes] = fetch_top_crash_issues(
             auth_token: auth_token, org_slug: org_slug, project_slug: project_slug,
-            stats_period: stats_period, per_page: params[:crash_issue_count]
+            stats_period: stats_period, per_page: params[:crash_issue_count],
+            query: params[:crash_query]
           )
           log_top_crashes(report[:issues][:top_crashes])
 
@@ -286,6 +291,16 @@ module Fastlane
                                          optional: true,
                                          default_value: 5,
                                          type: Integer),
+            FastlaneCore::ConfigItem.new(key: :crash_query,
+                                         description: "Custom Sentry search query for top crash issues",
+                                         optional: true,
+                                         default_value: "is:unresolved issue.category:error error.unhandled:true",
+                                         type: String),
+            FastlaneCore::ConfigItem.new(key: :ttid_exclude_screens,
+                                         description: "Array of screen (transaction) names to exclude from TTID queries",
+                                         optional: true,
+                                         default_value: [],
+                                         type: Array),
             # ── Output ──
             FastlaneCore::ConfigItem.new(key: :output_json,
                                          description: "Path to write JSON report file (optional)",
@@ -327,7 +342,14 @@ module Fastlane
               compare_releases: false
             )
             rate = report[:availability][:current][:crash_free_session_rate]
-            UI.important("Crash-free: #{(rate * 100).round(2)}%")'
+            UI.important("Crash-free: #{(rate * 100).round(2)}%")',
+
+            '# Exclude specific screens from TTID metrics
+            sentry_slo_report(
+              crash_free_target: 0.998,
+              ttid_exclude_screens: ["AppContainerViewController", "SplashScreenViewController"],
+              output_json: "slo_report.json"
+            )'
           ]
         end
 
@@ -407,7 +429,7 @@ module Fastlane
           end
         end
 
-        def fetch_ttid(auth_token:, org_slug:, project_id:, environment:, stats_period: nil, start_date: nil, end_date: nil, per_page: 10)
+        def fetch_ttid(auth_token:, org_slug:, project_id:, environment:, stats_period: nil, start_date: nil, end_date: nil, per_page: 10, exclude_screens: [])
           fields = [
             'transaction',
             'avg(measurements.time_to_initial_display)',
@@ -421,7 +443,7 @@ module Fastlane
             dataset: 'metrics',
             field: fields,
             project: project_id.to_s,
-            query: 'event.type:transaction transaction.op:ui.load',
+            query: ttid_query(exclude_screens),
             sort: '-count()',
             per_page: per_page.to_s
           }
@@ -455,7 +477,7 @@ module Fastlane
           end
         end
 
-        def fetch_ttid_overall(auth_token:, org_slug:, project_id:, environment:, stats_period: nil, start_date: nil, end_date: nil)
+        def fetch_ttid_overall(auth_token:, org_slug:, project_id:, environment:, stats_period: nil, start_date: nil, end_date: nil, exclude_screens: [])
           fields = [
             'avg(measurements.time_to_initial_display)',
             'p50(measurements.time_to_initial_display)',
@@ -468,7 +490,7 @@ module Fastlane
             dataset: 'metrics',
             field: fields,
             project: project_id.to_s,
-            query: 'event.type:transaction transaction.op:ui.load',
+            query: ttid_query(exclude_screens),
             per_page: '1'
           }
 
@@ -555,13 +577,13 @@ module Fastlane
           '14d'
         end
 
-        def fetch_top_crash_issues(auth_token:, org_slug:, project_slug:, stats_period:, per_page:)
+        def fetch_top_crash_issues(auth_token:, org_slug:, project_slug:, stats_period:, per_page:, query:)
           response = Helper::SentryApiHelper.get_issues(
             auth_token: auth_token,
             org_slug: org_slug,
             project_slug: project_slug,
             params: {
-              query: 'is:unresolved issue.category:error error.unhandled:true',
+              query: query,
               sort: 'freq',
               statsPeriod: issues_api_stats_period(stats_period),
               per_page: per_page.to_s
@@ -673,6 +695,14 @@ module Fastlane
           { avg: nil, p50: nil, p75: nil, p95: nil, count: nil }
         end
 
+        def ttid_query(exclude_screens)
+          parts = ['event.type:transaction transaction.op:ui.load']
+          (exclude_screens || []).each do |screen|
+            parts << "!transaction:#{screen}"
+          end
+          parts.join(' ')
+        end
+
         def round_ms(value)
           return nil if value.nil?
 

data/lib/fastlane/plugin/sentry_api/actions/sentry_ttid_percentiles_action.rb

@@ -160,7 +160,12 @@ module Fastlane
                                          description: "Also fetch overall/aggregate TTID percentiles across all screens",
                                          optional: true,
                                          default_value: false,
-                                         type: Fastlane::Boolean)
+                                         type: Fastlane::Boolean),
+            FastlaneCore::ConfigItem.new(key: :ttid_exclude_screens,
+                                         description: "Array of screen (transaction) names to exclude from TTID queries",
+                                         optional: true,
+                                         default_value: [],
+                                         type: Array)
           ]
         end
 
@@ -220,6 +225,9 @@ module Fastlane
           query_parts = ["event.type:transaction"]
           query_parts << "transaction.op:#{params[:transaction_op]}" if params[:transaction_op]
           query_parts << "release:#{params[:release]}" if params[:release]
+          (params[:ttid_exclude_screens] || []).each do |screen|
+            query_parts << "!transaction:#{screen}"
+          end
 
           query_params = {
             dataset: 'metrics',
@@ -253,6 +261,9 @@ module Fastlane
           query_parts = ['event.type:transaction']
           query_parts << "transaction.op:#{params[:transaction_op]}" if params[:transaction_op]
           query_parts << "release:#{params[:release]}" if params[:release]
+          (params[:ttid_exclude_screens] || []).each do |screen|
+            query_parts << "!transaction:#{screen}"
+          end
 
           query_params = {
             dataset: 'metrics',

data/lib/fastlane/plugin/sentry_api/version.rb

@@ -1,5 +1,5 @@
 module Fastlane
   module SentryApi
-    VERSION = "0.3.0"
+    VERSION = "0.5.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fastlane-plugin-sentry_api
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - crazymanish