oci 2.16.0 → 2.17.0

data/lib/oci/apm_config/models/config_summary.rb

@@ -6,7 +6,7 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # The request body used to update the Configuration entity. It must specify the data to update the item with.
+  # A description of a configuration item. It specifes all the properties that define the configuration item.
   #
   # This class has direct subclasses. If you are using this class as input to a service operations then you should favor using a subclass over the base class
   class ApmConfig::Models::ConfigSummary
@@ -17,13 +17,13 @@ module OCI
       CONFIG_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the configuration item. An OCID will be generated
+    # The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the configuration item. An OCID is generated
     # when the item is created.
     #
     # @return [String]
     attr_accessor :id
 
-    # **[Required]** The type of configuration item
+    # **[Required]** The type of configuration item.
     # @return [String]
     attr_reader :config_type
 

data/lib/oci/apm_config/models/create_apdex_rules_details.rb

@@ -7,15 +7,14 @@ require_relative 'create_config_details'
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
   # The set of Apdex rules to be used in Apdex computation. In the current version, only one rule set may exist per
-  # configuration, and attempting to create a rule set if it already exists will result in an error. This may change
-  # in future releases.
+  # configuration, and attempting to create a rule set if it already exists results in an error.
   #
   class ApmConfig::Models::CreateApdexRulesDetails < ApmConfig::Models::CreateConfigDetails
     # This attribute is required.
     # @return [Array<OCI::ApmConfig::Models::Apdex>]
     attr_accessor :rules
 
-    # **[Required]** The name by which this rule set can be displayed to the user.
+    # **[Required]** The name by which this rule set is displayed to the end user.
     # @return [String]
     attr_accessor :display_name
 

data/lib/oci/apm_config/models/create_config_details.rb

@@ -5,8 +5,8 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # The request body used to create new Configuration entities. It must specify the configuration type of the item to
-  # create, as well as the actual data to populate the item with.
+  # The request body used to create new configuration items. It must specify the configuration type of the item,
+  # as well as the actual data to populate the item with.
   #
   # This class has direct subclasses. If you are using this class as input to a service operations then you should favor using a subclass over the base class
   class ApmConfig::Models::CreateConfigDetails
@@ -16,7 +16,7 @@ module OCI
       CONFIG_TYPE_APDEX = 'APDEX'.freeze
     ].freeze
 
-    # **[Required]** The type of configuration item
+    # **[Required]** The type of configuration item.
     # @return [String]
     attr_reader :config_type
 

data/lib/oci/apm_config/models/create_metric_group_details.rb

@@ -6,28 +6,31 @@ require_relative 'create_config_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A Metric Group.
+  # A metric group defines a set of metrics to collect from a span. It uses a span filter to specify which spans to
+  # process. The set is then published to a namespace, which is a product level subdivision of metrics.
   #
   class ApmConfig::Models::CreateMetricGroupDetails < ApmConfig::Models::CreateConfigDetails
-    # **[Required]** The name of this metric group
+    # **[Required]** The name of the metric group.
     # @return [String]
     attr_accessor :display_name
 
     # **[Required]** The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of a Span Filter. The filterId is mandatory for the creation
-    # of MetricGroups. A filterId will be generated when a Span Filter is created.
+    # of MetricGroups. A filterId is generated when a Span Filter is created.
     #
     # @return [String]
     attr_accessor :filter_id
 
-    # The namespace to write the metrics to
+    # The namespace to which the metrics are published. It must be one of several predefined namespaces.
+    #
     # @return [String]
     attr_accessor :namespace
 
-    # A list of dimensions for this metric
+    # A list of dimensions for the metric. This variable should not be used.
     # @return [Array<OCI::ApmConfig::Models::Dimension>]
     attr_accessor :dimensions
 
-    # This attribute is required.
+    # **[Required]** The list of metrics in this group.
+    #
     # @return [Array<OCI::ApmConfig::Models::Metric>]
     attr_accessor :metrics
 

data/lib/oci/apm_config/models/create_span_filter_details.rb

@@ -6,9 +6,9 @@ require_relative 'create_config_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A span filter is a named setting that specifies filter criteria to match a subset of the spans.
+  # A named setting that specifies the filter criteria to match a subset of the spans.
   class ApmConfig::Models::CreateSpanFilterDetails < ApmConfig::Models::CreateConfigDetails
-    # **[Required]** The name by which this filter can be displayed in the UI.
+    # **[Required]** The name by which the span filter can be displayed in the UI.
     # @return [String]
     attr_accessor :display_name
 

data/lib/oci/apm_config/models/dimension.rb

@@ -5,14 +5,14 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A dimension is a label that can be used to describe or group metrics.
+  # A dimension is a label that is used to describe or group metrics.
   #
   class ApmConfig::Models::Dimension
-    # **[Required]** The dimension name
+    # **[Required]** The name of the dimension.
     # @return [String]
     attr_accessor :name
 
-    # The source to populate the dimension. Must be NULL at the moment.
+    # The source to populate the dimension. This must not be specified.
     #
     # @return [String]
     attr_accessor :value_source

data/lib/oci/apm_config/models/metric.rb

@@ -6,22 +6,22 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A metric. This a quantitative measurement of an entity.
+  # A metric is a quantitative measurement of an entity.
   #
   class ApmConfig::Models::Metric
-    # **[Required]** The name of the metric
+    # **[Required]** The name of the metric. This must be a known metric name.
     # @return [String]
     attr_accessor :name
 
-    # Must be NULL at the moment, and \"name\" must be a known metric.
+    # This must not be set.
     # @return [String]
     attr_accessor :value_source
 
-    # The unit of the metric
+    # The unit of the metric.
     # @return [String]
     attr_accessor :unit
 
-    # A description of the metric
+    # A description of the metric.
     # @return [String]
     attr_accessor :description
 

data/lib/oci/apm_config/models/metric_group.rb

@@ -6,27 +6,31 @@ require_relative 'config'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A Metric Group.
+  # A metric group defines a set of metrics to collect from a span. It uses a span filter to specify which spans to
+  # process. The set is then published to a namespace, which is a product level subdivision of metrics.
   #
   class ApmConfig::Models::MetricGroup < ApmConfig::Models::Config
-    # The name of this metric group
+    # The name of the metric group.
     # @return [String]
     attr_accessor :display_name
 
     # The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of a Span Filter. The filterId is mandatory for the creation
-    # of MetricGroups. A filterId will be generated when a Span Filter is created.
+    # of MetricGroups. A filterId is generated when a Span Filter is created.
     #
     # @return [String]
     attr_accessor :filter_id
 
-    # The namespace to write the metrics to
+    # The namespace to which the metrics are published. It must be one of several predefined namespaces.
+    #
     # @return [String]
     attr_accessor :namespace
 
-    # A list of dimensions for this metric
+    # A list of dimensions for the metric. This variable should not be used.
     # @return [Array<OCI::ApmConfig::Models::Dimension>]
     attr_accessor :dimensions
 
+    # The list of metrics in this group.
+    #
     # @return [Array<OCI::ApmConfig::Models::Metric>]
     attr_accessor :metrics
 

data/lib/oci/apm_config/models/metric_group_summary.rb

@@ -6,27 +6,31 @@ require_relative 'config_summary'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A Metric Group.
+  # A metric group defines a set of metrics to collect from a span. It uses a span filter to specify which spans to
+  # process. The set is then published to a namespace, which is a product level subdivision of metrics.
   #
   class ApmConfig::Models::MetricGroupSummary < ApmConfig::Models::ConfigSummary
-    # The name of this metric group
+    # The name of the metric group.
     # @return [String]
     attr_accessor :display_name
 
     # The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of a Span Filter. The filterId is mandatory for the creation
-    # of MetricGroups. A filterId will be generated when a Span Filter is created.
+    # of MetricGroups. A filterId is generated when a Span Filter is created.
     #
     # @return [String]
     attr_accessor :filter_id
 
-    # The namespace to write the metrics to
+    # The namespace to which the metrics are published. It must be one of several predefined namespaces.
+    #
     # @return [String]
     attr_accessor :namespace
 
-    # A list of dimensions for this metric
+    # A list of dimensions for the metric. This variable should not be used.
     # @return [Array<OCI::ApmConfig::Models::Dimension>]
     attr_accessor :dimensions
 
+    # The list of metrics in this group.
+    #
     # @return [Array<OCI::ApmConfig::Models::Metric>]
     attr_accessor :metrics
 

data/lib/oci/apm_config/models/span_filter.rb

@@ -6,9 +6,9 @@ require_relative 'config'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A span filter is a named setting that specifies filter criteria to match a subset of the spans.
+  # A named setting that specifies the filter criteria to match a subset of the spans.
   class ApmConfig::Models::SpanFilter < ApmConfig::Models::Config
-    # The name by which this filter can be displayed in the UI.
+    # The name by which the span filter is displayed to the end user.
     # @return [String]
     attr_accessor :display_name
 
@@ -17,7 +17,7 @@ module OCI
     # @return [String]
     attr_accessor :filter_text
 
-    # An optional string that describes what the filter is intended or used for.
+    # An optional string that describes what the span filter is intended or used for.
     # @return [String]
     attr_accessor :description
 

data/lib/oci/apm_config/models/span_filter_summary.rb

@@ -6,9 +6,9 @@ require_relative 'config_summary'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A span filter is a named setting that specifies filter criteria to match a subset of the spans.
+  # A named setting that specifies the span filter criteria to match a subset of the spans.
   class ApmConfig::Models::SpanFilterSummary < ApmConfig::Models::ConfigSummary
-    # The name by which this filter can be displayed in the UI.
+    # The name by which the span filter is displayed in the UI.
     # @return [String]
     attr_accessor :display_name
 

data/lib/oci/apm_config/models/update_apdex_rules_details.rb

@@ -13,7 +13,7 @@ module OCI
     # @return [Array<OCI::ApmConfig::Models::Apdex>]
     attr_accessor :rules
 
-    # The name by which this rule set can be displayed to the user.
+    # The name by which the rule set is displayed to the end user.
     # @return [String]
     attr_accessor :display_name
 

data/lib/oci/apm_config/models/update_config_details.rb

@@ -5,7 +5,7 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # The request body used to update the Configuration entity. It must specify the data to update the item with.
+  # The request body used to update the configuration item. It must specify the data to update the item with.
   #
   # This class has direct subclasses. If you are using this class as input to a service operations then you should favor using a subclass over the base class
   class ApmConfig::Models::UpdateConfigDetails
@@ -15,7 +15,7 @@ module OCI
       CONFIG_TYPE_APDEX = 'APDEX'.freeze
     ].freeze
 
-    # **[Required]** The type of configuration item
+    # **[Required]** The type of configuration item.
     # @return [String]
     attr_reader :config_type
 

data/lib/oci/apm_config/models/update_metric_group_details.rb

@@ -6,27 +6,31 @@ require_relative 'update_config_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A Metric Group.
+  # A metric group defines a set of metrics to collect from a span. It uses a span filter to specify which spans to
+  # process. The set is then published to a namespace, which is a product level subdivision of metrics.
   #
   class ApmConfig::Models::UpdateMetricGroupDetails < ApmConfig::Models::UpdateConfigDetails
-    # The name of this metric group
+    # The name of the metric group.
     # @return [String]
     attr_accessor :display_name
 
     # The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of a Span Filter. The filterId is mandatory for the creation
-    # of MetricGroups. A filterId will be generated when a Span Filter is created.
+    # of MetricGroups. A filterId is generated when a Span Filter is created.
     #
     # @return [String]
     attr_accessor :filter_id
 
-    # The namespace to write the metrics to
+    # The namespace to which the metrics are published. It must be one of several predefined namespaces.
+    #
     # @return [String]
     attr_accessor :namespace
 
-    # A list of dimensions for this metric
+    # A list of dimensions for the metric. This variable should not be used.
     # @return [Array<OCI::ApmConfig::Models::Dimension>]
     attr_accessor :dimensions
 
+    # The list of metrics in this group.
+    #
     # @return [Array<OCI::ApmConfig::Models::Metric>]
     attr_accessor :metrics
 

data/lib/oci/apm_config/models/update_span_filter_details.rb

@@ -6,9 +6,9 @@ require_relative 'update_config_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A span filter is a named setting that specifies filter criteria to match a subset of the spans.
+  # A named setting that specifies the filter criteria to match a subset of the spans.
   class ApmConfig::Models::UpdateSpanFilterDetails < ApmConfig::Models::UpdateConfigDetails
-    # The name by which this filter can be displayed in the UI.
+    # The name by which the span filter can be displayed in the UI.
     # @return [String]
     attr_accessor :display_name
 

data/lib/oci/apm_traces/apm_traces.rb

@@ -11,6 +11,8 @@ module OCI
 end
 
 # Require models
+require 'oci/apm_traces/models/aggregated_snapshot'
+require 'oci/apm_traces/models/aggregated_stack_trace'
 require 'oci/apm_traces/models/query_details'
 require 'oci/apm_traces/models/query_result_metadata_summary'
 require 'oci/apm_traces/models/query_result_response'
@@ -19,12 +21,17 @@ require 'oci/apm_traces/models/query_result_row_type_summary'
 require 'oci/apm_traces/models/query_results_grouped_by_summary'
 require 'oci/apm_traces/models/query_results_ordered_by_summary'
 require 'oci/apm_traces/models/quick_pick_summary'
+require 'oci/apm_traces/models/snapshot_detail'
 require 'oci/apm_traces/models/span'
 require 'oci/apm_traces/models/span_log'
 require 'oci/apm_traces/models/span_log_collection'
+require 'oci/apm_traces/models/span_snapshot'
+require 'oci/apm_traces/models/stack_trace_element'
 require 'oci/apm_traces/models/tag'
+require 'oci/apm_traces/models/thread_snapshot'
 require 'oci/apm_traces/models/trace'
 require 'oci/apm_traces/models/trace_service_summary'
+require 'oci/apm_traces/models/trace_snapshot'
 require 'oci/apm_traces/models/trace_span_summary'
 
 # Require generated clients

data/lib/oci/apm_traces/models/aggregated_snapshot.rb

@@ -0,0 +1,167 @@
+# Copyright (c) 2016, 2022, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+require 'date'
+
+# rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
+module OCI
+  # Aggregated snapshots of all spans.
+  #
+  class ApmTraces::Models::AggregatedSnapshot
+    # **[Required]** Aggregated snapshot details.
+    #
+    # @return [Array<OCI::ApmTraces::Models::SnapshotDetail>]
+    attr_accessor :details
+
+    # **[Required]** List of aggregated stack trace.
+    #
+    # @return [Array<OCI::ApmTraces::Models::AggregatedStackTrace>]
+    attr_accessor :aggregated_stack_traces
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'details': :'details',
+        'aggregated_stack_traces': :'aggregatedStackTraces'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'details': :'Array<OCI::ApmTraces::Models::SnapshotDetail>',
+        'aggregated_stack_traces': :'Array<OCI::ApmTraces::Models::AggregatedStackTrace>'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [Array<OCI::ApmTraces::Models::SnapshotDetail>] :details The value to assign to the {#details} property
+    # @option attributes [Array<OCI::ApmTraces::Models::AggregatedStackTrace>] :aggregated_stack_traces The value to assign to the {#aggregated_stack_traces} property
+    def initialize(attributes = {})
+      return unless attributes.is_a?(Hash)
+
+      # convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }
+
+      self.details = attributes[:'details'] if attributes[:'details']
+
+      self.aggregated_stack_traces = attributes[:'aggregatedStackTraces'] if attributes[:'aggregatedStackTraces']
+
+      raise 'You cannot provide both :aggregatedStackTraces and :aggregated_stack_traces' if attributes.key?(:'aggregatedStackTraces') && attributes.key?(:'aggregated_stack_traces')
+
+      self.aggregated_stack_traces = attributes[:'aggregated_stack_traces'] if attributes[:'aggregated_stack_traces']
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] other the other object to be compared
+    def ==(other)
+      return true if equal?(other)
+
+      self.class == other.class &&
+        details == other.details &&
+        aggregated_stack_traces == other.aggregated_stack_traces
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+    # @see the `==` method
+    # @param [Object] other the other object to be compared
+    def eql?(other)
+      self == other
+    end
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # Calculates hash code according to all attributes.
+    # @return [Fixnum] Hash code
+    def hash
+      [details, aggregated_stack_traces].hash
+    end
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+
+      self.class.swagger_types.each_pair do |key, type|
+        if type =~ /^Array<(.*)>/i
+          # check to ensure the input is an array given that the the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            public_method("#{key}=").call(
+              attributes[self.class.attribute_map[key]]
+                .map { |v| OCI::Internal::Util.convert_to_type(Regexp.last_match(1), v) }
+            )
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          public_method("#{key}=").call(
+            OCI::Internal::Util.convert_to_type(type, attributes[self.class.attribute_map[key]])
+          )
+        end
+        # or else data not found in attributes(hash), not an issue as the data can be optional
+      end
+
+      self
+    end
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = public_method(attr).call
+        next if value.nil? && !instance_variable_defined?("@#{attr}")
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    private
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+  end
+end
+# rubocop:enable Lint/UnneededCopDisableDirective, Metrics/LineLength