fastlane-plugin-sentry_api 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cee8dc5203226fee972dc466c125f43e872f655f4776dc703feb349a638a8ea1
-  data.tar.gz: 8d4f199b0714184b9475043557c0150da47fa83881b09de8e1ebe4b4866187e8
+  metadata.gz: e998c3813e2bc19b0bfa6e76e1a102cfb546dbf4bce827f7bc4a6605417af6b8
+  data.tar.gz: 3f614ff5d0b6f8e3bcb0091d6fa4e13444114aea9517521f2ebc03eee95f49c8
 SHA512:
-  metadata.gz: dbbb4b57bf4a3fa1530489172d9c40024e04f2b2c54ceb59ae2c79bc1f63488749528d708c7e31353212fbabf5e16c5a6ed26b893c5a2a96b9c7affed0d920e1
-  data.tar.gz: 1ef24556a924fd1a372e56e8693d8eac3c25295d4a30608cd3c72a5f064c6cc34d0ff8b96739da6cc88495858560cdc570d5fe97148ca9eb8982dde9178f2c62
+  metadata.gz: 0b33aa8f31b3fcb6678f232129a57b3cc610c0eefd72bb6fb1bcd0d82454483540ce86834b2d48f366d9262043637ac82be68851d105faa1befe5ff172c1b579
+  data.tar.gz: d4cfdf3c7bf563ee2c407da39b6a4ef7dd8d3e5fc7d022d2b08def70f736f1b34ac56f4209bf34cdc9ee861ff5f5ad8e30b4a9ea33e11012e3746767d60292dd

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:**
 
@@ -163,7 +163,7 @@ Query TTID (Time to Initial Display) percentiles per screen from the Sentry Even
 | `sort` | `String` | No | `-count()` | Sort order |
 | `include_overall` | `Boolean` | No | `false` | Also fetch overall/aggregate TTID percentiles across all screens |
 
-**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)
+**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 +171,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]}: 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
@@ -208,7 +208,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 +249,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,13 +303,14 @@ 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 |
 | `output_json` | `String` | No | — | Path to write JSON report file |
 
 **Output (SharedValues):** `SENTRY_SLO_REPORT` (complete hash with `:availability`, `:latency`, `:issues`)
 
 The `:latency` section includes:
 - `:current` — array of per-screen TTID data
-- `:overall` — aggregate TTID `{ p50:, p75:, p95:, count: }` across all screens
+- `:overall` — aggregate TTID `{ avg:, p50:, p75:, p95:, count: }` across all screens
 - `:app_launch` — `{ cold: { p50:, p75:, p95:, count: }, warm: { ... } }`
 - `:previous`, `:overall_previous`, `:app_launch_previous` — week-over-week counterparts (when `compare_weeks` is true)
 
@@ -338,7 +339,7 @@ report = lane_context[SharedValues::SENTRY_SLO_REPORT]
 
 # Overall TTID
 overall = report[:latency][:overall]
-UI.message("Overall TTID p95: #{overall[:p95]}ms")
+UI.message("Overall TTID avg: #{overall[:avg]}ms p95: #{overall[:p95]}ms")
 
 # App launch
 cold = report[:latency][:app_launch][:cold]
@@ -375,11 +376,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]}: 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: 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

@@ -133,7 +133,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 +287,11 @@ 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),
             # ── Output ──
             FastlaneCore::ConfigItem.new(key: :output_json,
                                          description: "Path to write JSON report file (optional)",
@@ -410,6 +416,7 @@ module Fastlane
         def fetch_ttid(auth_token:, org_slug:, project_id:, environment:, stats_period: nil, start_date: nil, end_date: nil, per_page: 10)
           fields = [
             'transaction',
+            'avg(measurements.time_to_initial_display)',
             'p50(measurements.time_to_initial_display)',
             'p75(measurements.time_to_initial_display)',
             'p95(measurements.time_to_initial_display)',
@@ -445,6 +452,7 @@ module Fastlane
           data.map do |row|
             {
               transaction: row['transaction'],
+              avg: round_ms(row['avg(measurements.time_to_initial_display)']),
               p50: round_ms(row['p50(measurements.time_to_initial_display)']),
               p75: round_ms(row['p75(measurements.time_to_initial_display)']),
               p95: round_ms(row['p95(measurements.time_to_initial_display)']),
@@ -455,6 +463,7 @@ module Fastlane
 
         def fetch_ttid_overall(auth_token:, org_slug:, project_id:, environment:, stats_period: nil, start_date: nil, end_date: nil)
           fields = [
+            'avg(measurements.time_to_initial_display)',
             'p50(measurements.time_to_initial_display)',
             'p75(measurements.time_to_initial_display)',
             'p95(measurements.time_to_initial_display)',
@@ -487,6 +496,7 @@ module Fastlane
 
           row = response[:json]&.dig('data', 0) || {}
           {
+            avg: round_ms(row['avg(measurements.time_to_initial_display)']),
             p50: round_ms(row['p50(measurements.time_to_initial_display)']),
             p75: round_ms(row['p75(measurements.time_to_initial_display)']),
             p95: round_ms(row['p95(measurements.time_to_initial_display)']),
@@ -551,13 +561,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
@@ -666,7 +676,7 @@ module Fastlane
         end
 
         def empty_ttid_overall
-          { p50: nil, p75: nil, p95: nil, count: nil }
+          { avg: nil, p50: nil, p75: nil, p95: nil, count: nil }
         end
 
         def round_ms(value)
@@ -815,19 +825,8 @@ module Fastlane
             cold = app_launch[:cold]
             warm = app_launch[:warm]
             launch_target = params[:app_launch_p95_target_ms]
-
-            if cold && cold[:p95]
-              indicator = if launch_target
-                            cold[:p95] <= launch_target ? "✅" : "⚠️"
-                          else
-                            ""
-                          end
-              UI.message("Cold start p95: #{cold[:p95]}ms #{indicator} (target: #{launch_target}ms)")
-            end
-
-            if warm && warm[:p95]
-              UI.message("Warm start p95: #{warm[:p95]}ms")
-            end
+            log_cold_start(cold, launch_target)
+            UI.message("Warm start p95: #{warm[:p95]}ms") if warm && warm[:p95]
           end
 
           # Top Crash Issues
@@ -852,6 +851,19 @@ module Fastlane
           UI.success("SLO report generated at #{report[:generated_at]}")
         end
 
+        def log_cold_start(cold, launch_target)
+          return unless cold && cold[:p95]
+
+          indicator = target_indicator(cold[:p95], launch_target)
+          UI.message("Cold start p95: #{cold[:p95]}ms #{indicator} (target: #{launch_target}ms)")
+        end
+
+        def target_indicator(value, target)
+          return "" unless target
+
+          value <= target ? "✅" : "⚠️"
+        end
+
         def format_pct(value)
           return "N/A" if value.nil?
 

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

@@ -1,5 +1,5 @@
 module Fastlane
   module SentryApi
-    VERSION = "0.2.0"
+    VERSION = "0.4.0"
   end
 end

metadata

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