aws-sdk-applicationsignals 1.30.0 → 1.31.0

data/lib/aws-sdk-applicationsignals/types.rb

@@ -23,19 +23,18 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that defines a filter for narrowing down results based on
-    # specific attribute values. This can be used to filter services by
-    # platform, environment, or other service characteristics.
+    # Represents a filter for service attributes. Used to narrow down
+    # results based on specific attribute names and values.
     #
     # @!attribute [rw] attribute_filter_name
-    #   The name of the attribute to filter by, such as `Platform`,
-    #   `Environment`, or `BusinessUnit`.
+    #   The name of the attribute to filter on. This corresponds to service
+    #   metadata attributes such as environment, team, or custom tags.
     #   @return [String]
     #
     # @!attribute [rw] attribute_filter_values
-    #   An array of values to match for the specified attribute. Services
-    #   that have any of these values for the attribute will be included in
-    #   the results.
+    #   An array of values to match against the specified attribute.
+    #   Services with attribute values matching any of these values will be
+    #   included in the results.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/AttributeFilter AWS API Documentation
@@ -47,42 +46,40 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that contains information about an audit finding, which
-    # represents an automated analysis result about service behavior,
-    # performance issues, or potential problems identified through heuristic
-    # algorithms.
+    # Represents an audit finding that identifies a potential issue,
+    # misconfiguration, or compliance violation in Application Signals
+    # resources.
     #
     # @!attribute [rw] key_attributes
-    #   The key attributes that identify the service or entity this audit
-    #   finding relates to. This is a string-to-string map that includes
-    #   fields like Type, Name, and Environment.
+    #   A map of key attributes that identify the resource associated with
+    #   this audit finding. These attributes help locate and understand the
+    #   context of the finding.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] auditor_results
-    #   An array of auditor results that contain the specific findings,
-    #   descriptions, and severity levels identified by different auditing
-    #   algorithms.
+    #   An array of results from different auditors that examined the
+    #   resource. Each result includes the auditor name, description, and
+    #   severity level.
     #   @return [Array<Types::AuditorResult>]
     #
     # @!attribute [rw] operation
-    #   The name of the operation associated with this audit finding, if the
-    #   finding is specific to a particular service operation.
+    #   The operation or action that was being audited when this finding was
+    #   discovered. This provides context about what was being examined.
     #   @return [String]
     #
     # @!attribute [rw] metric_graph
-    #   A structure containing metric data queries and time range
-    #   information that provides context for the audit finding through
-    #   relevant performance metrics.
+    #   A metric graph associated with the audit finding, showing relevant
+    #   performance data that may be related to the identified issue.
     #   @return [Types::MetricGraph]
     #
     # @!attribute [rw] dependency_graph
-    #   A structure containing nodes and edges that represent the dependency
-    #   relationships relevant to this audit finding, helping to understand
-    #   the context and potential impact.
+    #   A dependency graph showing the relationships between services that
+    #   may be affected by or related to the audit finding.
     #   @return [Types::DependencyGraph]
     #
     # @!attribute [rw] type
-    #   The type of audit finding.
+    #   The type or category of the audit finding, such as "Performance",
+    #   "Security", or "Configuration".
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/AuditFinding AWS API Documentation
@@ -98,16 +95,17 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that specifies the target entity for audit analysis, such
-    # as a `service`, `SLO`, or `service_operation`.
+    # Specifies a target resource for auditing, such as a service, SLO, or
+    # operation.
     #
     # @!attribute [rw] type
-    #   The type of entity being audited, such as `Service`, `SLO`, or
-    #   `ServiceOperation`.
+    #   The type of resource being targeted for audit, such as "Service",
+    #   "SLO", "ServiceOperation", or "Canary".
     #   @return [String]
     #
     # @!attribute [rw] data
-    #   The specific data identifying the audit target entity.
+    #   The specific data or entity information for the audit target,
+    #   containing details needed to identify and examine the resource.
     #   @return [Types::AuditTargetEntity]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/AuditTarget AWS API Documentation
@@ -119,8 +117,8 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A union structure that contains the specific entity information for
-    # different types of audit targets.
+    # A union type that represents different types of entities that can be
+    # audited, such as services, SLOs, service operations, or canaries.
     #
     # @note AuditTargetEntity is a union - when making an API calls you must set exactly one of the members.
     #
@@ -129,21 +127,27 @@ module Aws::ApplicationSignals
     #   @return [Types::ServiceEntity]
     #
     # @!attribute [rw] slo
-    #   SLO entity information when the audit target is a service level
-    #   objective.
+    #   Service Level Objective entity information when the audit target is
+    #   an SLO.
     #   @return [Types::ServiceLevelObjectiveEntity]
     #
     # @!attribute [rw] service_operation
     #   Service operation entity information when the audit target is a
-    #   specific service operation.
+    #   specific operation within a service.
     #   @return [Types::ServiceOperationEntity]
     #
+    # @!attribute [rw] canary
+    #   Canary entity information when the audit target is a CloudWatch
+    #   Synthetics canary.
+    #   @return [Types::CanaryEntity]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/AuditTargetEntity AWS API Documentation
     #
     class AuditTargetEntity < Struct.new(
       :service,
       :slo,
       :service_operation,
+      :canary,
       :unknown)
       SENSITIVE = []
       include Aws::Structure
@@ -152,25 +156,26 @@ module Aws::ApplicationSignals
       class Service < AuditTargetEntity; end
       class Slo < AuditTargetEntity; end
       class ServiceOperation < AuditTargetEntity; end
+      class Canary < AuditTargetEntity; end
       class Unknown < AuditTargetEntity; end
     end
 
-    # A structure that contains the result of an automated audit analysis,
-    # including the auditor name, description of findings, and severity
-    # level.
+    # Represents the result of an audit performed by a specific auditor on a
+    # resource.
     #
     # @!attribute [rw] auditor
-    #   The name of the auditor algorithm that generated this result.
+    #   The name or identifier of the auditor that performed the examination
+    #   and generated this result.
     #   @return [String]
     #
     # @!attribute [rw] description
-    #   A detailed description of the audit finding, explaining what was
-    #   observed and potential implications.
+    #   A detailed description of what the auditor found, including any
+    #   recommendations for remediation or further investigation.
     #   @return [String]
     #
     # @!attribute [rw] severity
-    #   The severity level of this audit finding, indicating the importance
-    #   and potential impact of the issue.
+    #   The severity level of the finding, such as "Critical", "High",
+    #   "Medium", or "Low". This helps prioritize remediation efforts.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/AuditorResult AWS API Documentation
@@ -359,41 +364,59 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that contains information about a change event that
-    # occurred for a service, such as a deployment or configuration change.
+    # Represents a CloudWatch Synthetics canary that can be audited for
+    # performance and configuration issues.
+    #
+    # @!attribute [rw] canary_name
+    #   The name of the CloudWatch Synthetics canary.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/CanaryEntity AWS API Documentation
+    #
+    class CanaryEntity < Struct.new(
+      :canary_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Represents a change event that occurred in the system, such as
+    # deployments, configuration changes, or other operational events that
+    # may impact service performance.
     #
     # @!attribute [rw] timestamp
-    #   The timestamp when this change event occurred. When used in a raw
-    #   HTTP Query API, it is formatted as epoch time in seconds.
+    #   The timestamp when the change event occurred, expressed as the
+    #   number of milliseconds since January 1, 1970, 00:00:00 UTC.
     #   @return [Time]
     #
     # @!attribute [rw] account_id
-    #   The Amazon Web Services account ID where this change event occurred.
+    #   The AWS account ID where the change event occurred.
     #   @return [String]
     #
     # @!attribute [rw] region
-    #   The Amazon Web Services region where this change event occurred.
+    #   The AWS region where the change event occurred.
     #   @return [String]
     #
     # @!attribute [rw] entity
-    #   The entity (service or resource) that was affected by this change
-    #   event, including its key attributes.
+    #   The entity or resource that was changed, such as a service,
+    #   deployment, or configuration.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] change_event_type
-    #   The type of change event that occurred, such as `DEPLOYMENT`.
+    #   The type of change that occurred, such as "Deployment",
+    #   "Configuration", or "Infrastructure".
     #   @return [String]
     #
     # @!attribute [rw] event_id
-    #   A unique identifier for this change event.
+    #   A unique identifier for the change event.
     #   @return [String]
     #
     # @!attribute [rw] user_name
-    #   The name of the user who initiated this change event, if available.
+    #   The name of the user or system that initiated the change event.
     #   @return [String]
     #
     # @!attribute [rw] event_name
-    #   The name or description of this change event.
+    #   A descriptive name for the change event that provides context about
+    #   what changed.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ChangeEvent AWS API Documentation
@@ -562,18 +585,17 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that represents the dependency relationships relevant to
-    # an audit finding, containing nodes and edges that show how services
-    # and resources are connected.
+    # Represents a graph showing the dependencies between services and
+    # components in your application architecture.
     #
     # @!attribute [rw] nodes
-    #   An array of nodes representing the services, resources, or other
-    #   entities in the dependency graph.
+    #   An array of nodes in the dependency graph, where each node
+    #   represents a service or component.
     #   @return [Array<Types::Node>]
     #
     # @!attribute [rw] edges
-    #   An array of edges representing the connections and relationships
-    #   between the nodes in the dependency graph.
+    #   An array of edges in the dependency graph, where each edge
+    #   represents a connection or dependency between two nodes.
     #   @return [Array<Types::Edge>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/DependencyGraph AWS API Documentation
@@ -617,26 +639,26 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that represents a connection between two nodes in a
-    # dependency graph, showing the relationship and characteristics of the
-    # connection.
+    # Represents a connection between two nodes in a dependency graph,
+    # showing how services or components interact with each other.
     #
     # @!attribute [rw] source_node_id
-    #   The identifier of the source node in this edge connection.
+    #   The identifier of the source node in the dependency relationship.
     #   @return [String]
     #
     # @!attribute [rw] destination_node_id
-    #   The identifier of the destination node in this edge connection.
+    #   The identifier of the destination node in the dependency
+    #   relationship.
     #   @return [String]
     #
     # @!attribute [rw] duration
-    #   The duration or latency associated with this connection, if
-    #   applicable.
+    #   The typical duration or latency of interactions along this edge,
+    #   measured in milliseconds.
     #   @return [Float]
     #
     # @!attribute [rw] connection_type
-    #   The type of connection between the nodes, indicating the nature of
-    #   the relationship.
+    #   The type of connection between the nodes, such as "HTTP",
+    #   "Database", "Queue", or "Internal".
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/Edge AWS API Documentation
@@ -855,27 +877,25 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that defines how services should be grouped based on
-    # specific attributes. This includes the friendly name for the grouping,
-    # the source keys to derive values from, and an optional default value.
+    # Defines how services should be grouped based on specific attributes.
+    # This allows logical organization of services in dashboards and service
+    # maps.
     #
     # @!attribute [rw] grouping_name
-    #   The friendly name for this grouping attribute, such as
-    #   `BusinessUnit` or `Environment`. This name is used to identify the
-    #   grouping in the console and APIs.
+    #   The name of the grouping attribute, such as "Environment",
+    #   "Team", or "Application".
     #   @return [String]
     #
     # @!attribute [rw] grouping_source_keys
-    #   An array of source keys used to derive the grouping attribute value
-    #   from telemetry data, Amazon Web Services tags, or other sources. For
-    #   example, \["business\_unit", "team"\] would look for values in
-    #   those fields.
+    #   An array of source attribute keys that will be used to determine the
+    #   grouping value for each service. These keys correspond to service
+    #   metadata or tags.
     #   @return [Array<String>]
     #
     # @!attribute [rw] default_grouping_value
-    #   The default value to use for this grouping attribute when no value
-    #   can be derived from the source keys. This ensures all services have
-    #   a grouping value even if the source data is missing.
+    #   The default value to use for grouping when a service doesn't have
+    #   any of the specified source keys, such as "Unknown" or
+    #   "Unassigned".
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/GroupingAttributeDefinition AWS API Documentation
@@ -888,19 +908,18 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that contains the complete grouping configuration for an
-    # account, including all defined grouping attributes and metadata about
-    # when it was last updated.
+    # Contains the complete configuration for how services are grouped and
+    # organized in Application Signals.
     #
     # @!attribute [rw] grouping_attribute_definitions
-    #   An array of grouping attribute definitions that specify how services
-    #   should be grouped based on various attributes and source keys.
+    #   An array of grouping attribute definitions that specify the rules
+    #   for organizing services into groups.
     #   @return [Array<Types::GroupingAttributeDefinition>]
     #
     # @!attribute [rw] updated_at
-    #   The timestamp when this grouping configuration was last updated.
-    #   When used in a raw HTTP Query API, it is formatted as epoch time in
-    #   seconds.
+    #   The timestamp when the grouping configuration was last updated,
+    #   expressed as the number of milliseconds since January 1, 1970,
+    #   00:00:00 UTC.
     #   @return [Time]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/GroupingConfiguration AWS API Documentation
@@ -945,69 +964,38 @@ module Aws::ApplicationSignals
     end
 
     # @!attribute [rw] start_time
-    #   The start of the time period to retrieve audit findings for. When
-    #   used in a raw HTTP Query API, it is formatted as epoch time in
-    #   seconds. For example, `1698778057`
+    #   The start time for the audit findings query. Only findings created
+    #   on or after this time will be included in the results. Specify the
+    #   time as the number of milliseconds since January 1, 1970, 00:00:00
+    #   UTC.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
-    #   The end of the time period to retrieve audit findings for. When used
-    #   in a raw HTTP Query API, it is formatted as epoch time in seconds.
-    #   For example, `1698778057`
+    #   The end time for the audit findings query. Only findings created
+    #   before this time will be included in the results. Specify the time
+    #   as the number of milliseconds since January 1, 1970, 00:00:00 UTC.
     #   @return [Time]
     #
     # @!attribute [rw] auditors
-    #   A list of auditor names to filter the findings by. Only findings
-    #   generated by the specified auditors will be returned.
-    #
-    #   The following auditors are available for configuration:
-    #
-    #   * `slo` - SloAuditor: Identifies SLO violations and detects breached
-    #     thresholds during the Assessment phase.
-    #
-    #   * `operation_metric` - OperationMetricAuditor: Detects anomalies in
-    #     service operation metrics from Application Signals RED metrics
-    #     during the Assessment phase
-    #
-    #   * `service_quota` - ServiceQuotaAuditor: Monitors resource
-    #     utilization against service quotas during the Assessment phase
-    #
-    #   * `trace` - TraceAuditor: Performs deep-dive analysis of distributed
-    #     traces, correlating traces with breached SLOs or abnormal RED
-    #     metrics during the Analysis phase
-    #
-    #   * `dependency_metric` - CriticalPathAuditor: Analyzes service
-    #     dependency impacts and maps dependency relationships from
-    #     Application Signals RED metrics during the Analysis phase
-    #
-    #   * `top_contributor` - TopContributorAuditor: Identifies
-    #     infrastructure-level contributors to issues by analyzing EMF logs
-    #     of Application Signals RED metrics during the Analysis phase
-    #
-    #   * `log` - LogAuditor: Extracts insights from application logs,
-    #     categorizing error types and ranking severity by frequency during
-    #     the Analysis phase
-    #
-    #   <note markdown="1"> `InitAuditor` and `Summarizer` auditors are not configurable as they
-    #   are automatically triggered during the audit process.
-    #
-    #    </note>
+    #   An array of auditor names to filter the findings. Only findings
+    #   generated by the specified auditors will be returned. When not
+    #   specified, findings from all auditors are included except canary.
     #   @return [Array<String>]
     #
     # @!attribute [rw] audit_targets
-    #   A list of audit targets to filter the findings by. You can specify
-    #   services, SLOs, or service operations to limit the audit findings to
-    #   specific entities.
+    #   An array of audit target specifications to filter the findings. Only
+    #   findings related to the specified targets (such as specific
+    #   services, SLOs, operations or canary) will be returned.
     #   @return [Array<Types::AuditTarget>]
     #
     # @!attribute [rw] next_token
-    #   Include this value, if it was returned by the previous operation, to
-    #   get the next set of audit findings.
+    #   The token for the next set of results. Use this token to retrieve
+    #   additional pages of audit findings when the result set is large.
     #   @return [String]
     #
     # @!attribute [rw] max_results
-    #   The maximum number of audit findings to return in one operation. If
-    #   you omit this parameter, the default of 10 is used.
+    #   The maximum number of audit findings to return in a single request.
+    #   Valid range is 1 to 100. If not specified, defaults to 50.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ListAuditFindingsInput AWS API Documentation
@@ -1024,14 +1012,15 @@ module Aws::ApplicationSignals
     end
 
     # @!attribute [rw] audit_findings
-    #   An array of structures, where each structure contains information
-    #   about one audit finding, including the auditor results, severity,
-    #   and associated metric and dependency graphs.
+    #   An array of audit findings that match the specified criteria. Each
+    #   finding includes details about the issue, affected resources, and
+    #   auditor results.
     #   @return [Array<Types::AuditFinding>]
     #
     # @!attribute [rw] next_token
-    #   Include this value in your next use of this API to get the next set
-    #   of audit findings.
+    #   The token to use for retrieving the next page of results. This value
+    #   is present only if there are more results available than were
+    #   returned in the current response.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ListAuditFindingsOutput AWS API Documentation
@@ -1044,8 +1033,9 @@ module Aws::ApplicationSignals
     end
 
     # @!attribute [rw] next_token
-    #   Include this value, if it was returned by the previous operation, to
-    #   get the next set of grouping attribute definitions.
+    #   The token for the next set of results. Use this token to retrieve
+    #   additional pages of grouping attribute definitions when the result
+    #   set is large.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ListGroupingAttributeDefinitionsInput AWS API Documentation
@@ -1057,20 +1047,20 @@ module Aws::ApplicationSignals
     end
 
     # @!attribute [rw] grouping_attribute_definitions
-    #   An array of structures, where each structure contains information
-    #   about one grouping attribute definition, including the grouping
-    #   name, source keys, and default values.
+    #   An array of available grouping attribute definitions that can be
+    #   used to create grouping configurations.
     #   @return [Array<Types::GroupingAttributeDefinition>]
     #
     # @!attribute [rw] updated_at
-    #   The timestamp when the grouping configuration was last updated. When
-    #   used in a raw HTTP Query API, it is formatted as epoch time in
-    #   seconds.
+    #   The timestamp when the grouping attribute definitions were last
+    #   updated. Expressed as the number of milliseconds since January 1,
+    #   1970, 00:00:00 UTC.
     #   @return [Time]
     #
     # @!attribute [rw] next_token
-    #   Include this value in your next use of this API to get the next set
-    #   of grouping attribute definitions.
+    #   The token to use for retrieving the next page of results. This value
+    #   is present only if there are more results available than were
+    #   returned in the current response.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ListGroupingAttributeDefinitionsOutput AWS API Documentation
@@ -1541,41 +1531,44 @@ module Aws::ApplicationSignals
     end
 
     # @!attribute [rw] start_time
-    #   The start of the time period to retrieve service state information
-    #   for. When used in a raw HTTP Query API, it is formatted as epoch
-    #   time in seconds. For example, `1698778057`.
+    #   The start time for the service states query. Only service states
+    #   from this time onward will be included. Specify the time as the
+    #   number of milliseconds since January 1, 1970, 00:00:00 UTC.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
-    #   The end of the time period to retrieve service state information
-    #   for. When used in a raw HTTP Query API, it is formatted as epoch
-    #   time in seconds. For example, `1698778057`.
+    #   The end time for the service states query. Only service states
+    #   before this time will be included. Specify the time as the number of
+    #   milliseconds since January 1, 1970, 00:00:00 UTC.
     #   @return [Time]
     #
     # @!attribute [rw] max_results
-    #   The maximum number of service states to return in one operation. If
-    #   you omit this parameter, the default of 20 is used.
+    #   The maximum number of service states to return in a single request.
+    #   Valid range is 1 to 100. If not specified, defaults to 50.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
-    #   Include this value, if it was returned by the previous operation, to
-    #   get the next set of service states.
+    #   The token for the next set of results. Use this token to retrieve
+    #   additional pages of service states when the result set is large.
     #   @return [String]
     #
     # @!attribute [rw] include_linked_accounts
-    #   If you are using this operation in a monitoring account, specify
-    #   `true` to include service states from source accounts in the
-    #   returned data.
+    #   Specifies whether to include service states from linked AWS accounts
+    #   in the results. Set to `true` to include linked accounts, or `false`
+    #   to only include the current account. Defaults to `false`.
     #   @return [Boolean]
     #
     # @!attribute [rw] aws_account_id
-    #   The Amazon Web Services account ID to filter service states by. Use
-    #   this to limit results to services from a specific account.
+    #   The AWS account ID to filter service states. If specified, only
+    #   service states from this account will be returned. If not specified,
+    #   service states from the current account (and linked accounts if
+    #   enabled) are returned.
     #   @return [String]
     #
     # @!attribute [rw] attribute_filters
-    #   A list of attribute filters to narrow down the services. You can
-    #   filter by platform, environment, or other service attributes.
+    #   An array of attribute filters to narrow down the service states
+    #   returned. Each filter specifies an attribute name and the values to
+    #   match against.
     #   @return [Array<Types::AttributeFilter>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ListServiceStatesInput AWS API Documentation
@@ -1593,26 +1586,25 @@ module Aws::ApplicationSignals
     end
 
     # @!attribute [rw] start_time
-    #   The start of the time period that the returned information applies
-    #   to. When used in a raw HTTP Query API, it is formatted as epoch time
-    #   in seconds. For example, `1698778057`.
+    #   The start time of the query range, expressed as the number of
+    #   milliseconds since January 1, 1970, 00:00:00 UTC.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
-    #   The end of the time period that the returned information applies to.
-    #   When used in a raw HTTP Query API, it is formatted as epoch time in
-    #   seconds. For example, `1698778057`.
+    #   The end time of the query range, expressed as the number of
+    #   milliseconds since January 1, 1970, 00:00:00 UTC.
     #   @return [Time]
     #
     # @!attribute [rw] service_states
-    #   An array of structures, where each structure contains information
-    #   about the state of one service, including its latest change events
-    #   such as deployments.
+    #   An array of service state objects that match the specified criteria.
+    #   Each service state includes current status, recent change events,
+    #   and service metadata.
     #   @return [Array<Types::ServiceState>]
     #
     # @!attribute [rw] next_token
-    #   Include this value in your next use of this API to get the next set
-    #   of service states.
+    #   The token to use for retrieving the next page of results. This value
+    #   is present only if there are more results available than were
+    #   returned in the current response.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ListServiceStatesOutput AWS API Documentation
@@ -1920,23 +1912,23 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that contains metric data queries and time range
-    # information that provides context for audit findings through relevant
-    # performance metrics.
+    # Represents a graph of metric data over time, showing performance
+    # trends and patterns for monitored resources.
     #
     # @!attribute [rw] metric_data_queries
-    #   An array of metric data queries that define the metrics to be
-    #   retrieved and analyzed as part of the audit finding context.
+    #   An array of metric data queries that define what metrics to display
+    #   in the graph. Each query specifies the metric source, aggregation,
+    #   and time range.
     #   @return [Array<Types::MetricDataQuery>]
     #
     # @!attribute [rw] start_time
-    #   The start time for the metric data included in this graph. When used
-    #   in a raw HTTP Query API, it is formatted as epoch time in seconds.
+    #   The start time for the metric data displayed in the graph, expressed
+    #   as the number of milliseconds since January 1, 1970, 00:00:00 UTC.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
-    #   The end time for the metric data included in this graph. When used
-    #   in a raw HTTP Query API, it is formatted as epoch time in seconds.
+    #   The end time for the metric data displayed in the graph, expressed
+    #   as the number of milliseconds since January 1, 1970, 00:00:00 UTC.
     #   @return [Time]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/MetricGraph AWS API Documentation
@@ -2081,39 +2073,41 @@ module Aws::ApplicationSignals
       class Unknown < MonitoredRequestCountMetricDataQueries; end
     end
 
-    # A structure that represents a node in a dependency graph, containing
-    # information about a service, resource, or other entity and its
-    # characteristics.
+    # Represents a node in a dependency graph, typically corresponding to a
+    # service or component in your application architecture.
     #
     # @!attribute [rw] key_attributes
-    #   The key attributes that identify this node, including Type, Name,
-    #   and Environment information.
+    #   A map of key attributes that identify and describe the node, such as
+    #   service name, environment, and other metadata.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] name
-    #   The name of the entity represented by this node.
+    #   The display name of the node, typically the service or component
+    #   name.
     #   @return [String]
     #
     # @!attribute [rw] node_id
-    #   A unique identifier for this node within the dependency graph.
+    #   A unique identifier for the node within the dependency graph.
     #   @return [String]
     #
     # @!attribute [rw] operation
-    #   The operation associated with this node, if applicable.
+    #   The specific operation or endpoint within the service that this node
+    #   represents, if applicable.
     #   @return [String]
     #
     # @!attribute [rw] type
-    #   The type of entity represented by this node, such as `Service` or
-    #   `Resource`.
+    #   The type of node, such as "Service", "Database", "Queue", or
+    #   "External".
     #   @return [String]
     #
     # @!attribute [rw] duration
-    #   The duration or processing time associated with this node, if
-    #   applicable.
+    #   The typical response time or processing duration for this node,
+    #   measured in milliseconds.
     #   @return [Float]
     #
     # @!attribute [rw] status
-    #   The status of the entity represented by this node.
+    #   The current health status of the node, such as "Healthy",
+    #   "Warning", or "Critical".
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/Node AWS API Documentation
@@ -2132,9 +2126,8 @@ module Aws::ApplicationSignals
 
     # @!attribute [rw] grouping_attribute_definitions
     #   An array of grouping attribute definitions that specify how services
-    #   should be grouped. Each definition includes a friendly name, source
-    #   keys to derive the grouping value from, and an optional default
-    #   value.
+    #   should be grouped. Each definition includes the grouping name,
+    #   source keys, and default values.
     #   @return [Array<Types::GroupingAttributeDefinition>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/PutGroupingConfigurationInput AWS API Documentation
@@ -2146,9 +2139,8 @@ module Aws::ApplicationSignals
     end
 
     # @!attribute [rw] grouping_configuration
-    #   A structure containing the updated grouping configuration, including
-    #   all grouping attribute definitions and the timestamp when it was
-    #   last updated.
+    #   The created or updated grouping configuration, including all
+    #   attribute definitions and metadata such as the update timestamp.
     #   @return [Types::GroupingConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/PutGroupingConfigurationOutput AWS API Documentation
@@ -2500,7 +2492,7 @@ module Aws::ApplicationSignals
     #
     # @!attribute [rw] service_groups
     #   An array of service groups that this service belongs to, based on
-    #   the configured grouping attributes.
+    #   the configured grouping rules.
     #   @return [Array<Types::ServiceGroup>]
     #
     # @!attribute [rw] metric_references
@@ -2635,24 +2627,24 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that contains identifying information for a service
-    # entity.
+    # Represents a service entity that is monitored by Application Signals.
     #
     # @!attribute [rw] type
-    #   The type of the service entity.
+    #   The type of service, such as "WebService", "Database",
+    #   "Queue", or "Function".
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The name of the service.
+    #   The name of the service as identified by Application Signals.
     #   @return [String]
     #
     # @!attribute [rw] environment
-    #   The environment where the service is deployed.
+    #   The environment where the service is deployed, such as
+    #   "Production", "Staging", or "Development".
     #   @return [String]
     #
     # @!attribute [rw] aws_account_id
-    #   The Amazon Web Services account ID where the service is located.
-    #   Provide this value only for cross-account access.
+    #   The AWS account ID where the service is deployed.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ServiceEntity AWS API Documentation
@@ -2666,27 +2658,26 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that represents a logical grouping of services based on
-    # shared attributes such as business unit, environment, or entry point.
+    # Represents a logical grouping of services based on shared attributes
+    # or characteristics.
     #
     # @!attribute [rw] group_name
-    #   The name of the grouping attribute, such as `BusinessUnit` or
-    #   `Environment`.
+    #   The name of the group, such as "Environment", "Team", or
+    #   "Application".
     #   @return [String]
     #
     # @!attribute [rw] group_value
-    #   The value of the grouping attribute for this service, such as
-    #   `Payments` or `Production`.
+    #   The specific value for this group, such as "Production",
+    #   "TeamA", or "WebApp".
     #   @return [String]
     #
     # @!attribute [rw] group_source
-    #   The source of the grouping attribute, such as `TAG`, `OTEL`, or
-    #   `DEFAULT`.
+    #   The source of the grouping information, such as "Tag",
+    #   "Attribute", or "Manual".
     #   @return [String]
     #
     # @!attribute [rw] group_identifier
-    #   A unique identifier for this grouping attribute value, used for
-    #   filtering and API operations.
+    #   A unique identifier for the group within the grouping configuration.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ServiceGroup AWS API Documentation
@@ -2856,8 +2847,8 @@ module Aws::ApplicationSignals
     #   @return [String]
     #
     # @!attribute [rw] metric_name
-    #   The name of the CloudWatch metric to use for the SLO, when using a
-    #   custom metric rather than Application Signals standard metrics.
+    #   The name of the CloudWatch metric used as a service level indicator
+    #   (SLI) for measuring service performance.
     #   @return [String]
     #
     # @!attribute [rw] statistic
@@ -3147,16 +3138,15 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that contains identifying information for a service level
-    # objective entity.
+    # Represents a Service Level Objective (SLO) entity that can be audited
+    # for compliance and performance.
     #
     # @!attribute [rw] slo_name
-    #   The name of the service level objective.
+    #   The name of the Service Level Objective.
     #   @return [String]
     #
     # @!attribute [rw] slo_arn
-    #   The ARN of the service level objective. The SLO must be provided
-    #   with ARN for cross-account access.
+    #   The Amazon Resource Name (ARN) of the Service Level Objective.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ServiceLevelObjectiveEntity AWS API Documentation
@@ -3271,19 +3261,20 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that contains identifying information for a service
-    # operation entity.
+    # Represents a specific operation within a service that can be monitored
+    # and audited independently.
     #
     # @!attribute [rw] service
     #   The service entity that contains this operation.
     #   @return [Types::ServiceEntity]
     #
     # @!attribute [rw] operation
-    #   The name of the operation.
+    #   The name of the specific operation within the service.
     #   @return [String]
     #
     # @!attribute [rw] metric_type
-    #   The type of metric associated with this service operation.
+    #   The type of metric associated with this service operation, such as
+    #   "Latency", "ErrorRate", or "Throughput".
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ServiceOperationEntity AWS API Documentation
@@ -3309,24 +3300,21 @@ module Aws::ApplicationSignals
       include Aws::Structure
     end
 
-    # A structure that contains information about the current state of a
-    # service, including its latest change events such as deployments and
-    # other state-changing activities.
+    # Represents the current state and health information for a service
+    # monitored by Application Signals.
     #
     # @!attribute [rw] attribute_filters
     #   The attribute filters that were applied when retrieving this service
-    #   state information.
+    #   state.
     #   @return [Array<Types::AttributeFilter>]
     #
     # @!attribute [rw] service
-    #   The key attributes that identify this service, including Type, Name,
-    #   and Environment information.
+    #   The service entity information for this service state.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] latest_change_events
-    #   An array containing the most recent change events for this service,
-    #   such as deployments, with information about when they occurred and
-    #   who initiated them.
+    #   An array of the most recent change events that may have affected
+    #   this service, such as deployments or configuration changes.
     #   @return [Array<Types::ChangeEvent>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ServiceState AWS API Documentation
@@ -3424,8 +3412,8 @@ module Aws::ApplicationSignals
     #   @return [Array<Types::MetricReference>]
     #
     # @!attribute [rw] service_groups
-    #   An array of service groups that this service belongs to, based on
-    #   the configured grouping attributes.
+    #   An array of service groups that this service belongs to, providing a
+    #   summary view of the service's organizational context.
     #   @return [Array<Types::ServiceGroup>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/ServiceSummary AWS API Documentation