gitlab-triage 1.51.1 → 1.52.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0852608feca48b98d92771b30203ae3f2a83220fdcce24f08d435b9af12c7f20'
-  data.tar.gz: 224da2c7b14a0513d2d06c43ae1c13bb3ac5459114df3daa32da6785354b2247
+  metadata.gz: c0188aec696ec4f1821f6e9d4244a2323527d464e9c51da0b7e2b54053003a2c
+  data.tar.gz: d432a7b181c290420afdd883c01a55f686a1e30d1797f736fbbf3171459f36ee
 SHA512:
-  metadata.gz: 435c98010e80f7bf81e31a0976c36d948e56e2b94da2e08ad9eefef5f6680967ab95c4e91f9667233111d564de27c5380890f546d047e6b1cf55a7c6e6915881
-  data.tar.gz: 9e87b898dab83aee3b7f0585e805a6200478e27fc7cefa441b99422666d7ee51b85819b5e04812542b3e0d6a136384409a0261f7971d97571606d3a369fabc26
+  metadata.gz: 797365b9ad72539cf3027e7e00130cbf88172e11ec46162c7c38e25d7eebbaca39cb6d5518a033ac7b820e127c15b0ef8a3d64c8011a0dcd45f4d9ef985a13c6
+  data.tar.gz: 46c14ed3a8916402aefe35aaa6b5f80c8b6b647ee4f6e1ab7bbf138ac4c0c9fd0326a672be08abc1043bfdcc5280d74456554a71f2f390439f1b9858828401f7

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    gitlab-triage (1.51.1)
+    gitlab-triage (1.52.0)
       activesupport (>= 5.1)
       globalid (~> 1.0, >= 1.0.1)
       graphql (< 2.1.0)

data/lib/gitlab/triage/api_observability.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module Gitlab
+  module Triage
+    module APIObservability
+      class Tracker
+        PAGINATION_PARAMS = %w[page per_page].freeze
+
+        attr_reader :calls, :resources_fetched
+
+        def initialize
+          @calls = Hash.new(0)
+          @resources_fetched = 0
+          @rate_limit_waits = 0
+          @start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        end
+
+        def record(method, url, resource_count: 0)
+          @calls["#{method} #{normalize_endpoint(url)}"] += 1
+          @resources_fetched += resource_count
+        end
+
+        def record_rate_limit_wait
+          @rate_limit_waits += 1
+        end
+
+        def total
+          @calls.values.sum
+        end
+
+        def print_summary
+          elapsed = Process.clock_gettime(Process::CLOCK_MONOTONIC) - @start_time
+
+          puts "\n"
+          puts '=' * 70
+          puts '  API Call Summary'
+          puts '=' * 70
+          puts "  Total HTTP requests:  #{total}"
+          puts "  Resources fetched:    #{@resources_fetched}"
+          puts "  Rate limit waits:     #{@rate_limit_waits}"
+          puts "  Elapsed time:         #{elapsed.round(1)}s"
+          puts '-' * 70
+
+          @calls.sort_by { |_, count| -count }.each do |endpoint, count|
+            puts "  #{count.to_s.rjust(5)}x  #{endpoint}"
+          end
+
+          puts '=' * 70
+        end
+
+        private
+
+        def normalize_endpoint(url)
+          uri = URI.parse(url)
+          path = uri.path
+                    .sub(%r{/api/v\d+}, '')
+                    .sub(%r{/projects/[^/]+}, '/projects/:id')
+                    .sub(%r{/groups/[^/]+}, '/groups/:id')
+                    .gsub(%r{/\d+(/|\z)}, '/:id\1')
+
+          query_keys = (URI.decode_www_form(uri.query || '').map(&:first) - PAGINATION_PARAMS).sort
+
+          path += "?#{query_keys.join('&')}" if query_keys.any?
+          path
+        rescue URI::InvalidURIError
+          url
+        end
+      end
+    end
+  end
+end

data/lib/gitlab/triage/engine.rb

@@ -32,6 +32,7 @@ require_relative 'network_adapters/httparty_adapter'
 require_relative 'network_adapters/graphql_adapter'
 require_relative 'graphql_queries/query_builder'
 require_relative 'ui'
+require_relative 'api_observability'
 
 module Gitlab
   module Triage
@@ -90,20 +91,26 @@ module Gitlab
       def perform
         puts "Performing a dry run.\n\n" if options.dry_run
 
-        puts Gitlab::Triage::UI.header("Triaging the `#{options.source_id}` #{options.source.singularize}", char: '=')
-        puts
+        unless options.quiet
+          puts Gitlab::Triage::UI.header("Triaging the `#{options.source_id}` #{options.source.singularize}", char: '=')
+          puts
+        end
 
         resource_rules.each do |resource_type, policy_definition|
           next unless right_resource_type_for_resource_option?(resource_type)
 
           assert_epic_rule!(resource_type)
 
-          puts Gitlab::Triage::UI.header("Processing summaries & rules for #{resource_type}", char: '-')
-          puts
+          unless options.quiet
+            puts Gitlab::Triage::UI.header("Processing summaries & rules for #{resource_type}", char: '-')
+            puts
+          end
 
           process_summaries(resource_type, policy_definition[:summaries])
           process_rules(resource_type, policy_definition[:rules])
         end
+
+        tracker.print_summary if options.summary
       end
 
       def network
@@ -204,12 +211,16 @@ module Gitlab
         @resource_rules ||= policies.delete(:resource_rules) { {} }
       end
 
+      def tracker
+        @tracker ||= options.summary ? APIObservability::Tracker.new : nil
+      end
+
       def network_adapter
-        @network_adapter ||= @network_adapter_class.new(options)
+        @network_adapter ||= @network_adapter_class.new(options, tracker: tracker)
       end
 
       def graphql_network_adapter
-        @graphql_network_adapter ||= @graphql_network_adapter_class.new(options)
+        @graphql_network_adapter ||= @graphql_network_adapter_class.new(options, tracker: tracker)
       end
 
       def rule_conditions(rule)
@@ -310,8 +321,10 @@ module Gitlab
       #
       # @return [nil]
       def process_summary(resource_type, summary_definition)
-        puts Gitlab::Triage::UI.header("Processing summary: **#{summary_definition[:name]}**", char: '~')
-        puts
+        unless options.quiet
+          puts Gitlab::Triage::UI.header("Processing summary: **#{summary_definition[:name]}**", char: '~')
+          puts
+        end
 
         summary_parts_for_rules(resource_type, summary_definition[:rules]) do |summary_resources|
           policy = Policies::SummaryPolicy.new(
@@ -365,7 +378,7 @@ module Gitlab
       #
       # @return [nil]
       def resources_for_rule(resource_type, rule_definition, in_summary: false)
-        puts Gitlab::Triage::UI.header("Gathering resources for rule: **#{rule_definition[:name]}**", char: '-')
+        puts Gitlab::Triage::UI.header("Gathering resources for rule: **#{rule_definition[:name]}**", char: '-') unless options.quiet
 
         # Skip resource fetching for custom type rules
         if rule_definition[:type] == 'custom'
@@ -373,7 +386,7 @@ module Gitlab
             raise ArgumentError, "type: custom can only be used in summary rules, not in top-level rules (rule: #{rule_definition[:name]})"
           end
 
-          puts "\n* Skipping resource fetch for custom type rule"
+          puts "\n* Skipping resource fetch for custom type rule" unless options.quiet
           yield(PoliciesResources::RuleResources.new([]), {})
           return
         end
@@ -391,14 +404,23 @@ module Gitlab
           # In some filters/actions we want to know which resource type it is
           attach_resource_type(resources, resource_type)
 
-          puts "\n\n* Found #{resources.count} resources..."
-          print "* Filtering resources..."
+          unless options.quiet
+            puts "\n\n* Found #{resources.count} resources..."
+            print "* Filtering resources..."
+          end
+
           resources = filter_resources(resources, expanded_conditions)
-          puts "\n* Total after filtering: #{resources.count} resources"
-          print "* Limiting resources..."
+
+          unless options.quiet
+            puts "\n* Total after filtering: #{resources.count} resources"
+            print "* Limiting resources..."
+          end
+
           resources = limit_resources(resources, rule_limits(rule_definition))
-          puts "\n* Total after limiting: #{resources.count} resources"
-          puts
+          unless options.quiet
+            puts "\n* Total after limiting: #{resources.count} resources"
+            puts
+          end
 
           resources = sanitize_resources(resources)
 
@@ -470,7 +492,7 @@ module Gitlab
           policy: policy,
           network: network,
           dry: options.dry_run)
-        puts
+        puts unless options.quiet
       end
 
       def filter_resources(resources, conditions)

data/lib/gitlab/triage/graphql_network.rb

@@ -29,7 +29,7 @@ module Gitlab
         parsed_graphql_query = adapter.parse(graphql_query.query)
 
         begin
-          print '.'
+          print '.' unless options.quiet
 
           response = adapter.query(
             parsed_graphql_query,
@@ -52,7 +52,7 @@ module Gitlab
       def mutate(graphql_mutation, variables = {})
         return if graphql_mutation.blank?
 
-        print '.'
+        print '.' unless options.quiet
 
         parsed_mutation = adapter.parse(graphql_mutation)
 
@@ -99,6 +99,7 @@ module Gitlab
         return unless reset_at
 
         puts Gitlab::Triage::UI.debug "Rate limit almost exceeded, sleeping for #{reset_at - Time.now} seconds" if options.debug
+        adapter.tracker&.record_rate_limit_wait
         sleep(1) until Time.now >= reset_at
       end
     end

data/lib/gitlab/triage/network_adapters/base_adapter.rb

@@ -8,10 +8,11 @@ module Gitlab
       class BaseAdapter
         USER_AGENT = "GitLab Triage #{Gitlab::Triage::VERSION}".freeze
 
-        attr_reader :options
+        attr_reader :options, :tracker
 
-        def initialize(options)
+        def initialize(options, tracker: nil)
           @options = options
+          @tracker = tracker
         end
       end
     end

data/lib/gitlab/triage/network_adapters/graphql_adapter.rb

@@ -138,8 +138,11 @@ module Gitlab
         end
 
         def http_client
-          Client::HTTP.new("#{options.host_url}/api/graphql") do
-            def execute(document:, operation_name: nil, variables: {}, context: {}) # rubocop:disable Lint/NestedMethodDefinition
+          graphql_tracker = tracker
+          graphql_url = "#{options.host_url}/api/graphql"
+
+          Client::HTTP.new(graphql_url) do
+            define_method(:execute) do |document:, operation_name: nil, variables: {}, context: {}|
               body = {}
               body['query'] = document.to_query_string
               body['variables'] = variables if variables.any?
@@ -157,6 +160,7 @@ module Gitlab
 
               case response.code
               when 200, 400
+                graphql_tracker&.record('POST', graphql_url)
                 JSON.parse(response.body).merge('extensions' => { 'headers' => response.headers })
               else
                 { 'errors' => [{ 'message' => "#{response.code} #{response.message}" }] }

data/lib/gitlab/triage/network_adapters/httparty_adapter.rb

@@ -24,13 +24,18 @@ module Gitlab
           raise_on_internal_server_error!(response)
           raise_on_too_many_requests!(response)
 
-          {
+          result = {
             more_pages: (response.headers["x-next-page"].to_s != ""),
             next_page_url: next_page_url(url, response),
             results: response.parsed_response,
             ratelimit_remaining: response.headers["ratelimit-remaining"].to_i,
             ratelimit_reset_at: Time.at(response.headers["ratelimit-reset"].to_i)
           }
+
+          resource_count = result[:results].is_a?(Array) ? result[:results].size : 0
+          tracker&.record('GET', url, resource_count: resource_count)
+
+          result
         end
 
         def post(token, url, body)
@@ -48,6 +53,8 @@ module Gitlab
           raise_on_internal_server_error!(response)
           raise_on_too_many_requests!(response)
 
+          tracker&.record('POST', url)
+
           {
             results: response.parsed_response,
             ratelimit_remaining: response.headers["ratelimit-remaining"].to_i,
@@ -68,6 +75,8 @@ module Gitlab
           raise_on_internal_server_error!(response)
           raise_on_too_many_requests!(response)
 
+          tracker&.record('DELETE', url)
+
           {
             results: response.parsed_response,
             ratelimit_remaining: response.headers["ratelimit-remaining"].to_i,

data/lib/gitlab/triage/option_parser.rb

@@ -65,6 +65,14 @@ module Gitlab
               options.debug = value
             end
 
+            opts.on('--summary', 'Print API call summary at end of execution') do |value|
+              options.summary = value
+            end
+
+            opts.on('--quiet', 'Suppress pagination dots and section headers') do |value|
+              options.quiet = value
+            end
+
             opts.on('--cache-dir [string]', String,
               'Directory containing pre-fetched API responses. ' \
                 'Files must follow the naming convention: <source>_<id>_<resource>.json ' \

data/lib/gitlab/triage/options.rb

@@ -15,7 +15,9 @@ module Gitlab
       :host_url,
       :require_files,
       :api_version,
-      :cache_dir
+      :cache_dir,
+      :summary,
+      :quiet
     ) do
       def initialize(*args)
         super

data/lib/gitlab/triage/rest_api_network.rb

@@ -35,7 +35,7 @@ module Gitlab
         resources = []
 
         begin
-          print '.'
+          print '.' unless options.quiet
           url = response.fetch(:next_page_url) { url }
 
           response = execute_with_retry(
@@ -165,6 +165,7 @@ module Gitlab
         return unless response.delete(:ratelimit_remaining) < MINIMUM_RATE_LIMIT
 
         puts Gitlab::Triage::UI.debug "Rate limit almost exceeded, sleeping for #{response[:ratelimit_reset_at] - Time.now} seconds" if options.debug
+        @adapter.tracker&.record_rate_limit_wait
         sleep(1) until Time.now >= response[:ratelimit_reset_at]
       end
 

data/lib/gitlab/triage/version.rb

@@ -2,6 +2,6 @@
 
 module Gitlab
   module Triage
-    VERSION = '1.51.1'
+    VERSION = '1.52.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab-triage
 version: !ruby/object:Gem::Version
-  version: 1.51.1
+  version: 1.52.0
 platform: ruby
 authors:
 - GitLab
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-08 00:00:00.000000000 Z
+date: 2026-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -240,6 +240,7 @@ files:
 - lib/gitlab/triage/action/issue.rb
 - lib/gitlab/triage/action/summarize.rb
 - lib/gitlab/triage/action/work_item_status.rb
+- lib/gitlab/triage/api_observability.rb
 - lib/gitlab/triage/api_query_builders/base_query_param_builder.rb
 - lib/gitlab/triage/api_query_builders/date_query_param_builder.rb
 - lib/gitlab/triage/api_query_builders/multi_query_param_builder.rb