fastlane-plugin-sentry_api 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e998c3813e2bc19b0bfa6e76e1a102cfb546dbf4bce827f7bc4a6605417af6b8
-  data.tar.gz: 3f614ff5d0b6f8e3bcb0091d6fa4e13444114aea9517521f2ebc03eee95f49c8
+  metadata.gz: bf6e5df1b17f042687dd22fd18486555d04b5cfe3e493f479cfa4ca1e3f392ef
+  data.tar.gz: d03707db9075c322a007109bf0e5b73804a1f061657fc39088008623cb0ee2ce
 SHA512:
-  metadata.gz: 0b33aa8f31b3fcb6678f232129a57b3cc610c0eefd72bb6fb1bcd0d82454483540ce86834b2d48f366d9262043637ac82be68851d105faa1befe5ff172c1b579
-  data.tar.gz: d4cfdf3c7bf563ee2c407da39b6a4ef7dd8d3e5fc7d022d2b08def70f736f1b34ac56f4209bf34cdc9ee861ff5f5ad8e30b4a9ea33e11012e3746767d60292dd
+  metadata.gz: 8dc7401daf7358046bfa80d0a6bbf1cbd929d317825a1f4c70466518b99be17b6656932a735377deccc616773a832434a654ae41cb3c54012053aa81ce3a3c49
+  data.tar.gz: 1f0197ae4d7a65f04a294b89d45dac2b9ae45a4f251630dc0664c5be090c0dcf66fe675f1b2ed120651f00f27d64cf0713065d96be39a7b19ea3c57f6cabb1fc

data/README.md

@@ -162,6 +162,7 @@ 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:, 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`
 
@@ -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"]
+)
 ```
 
 ---
@@ -304,6 +312,7 @@ Includes target checking with ✅/⚠️ indicators and optional JSON file outpu
 | `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`)
@@ -316,6 +325,7 @@ The `:latency` section includes:
 
 The `:issues` section includes:
 - `:top_crashes` — array of top unhandled error issues (always fetched, not release-scoped)
+- `:total_crash_count` — total number of crash issues matching the query (up to 100), useful when you only display top N but want to show the full count
 - `:current_release` — `{ version:, count:, issues: [] }` (when `current_release` is provided)
 - `:previous_release` — same structure (when `previous_release` is provided)
 
@@ -346,6 +356,7 @@ cold = report[:latency][:app_launch][:cold]
 UI.message("Cold start p95: #{cold[:p95]}ms")
 
 # Top crash issues
+UI.message("Total crash issues: #{report[:issues][:total_crash_count]}")
 report[:issues][:top_crashes].each do |issue|
   UI.message("#{issue[:short_id]}: #{issue[:title]} (#{issue[:event_count]} events)")
 end
@@ -357,6 +368,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"
+)
 ```
 
 ---

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
@@ -131,11 +135,13 @@ module Fastlane
           # ── TOP CRASH ISSUES ────────────────────────────────────────────
           UI.header("Top Crash Issues")
 
-          report[:issues][:top_crashes] = fetch_top_crash_issues(
+          crash_result = 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],
             query: params[:crash_query]
           )
+          report[:issues][:top_crashes] = crash_result[:issues]
+          report[:issues][:total_crash_count] = crash_result[:total_count]
           log_top_crashes(report[:issues][:top_crashes])
 
           # ── ISSUES (Release Comparison) ─────────────────────────────────
@@ -292,6 +298,11 @@ module Fastlane
                                          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)",
@@ -333,7 +344,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
 
@@ -413,7 +431,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)',
@@ -427,7 +445,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
           }
@@ -461,7 +479,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)',
@@ -474,7 +492,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'
           }
 
@@ -570,17 +588,17 @@ module Fastlane
               query: query,
               sort: 'freq',
               statsPeriod: issues_api_stats_period(stats_period),
-              per_page: per_page.to_s
+              per_page: '100'
             }
           )
 
           unless response[:status].between?(200, 299)
             UI.error("Sentry Issues API error #{response[:status]}: #{response[:body]}")
-            return []
+            return { issues: [], total_count: 0 }
           end
 
           issues_data = response[:json] || []
-          issues_data.first(per_page).map do |issue|
+          issues = issues_data.first(per_page).map do |issue|
             {
               id: issue['id'],
               short_id: issue['shortId'],
@@ -592,6 +610,8 @@ module Fastlane
               last_seen: issue['lastSeen']
             }
           end
+
+          { issues: issues, total_count: issues_data.length }
         end
 
         def fetch_issues_for_release(auth_token:, org_slug:, project_slug:, release:, per_page:)
@@ -679,6 +699,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.4.0"
+    VERSION = "0.6.0"
   end
 end

metadata

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