sumologic-query 1.3.5 → 1.4.0

data/lib/sumologic/metadata/health_event.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative 'loggable'
+
+module Sumologic
+  module Metadata
+    # Handles health event operations
+    # Uses GET /v1/healthEvents endpoint
+    class HealthEvent
+      include Loggable
+
+      def initialize(http_client:)
+        @http = http_client
+      end
+
+      # List all health events
+      #
+      # @param limit [Integer] Maximum events to return (default: 100)
+      # @return [Array<Hash>] Array of health event data
+      def list(limit: 100)
+        data = @http.request(
+          method: :get,
+          path: '/healthEvents',
+          query_params: { limit: limit }
+        )
+
+        events = data['data'] || []
+        log_info "Fetched #{events.size} health events"
+        events
+      rescue StandardError => e
+        raise Error, "Failed to list health events: #{e.message}"
+      end
+    end
+  end
+end

data/lib/sumologic/metadata/lookup_table.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative 'loggable'
+
+module Sumologic
+  module Metadata
+    # Handles lookup table operations
+    # Uses GET /v1/lookupTables/{id} endpoint
+    # Note: There is no list-all endpoint for lookup tables
+    class LookupTable
+      include Loggable
+
+      def initialize(http_client:)
+        @http = http_client
+      end
+
+      # Get a specific lookup table by ID
+      #
+      # @param lookup_id [String] The lookup table ID
+      # @return [Hash] Lookup table data
+      def get(lookup_id)
+        data = @http.request(
+          method: :get,
+          path: "/lookupTables/#{lookup_id}"
+        )
+
+        log_info "Retrieved lookup table: #{data['name']} (#{lookup_id})"
+        data
+      rescue StandardError => e
+        raise Error, "Failed to get lookup table #{lookup_id}: #{e.message}"
+      end
+    end
+  end
+end

data/lib/sumologic/metadata/models.rb

@@ -2,64 +2,8 @@
 
 module Sumologic
   module Metadata
-    # Value object representing a Sumo Logic Collector
-    class CollectorModel
-      attr_reader :id, :name, :collector_type, :alive, :category
-
-      def initialize(data)
-        @id = data['id']
-        @name = data['name']
-        @collector_type = data['collectorType']
-        @alive = data['alive']
-        @category = data['category']
-      end
-
-      # Convert to hash for JSON serialization
-      def to_h
-        {
-          'id' => @id,
-          'name' => @name,
-          'collectorType' => @collector_type,
-          'alive' => @alive,
-          'category' => @category
-        }.compact
-      end
-
-      def active?
-        @alive == true
-      end
-    end
-
-    # Value object representing a static Source from collectors API
-    class SourceModel
-      attr_reader :id, :name, :category, :source_type, :alive
-
-      def initialize(data)
-        @id = data['id']
-        @name = data['name']
-        @category = data['category']
-        @source_type = data['sourceType']
-        @alive = data['alive']
-      end
-
-      # Convert to hash for JSON serialization
-      def to_h
-        {
-          'id' => @id,
-          'name' => @name,
-          'category' => @category,
-          'sourceType' => @source_type,
-          'alive' => @alive
-        }.compact
-      end
-
-      def active?
-        @alive == true
-      end
-    end
-
-    # Value object representing a Dynamic Source discovered from logs
-    class DynamicSourceModel
+    # Value object representing source metadata discovered from logs
+    class SourceMetadata
       attr_reader :name, :category, :message_count
 
       def initialize(name:, category:, message_count:)
@@ -82,27 +26,5 @@ module Sumologic
         other.message_count <=> @message_count
       end
     end
-
-    # Value object for collector with its sources
-    class CollectorWithSources
-      attr_reader :collector, :sources
-
-      def initialize(collector:, sources:)
-        @collector = collector.is_a?(CollectorModel) ? collector : CollectorModel.new(collector)
-        @sources = sources.map { |s| s.is_a?(SourceModel) ? s : SourceModel.new(s) }
-      end
-
-      # Convert to hash for JSON serialization
-      def to_h
-        {
-          'collector' => @collector.to_h,
-          'sources' => @sources.map(&:to_h)
-        }
-      end
-
-      def source_count
-        @sources.size
-      end
-    end
   end
 end

data/lib/sumologic/metadata/monitor.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require_relative 'loggable'
+require_relative 'models'
+
+module Sumologic
+  module Metadata
+    # Handles monitor metadata operations via the search API
+    # Uses GET /v1/monitors/search instead of recursive folder traversal
+    class Monitor
+      include Loggable
+
+      VALID_STATUSES = %w[Normal Critical Warning MissingData Disabled AllTriggered].freeze
+
+      def initialize(http_client:)
+        @http = http_client
+      end
+
+      # List monitors using the search API
+      # Supports server-side filtering by status and query
+      #
+      # @param query [String, nil] Search query to filter by name/description
+      # @param status [String, nil] Monitor status filter
+      #   (Normal, Critical, Warning, MissingData, Disabled, AllTriggered)
+      # @param limit [Integer] Maximum number of monitors to return (default: 100)
+      # @return [Array<Hash>] Array of monitor data with path info
+      def list(query: nil, status: nil, limit: 100)
+        validate_status!(status) if status
+
+        monitors = []
+        offset = 0
+
+        loop do
+          batch_limit = [limit - monitors.size, 100].min
+          query_params = build_search_params(query: query, status: status, limit: batch_limit, offset: offset)
+
+          data = @http.request(
+            method: :get,
+            path: '/monitors/search',
+            query_params: query_params
+          )
+
+          items = extract_monitors(data)
+          monitors.concat(items)
+
+          log_info "Fetched #{items.size} monitors (total: #{monitors.size})"
+
+          break if items.size < batch_limit || monitors.size >= limit
+
+          offset += batch_limit
+        end
+
+        monitors.take(limit)
+      rescue StandardError => e
+        raise Error, "Failed to list monitors: #{e.message}"
+      end
+
+      # Get a specific monitor by ID
+      # Returns full monitor details including query and triggers
+      #
+      # @param monitor_id [String] The monitor ID
+      # @return [Hash] Monitor data
+      def get(monitor_id)
+        data = @http.request(
+          method: :get,
+          path: "/monitors/#{monitor_id}"
+        )
+
+        log_info "Retrieved monitor: #{data['name']} (#{monitor_id})"
+        data
+      rescue StandardError => e
+        raise Error, "Failed to get monitor #{monitor_id}: #{e.message}"
+      end
+
+      private
+
+      def build_search_params(query: nil, status: nil, limit: 100, offset: 0)
+        params = { limit: limit, offset: offset }
+
+        # The search endpoint requires a query parameter
+        # Use monitorStatus filter within the query string
+        query_parts = []
+        query_parts << query if query && !query.empty?
+        query_parts << "monitorStatus:#{status}" if status
+
+        # Default to empty query if no filters (returns all monitors)
+        params[:query] = query_parts.empty? ? '' : query_parts.join(' ')
+        params
+      end
+
+      def extract_monitors(data)
+        items = data || []
+        items = [] unless items.is_a?(Array)
+
+        items.filter_map do |item|
+          monitor = item['item'] || item
+          next unless monitor['contentType'] == 'Monitor'
+
+          # Merge path into the monitor data for output
+          monitor['path'] = item['path'] if item['path']
+          monitor
+        end
+      end
+
+      def validate_status!(status)
+        return if VALID_STATUSES.include?(status)
+
+        raise Error,
+              "Invalid monitor status '#{status}'. Valid values: #{VALID_STATUSES.join(', ')}"
+      end
+    end
+  end
+end

data/lib/sumologic/metadata/source.rb

@@ -2,7 +2,6 @@
 
 require_relative 'collector_source_fetcher'
 require_relative 'loggable'
-require_relative 'models'
 
 module Sumologic
   module Metadata
@@ -54,7 +53,7 @@ module Sumologic
       private
 
       # Fetch sources for a single collector
-      # Returns CollectorWithSources model
+      # @return [Hash] collector and sources data
       def fetch_collector_sources(collector)
         collector_id = collector['id']
         collector_name = collector['name']
@@ -62,11 +61,10 @@ module Sumologic
         log_info "Fetching sources for collector: #{collector_name} (#{collector_id})"
         sources = list(collector_id: collector_id)
 
-        # Create model and convert to hash for backward compatibility
-        CollectorWithSources.new(
-          collector: collector,
-          sources: sources
-        ).to_h
+        {
+          'collector' => collector,
+          'sources' => sources
+        }
       rescue StandardError => e
         log_error "Failed to fetch sources for collector #{collector_name}: #{e.message}"
         nil

data/lib/sumologic/metadata/{dynamic_source_discovery.rb → source_metadata_discovery.rb}

@@ -5,9 +5,9 @@ require_relative 'models'
 
 module Sumologic
   module Metadata
-    # Discovers dynamic source names from actual log data via Search API
+    # Discovers source metadata from actual log data via Search API
     # Useful for CloudWatch/ECS sources that use dynamic _sourceName values
-    class DynamicSourceDiscovery
+    class SourceMetadataDiscovery
       include Loggable
 
       def initialize(http_client:, search_job:, config: nil)
@@ -16,7 +16,7 @@ module Sumologic
         @config = config || Configuration.new
       end
 
-      # Discover dynamic source names from logs
+      # Discover source metadata from logs
       # Returns hash with ALL unique source names found
       #
       # @param from_time [String] Start time (ISO 8601, unix timestamp, or relative)
@@ -25,7 +25,7 @@ module Sumologic
       # @param filter [String, nil] Optional filter query to scope results
       def discover(from_time:, to_time:, time_zone: 'UTC', filter: nil)
         query = build_query(filter)
-        log_info "Discovering dynamic sources with query: #{query}"
+        log_info "Discovering source metadata with query: #{query}"
         log_info "Time range: #{from_time} to #{to_time} (#{time_zone})"
 
         # Fetch aggregated records to find all unique sources
@@ -51,7 +51,7 @@ module Sumologic
           'sources' => source_models.map(&:to_h)
         }
       rescue StandardError => e
-        raise Error, "Failed to discover dynamic sources: #{e.message}"
+        raise Error, "Failed to discover source metadata: #{e.message}"
       end
 
       private
@@ -67,7 +67,7 @@ module Sumologic
       end
 
       # Parse aggregation records from search API
-      # Returns array of DynamicSourceModel objects
+      # @return [Array<SourceMetadata>]
       def parse_aggregation_results(records)
         return [] if records.empty?
 
@@ -135,7 +135,7 @@ module Sumologic
       # Build and sort model objects from source hash
       def build_source_models(sources_hash)
         source_models = sources_hash.values.map do |source_data|
-          DynamicSourceModel.new(
+          SourceMetadata.new(
             name: source_data[:name],
             category: source_data[:category],
             message_count: source_data[:count]

data/lib/sumologic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sumologic
-  VERSION = '1.3.5'
+  VERSION = '1.4.0'
 end

data/lib/sumologic.rb

@@ -11,6 +11,20 @@ module Sumologic
 
   # Timeout errors during search job execution
   class TimeoutError < Error; end
+
+  # Rate limit errors (429 responses)
+  # Includes retry_after when available from X-RateLimit-Reset or Retry-After headers
+  class RateLimitError < Error
+    attr_reader :retry_after, :limit, :remaining, :reset_at
+
+    def initialize(message, retry_after: nil, limit: nil, remaining: nil, reset_at: nil)
+      super(message)
+      @retry_after = retry_after
+      @limit = limit
+      @remaining = remaining
+      @reset_at = reset_at
+    end
+  end
 end
 
 # Load configuration first
@@ -35,7 +49,15 @@ require_relative 'sumologic/metadata/models'
 require_relative 'sumologic/metadata/collector'
 require_relative 'sumologic/metadata/collector_source_fetcher'
 require_relative 'sumologic/metadata/source'
-require_relative 'sumologic/metadata/dynamic_source_discovery'
+require_relative 'sumologic/metadata/source_metadata_discovery'
+require_relative 'sumologic/metadata/monitor'
+require_relative 'sumologic/metadata/folder'
+require_relative 'sumologic/metadata/dashboard'
+require_relative 'sumologic/metadata/health_event'
+require_relative 'sumologic/metadata/field'
+require_relative 'sumologic/metadata/lookup_table'
+require_relative 'sumologic/metadata/app'
+require_relative 'sumologic/metadata/content'
 
 # Load main client (facade)
 require_relative 'sumologic/client'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sumologic-query
 version: !ruby/object:Gem::Version
-  version: 1.3.5
+  version: 1.4.0
 platform: ruby
 authors:
 - patrick204nqh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-19 00:00:00.000000000 Z
+date: 2026-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -98,8 +98,19 @@ files:
 - lib/sumologic.rb
 - lib/sumologic/cli.rb
 - lib/sumologic/cli/commands/base_command.rb
-- lib/sumologic/cli/commands/discover_sources_command.rb
+- lib/sumologic/cli/commands/discover_source_metadata_command.rb
+- lib/sumologic/cli/commands/export_content_command.rb
+- lib/sumologic/cli/commands/get_content_command.rb
+- lib/sumologic/cli/commands/get_dashboard_command.rb
+- lib/sumologic/cli/commands/get_lookup_command.rb
+- lib/sumologic/cli/commands/get_monitor_command.rb
+- lib/sumologic/cli/commands/list_apps_command.rb
 - lib/sumologic/cli/commands/list_collectors_command.rb
+- lib/sumologic/cli/commands/list_dashboards_command.rb
+- lib/sumologic/cli/commands/list_fields_command.rb
+- lib/sumologic/cli/commands/list_folders_command.rb
+- lib/sumologic/cli/commands/list_health_events_command.rb
+- lib/sumologic/cli/commands/list_monitors_command.rb
 - lib/sumologic/cli/commands/list_sources_command.rb
 - lib/sumologic/cli/commands/search_command.rb
 - lib/sumologic/client.rb
@@ -118,12 +129,20 @@ files:
 - lib/sumologic/interactive/fzf_viewer/fzf_config.rb
 - lib/sumologic/interactive/fzf_viewer/header_builder.rb
 - lib/sumologic/interactive/fzf_viewer/searchable_builder.rb
+- lib/sumologic/metadata/app.rb
 - lib/sumologic/metadata/collector.rb
 - lib/sumologic/metadata/collector_source_fetcher.rb
-- lib/sumologic/metadata/dynamic_source_discovery.rb
+- lib/sumologic/metadata/content.rb
+- lib/sumologic/metadata/dashboard.rb
+- lib/sumologic/metadata/field.rb
+- lib/sumologic/metadata/folder.rb
+- lib/sumologic/metadata/health_event.rb
 - lib/sumologic/metadata/loggable.rb
+- lib/sumologic/metadata/lookup_table.rb
 - lib/sumologic/metadata/models.rb
+- lib/sumologic/metadata/monitor.rb
 - lib/sumologic/metadata/source.rb
+- lib/sumologic/metadata/source_metadata_discovery.rb
 - lib/sumologic/search/job.rb
 - lib/sumologic/search/message_fetcher.rb
 - lib/sumologic/search/poller.rb