@aws-sdk/client-application-signals 3.935.0 → 3.937.0

package/dist-types/models/models_0.d.ts

@@ -1,4 +1,4 @@
-import { ChangeEventType, ConnectionType, DurationUnit, EvaluationType, MetricSourceType, ServiceLevelIndicatorComparisonOperator, ServiceLevelIndicatorMetricType, ServiceLevelObjectiveBudgetStatus, Severity, StandardUnit } from "./enums";
+import { ChangeEventType, ConnectionType, DetailLevel, DurationUnit, EvaluationType, MetricSourceType, ServiceLevelIndicatorComparisonOperator, ServiceLevelIndicatorMetricType, ServiceLevelObjectiveBudgetStatus, Severity, StandardUnit } from "./enums";
 /**
  * @public
  */
@@ -669,27 +669,27 @@ export interface MetricReference {
     AccountId?: string | undefined;
 }
 /**
- * <p>Represents a logical grouping of services based on shared attributes or characteristics.</p>
+ * <p>A structure that represents a logical grouping of services based on shared attributes such as business unit, environment, or entry point.</p>
  * @public
  */
 export interface ServiceGroup {
     /**
-     * <p>The name of the group, such as "Environment", "Team", or "Application".</p>
+     * <p>The name of the grouping attribute, such as <code>BusinessUnit</code> or <code>Environment</code>.</p>
      * @public
      */
     GroupName: string | undefined;
     /**
-     * <p>The specific value for this group, such as "Production", "TeamA", or "WebApp".</p>
+     * <p>The value of the grouping attribute for this service, such as <code>Payments</code> or <code>Production</code>.</p>
      * @public
      */
     GroupValue: string | undefined;
     /**
-     * <p>The source of the grouping information, such as "Tag", "Attribute", or "Manual".</p>
+     * <p>The source of the grouping attribute, such as <code>TAG</code>, <code>OTEL</code>, or <code>DEFAULT</code>.</p>
      * @public
      */
     GroupSource: string | undefined;
     /**
-     * <p>A unique identifier for the group within the grouping configuration.</p>
+     * <p>A unique identifier for this grouping attribute value, used for filtering and API operations.</p>
      * @public
      */
     GroupIdentifier: string | undefined;
@@ -710,7 +710,7 @@ export interface Service {
      */
     AttributeMaps?: Record<string, string>[] | undefined;
     /**
-     * <p>An array of service groups that this service belongs to, based on the configured grouping rules.</p>
+     * <p>An array of service groups that this service belongs to, based on the configured grouping attributes.</p>
      * @public
      */
     ServiceGroups?: ServiceGroup[] | undefined;
@@ -751,7 +751,7 @@ export interface GetServiceOutput {
     LogGroupReferences?: Record<string, string>[] | undefined;
 }
 /**
- * <p>Represents a CloudWatch Synthetics canary that can be audited for performance and configuration issues.</p>
+ * <p>A structure that contains identifying information for a CloudWatch Synthetics canary entity used in audit targeting.</p>
  * @public
  */
 export interface CanaryEntity {
@@ -762,33 +762,33 @@ export interface CanaryEntity {
     CanaryName: string | undefined;
 }
 /**
- * <p>Represents a service entity that is monitored by Application Signals.</p>
+ * <p>A structure that contains identifying information for a service entity.</p>
  * @public
  */
 export interface ServiceEntity {
     /**
-     * <p>The type of service, such as "WebService", "Database", "Queue", or "Function".</p>
+     * <p>The type of the service entity.</p>
      * @public
      */
     Type?: string | undefined;
     /**
-     * <p>The name of the service as identified by Application Signals.</p>
+     * <p>The name of the service.</p>
      * @public
      */
     Name?: string | undefined;
     /**
-     * <p>The environment where the service is deployed, such as "Production", "Staging", or "Development".</p>
+     * <p>The environment where the service is deployed.</p>
      * @public
      */
     Environment?: string | undefined;
     /**
-     * <p>The AWS account ID where the service is deployed.</p>
+     * <p>The Amazon Web Services account ID where the service is located. Provide this value only for cross-account access.</p>
      * @public
      */
     AwsAccountId?: string | undefined;
 }
 /**
- * <p>Represents a specific operation within a service that can be monitored and audited independently.</p>
+ * <p>A structure that contains identifying information for a service operation entity.</p>
  * @public
  */
 export interface ServiceOperationEntity {
@@ -798,34 +798,34 @@ export interface ServiceOperationEntity {
      */
     Service?: ServiceEntity | undefined;
     /**
-     * <p>The name of the specific operation within the service.</p>
+     * <p>The name of the operation.</p>
      * @public
      */
     Operation?: string | undefined;
     /**
-     * <p>The type of metric associated with this service operation, such as "Latency", "ErrorRate", or "Throughput".</p>
+     * <p>The type of metric associated with this service operation.</p>
      * @public
      */
     MetricType?: string | undefined;
 }
 /**
- * <p>Represents a Service Level Objective (SLO) entity that can be audited for compliance and performance.</p>
+ * <p>A structure that contains identifying information for a service level objective entity.</p>
  * @public
  */
 export interface ServiceLevelObjectiveEntity {
     /**
-     * <p>The name of the Service Level Objective.</p>
+     * <p>The name of the service level objective.</p>
      * @public
      */
     SloName?: string | undefined;
     /**
-     * <p>The Amazon Resource Name (ARN) of the Service Level Objective.</p>
+     * <p>The ARN of the service level objective. The SLO must be provided with ARN for cross-account access.</p>
      * @public
      */
     SloArn?: string | undefined;
 }
 /**
- * <p>A union type that represents different types of entities that can be audited, such as services, SLOs, service operations, or canaries.</p>
+ * <p>A union structure that contains the specific entity information for different types of audit targets.</p>
  * @public
  */
 export type AuditTargetEntity = AuditTargetEntity.CanaryMember | AuditTargetEntity.ServiceMember | AuditTargetEntity.ServiceOperationMember | AuditTargetEntity.SloMember | AuditTargetEntity.$UnknownMember;
@@ -845,7 +845,7 @@ export declare namespace AuditTargetEntity {
         $unknown?: never;
     }
     /**
-     * <p>Service Level Objective entity information when the audit target is an SLO.</p>
+     * <p>SLO entity information when the audit target is a service level objective.</p>
      * @public
      */
     interface SloMember {
@@ -856,7 +856,7 @@ export declare namespace AuditTargetEntity {
         $unknown?: never;
     }
     /**
-     * <p>Service operation entity information when the audit target is a specific operation within a service.</p>
+     * <p>Service operation entity information when the audit target is a specific service operation.</p>
      * @public
      */
     interface ServiceOperationMember {
@@ -900,17 +900,17 @@ export declare namespace AuditTargetEntity {
     }
 }
 /**
- * <p>Specifies a target resource for auditing, such as a service, SLO, or operation.</p>
+ * <p>A structure that specifies the target entity for audit analysis, such as a <code>service</code>, <code>SLO</code>, <code>service_operation</code>, or <code>canary</code>.</p>
  * @public
  */
 export interface AuditTarget {
     /**
-     * <p>The type of resource being targeted for audit, such as "Service", "SLO", "ServiceOperation", or "Canary".</p>
+     * <p>The type of entity being audited, such as <code>service</code>, <code>SLO</code>, <code>service_operation</code>, or <code>canary</code>. </p>
      * @public
      */
     Type: string | undefined;
     /**
-     * <p>The specific data or entity information for the audit target, containing details needed to identify and examine the resource.</p>
+     * <p>The specific data identifying the audit target entity.</p>
      * @public
      */
     Data: AuditTargetEntity | undefined;
@@ -920,193 +920,203 @@ export interface AuditTarget {
  */
 export interface ListAuditFindingsInput {
     /**
-     * <p>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.</p>
+     * <p>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, <code>1698778057</code> </p>
      * @public
      */
     StartTime: Date | undefined;
     /**
-     * <p>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.</p>
+     * <p>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, <code>1698778057</code> </p>
      * @public
      */
     EndTime: Date | undefined;
     /**
-     * <p>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.</p>
+     * <p>A list of auditor names to filter the findings by. Only findings generated by the specified auditors will be returned.</p> <p>The following auditors are available for configuration:</p> <ul> <li> <p> <code>slo</code> - SloAuditor: Identifies SLO violations and detects breached thresholds during the Assessment phase.</p> </li> <li> <p> <code>operation_metric</code> - OperationMetricAuditor: Detects anomalies in service operation metrics from Application Signals RED metrics during the Assessment phase</p> <note> <p>Anomaly detection is not supported for sparse metrics (those missing more than 80% of datapoints within the given time period).</p> </note> </li> <li> <p> <code>service_quota</code> - ServiceQuotaAuditor: Monitors resource utilization against service quotas during the Assessment phase</p> </li> <li> <p> <code>trace</code> - TraceAuditor: Performs deep-dive analysis of distributed traces, correlating traces with breached SLOs or abnormal RED metrics during the Analysis phase</p> </li> <li> <p> <code>dependency_metric</code> - CriticalPathAuditor: Analyzes service dependency impacts and maps dependency relationships from Application Signals RED metrics during the Analysis phase</p> </li> <li> <p> <code>top_contributor</code> - TopContributorAuditor: Identifies infrastructure-level contributors to issues by analyzing EMF logs of Application Signals RED metrics during the Analysis phase</p> </li> <li> <p> <code>log</code> - LogAuditor: Extracts insights from application logs, categorizing error types and ranking severity by frequency during the Analysis phase</p> </li> </ul> <note> <p> <code>InitAuditor</code> and <code>Summarizer</code> auditors are not configurable as they are automatically triggered during the audit process.</p> </note>
      * @public
      */
     Auditors?: string[] | undefined;
     /**
-     * <p>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.</p>
+     * <p>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.</p>
      * @public
      */
     AuditTargets: AuditTarget[] | undefined;
     /**
-     * <p>The token for the next set of results. Use this token to retrieve additional pages of audit findings when the result set is large.</p>
+     * <p>The level of details of the audit findings. Supported values: <code>BRIEF</code>, <code>DETAILED</code>.</p>
+     * @public
+     */
+    DetailLevel?: DetailLevel | undefined;
+    /**
+     * <p>Include this value, if it was returned by the previous operation, to get the next set of audit findings.</p>
      * @public
      */
     NextToken?: string | undefined;
     /**
-     * <p>The maximum number of audit findings to return in a single request. Valid range is 1 to 100. If not specified, defaults to 50.</p>
+     * <p>The maximum number of audit findings to return in one operation. If you omit this parameter, the default of 10 is used.</p>
      * @public
      */
     MaxResults?: number | undefined;
 }
 /**
- * <p>Represents the result of an audit performed by a specific auditor on a resource.</p>
+ * <p>A structure that contains the result of an automated audit analysis, including the auditor name, description of findings, additional data, and severity level.</p>
  * @public
  */
 export interface AuditorResult {
     /**
-     * <p>The name or identifier of the auditor that performed the examination and generated this result.</p>
+     * <p>The name of the auditor algorithm that generated this result.</p>
      * @public
      */
     Auditor?: string | undefined;
     /**
-     * <p>A detailed description of what the auditor found, including any recommendations for remediation or further investigation.</p>
+     * <p>A detailed description of the audit finding, explaining what was observed and potential implications.</p>
      * @public
      */
     Description?: string | undefined;
     /**
-     * <p>The severity level of the finding, such as "Critical", "High", "Medium", or "Low". This helps prioritize remediation efforts.</p>
+     * <p>This is a string-to-string map. It contains additional data about the result of an automated audit analysis.</p>
+     * @public
+     */
+    Data?: Record<string, string> | undefined;
+    /**
+     * <p>The severity level of this audit finding, indicating the importance and potential impact of the issue.</p>
      * @public
      */
     Severity?: Severity | undefined;
 }
 /**
- * <p>Represents a connection between two nodes in a dependency graph, showing how services or components interact with each other.</p>
+ * <p>A structure that represents a connection between two nodes in a dependency graph, showing the relationship and characteristics of the connection.</p>
  * @public
  */
 export interface Edge {
     /**
-     * <p>The identifier of the source node in the dependency relationship.</p>
+     * <p>The identifier of the source node in this edge connection.</p>
      * @public
      */
     SourceNodeId?: string | undefined;
     /**
-     * <p>The identifier of the destination node in the dependency relationship.</p>
+     * <p>The identifier of the destination node in this edge connection.</p>
      * @public
      */
     DestinationNodeId?: string | undefined;
     /**
-     * <p>The typical duration or latency of interactions along this edge, measured in milliseconds.</p>
+     * <p>The duration or latency associated with this connection, if applicable.</p>
      * @public
      */
     Duration?: number | undefined;
     /**
-     * <p>The type of connection between the nodes, such as "HTTP", "Database", "Queue", or "Internal".</p>
+     * <p>The type of connection between the nodes, indicating the nature of the relationship.</p>
      * @public
      */
     ConnectionType?: ConnectionType | undefined;
 }
 /**
- * <p>Represents a node in a dependency graph, typically corresponding to a service or component in your application architecture.</p>
+ * <p>A structure that represents a node in a dependency graph, containing information about a service, resource, or other entity and its characteristics.</p>
  * @public
  */
 export interface Node {
     /**
-     * <p>A map of key attributes that identify and describe the node, such as service name, environment, and other metadata.</p>
+     * <p>The key attributes that identify this node, including Type, Name, and Environment information.</p>
      * @public
      */
     KeyAttributes: Record<string, string> | undefined;
     /**
-     * <p>The display name of the node, typically the service or component name.</p>
+     * <p>The name of the entity represented by this node.</p>
      * @public
      */
     Name: string | undefined;
     /**
-     * <p>A unique identifier for the node within the dependency graph.</p>
+     * <p>A unique identifier for this node within the dependency graph.</p>
      * @public
      */
     NodeId: string | undefined;
     /**
-     * <p>The specific operation or endpoint within the service that this node represents, if applicable.</p>
+     * <p>The operation associated with this node, if applicable.</p>
      * @public
      */
     Operation?: string | undefined;
     /**
-     * <p>The type of node, such as "Service", "Database", "Queue", or "External".</p>
+     * <p>The type of entity represented by this node, such as <code>Service</code> or <code>Resource</code>.</p>
      * @public
      */
     Type?: string | undefined;
     /**
-     * <p>The typical response time or processing duration for this node, measured in milliseconds.</p>
+     * <p>The duration or processing time associated with this node, if applicable.</p>
      * @public
      */
     Duration?: number | undefined;
     /**
-     * <p>The current health status of the node, such as "Healthy", "Warning", or "Critical".</p>
+     * <p>The status of the entity represented by this node.</p>
      * @public
      */
     Status?: string | undefined;
 }
 /**
- * <p>Represents a graph showing the dependencies between services and components in your application architecture.</p>
+ * <p>A structure that represents the dependency relationships relevant to an audit finding, containing nodes and edges that show how services and resources are connected.</p>
  * @public
  */
 export interface DependencyGraph {
     /**
-     * <p>An array of nodes in the dependency graph, where each node represents a service or component.</p>
+     * <p>An array of nodes representing the services, resources, or other entities in the dependency graph.</p>
      * @public
      */
     Nodes?: Node[] | undefined;
     /**
-     * <p>An array of edges in the dependency graph, where each edge represents a connection or dependency between two nodes.</p>
+     * <p>An array of edges representing the connections and relationships between the nodes in the dependency graph.</p>
      * @public
      */
     Edges?: Edge[] | undefined;
 }
 /**
- * <p>Represents a graph of metric data over time, showing performance trends and patterns for monitored resources.</p>
+ * <p>A structure that contains metric data queries and time range information that provides context for audit findings through relevant performance metrics.</p>
  * @public
  */
 export interface MetricGraph {
     /**
-     * <p>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.</p>
+     * <p>An array of metric data queries that define the metrics to be retrieved and analyzed as part of the audit finding context.</p>
      * @public
      */
     MetricDataQueries?: MetricDataQuery[] | undefined;
     /**
-     * <p>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.</p>
+     * <p>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.</p>
      * @public
      */
     StartTime?: Date | undefined;
     /**
-     * <p>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.</p>
+     * <p>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.</p>
      * @public
      */
     EndTime?: Date | undefined;
 }
 /**
- * <p>Represents an audit finding that identifies a potential issue, misconfiguration, or compliance violation in Application Signals resources.</p>
+ * <p>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.</p>
  * @public
  */
 export interface AuditFinding {
     /**
-     * <p>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.</p>
+     * <p>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.</p>
      * @public
      */
     KeyAttributes: Record<string, string> | undefined;
     /**
-     * <p>An array of results from different auditors that examined the resource. Each result includes the auditor name, description, and severity level.</p>
+     * <p>An array of auditor results that contain the specific findings, descriptions, and severity levels identified by different auditing algorithms.</p>
      * @public
      */
     AuditorResults?: AuditorResult[] | undefined;
     /**
-     * <p>The operation or action that was being audited when this finding was discovered. This provides context about what was being examined.</p>
+     * <p>The name of the operation associated with this audit finding, if the finding is specific to a particular service operation.</p>
      * @public
      */
     Operation?: string | undefined;
     /**
-     * <p>A metric graph associated with the audit finding, showing relevant performance data that may be related to the identified issue.</p>
+     * <p>A structure containing metric data queries and time range information that provides context for the audit finding through relevant performance metrics.</p>
      * @public
      */
     MetricGraph?: MetricGraph | undefined;
     /**
-     * <p>A dependency graph showing the relationships between services that may be affected by or related to the audit finding.</p>
+     * <p>A structure containing nodes and edges that represent the dependency relationships relevant to this audit finding, helping to understand the context and potential impact.</p>
      * @public
      */
     DependencyGraph?: DependencyGraph | undefined;
     /**
-     * <p>The type or category of the audit finding, such as "Performance", "Security", or "Configuration".</p>
+     * <p>The type of audit finding.</p>
      * @public
      */
     Type?: string | undefined;
@@ -1116,12 +1126,123 @@ export interface AuditFinding {
  */
 export interface ListAuditFindingsOutput {
     /**
-     * <p>An array of audit findings that match the specified criteria. Each finding includes details about the issue, affected resources, and auditor results.</p>
+     * <p>The start of the time period that the returned audit findings apply to. When used in a raw HTTP Query API, it is formatted as epoch time in seconds. For example, <code>1698778057</code> </p>
+     * @public
+     */
+    StartTime?: Date | undefined;
+    /**
+     * <p>The end of the time period that the returned audit findings apply to. When used in a raw HTTP Query API, it is formatted as epoch time in seconds. For example, <code>1698778057</code> </p>
+     * @public
+     */
+    EndTime?: Date | undefined;
+    /**
+     * <p>An array of structures, where each structure contains information about one audit finding, including the auditor results, severity, and associated metric and dependency graphs.</p>
      * @public
      */
     AuditFindings: AuditFinding[] | undefined;
     /**
-     * <p>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.</p>
+     * <p>Include this value in your next use of this API to get the next set of audit findings.</p>
+     * @public
+     */
+    NextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListEntityEventsInput {
+    /**
+     * <p>The entity for which to retrieve change events. This specifies the service, resource, or other entity whose event history you want to examine.</p> <p>This is a string-to-string map. It can include the following fields.</p> <ul> <li> <p> <code>Type</code> designates the type of object this is.</p> </li> <li> <p> <code>ResourceType</code> specifies the type of the resource. This field is used only when the value of the <code>Type</code> field is <code>Resource</code> or <code>AWS::Resource</code>.</p> </li> <li> <p> <code>Name</code> specifies the name of the object. This is used only if the value of the <code>Type</code> field is <code>Service</code>, <code>RemoteService</code>, or <code>AWS::Service</code>.</p> </li> <li> <p> <code>Identifier</code> identifies the resource objects of this resource. This is used only if the value of the <code>Type</code> field is <code>Resource</code> or <code>AWS::Resource</code>.</p> </li> <li> <p> <code>Environment</code> specifies the location where this object is hosted, or what it belongs to.</p> </li> <li> <p> <code>AwsAccountId</code> specifies the account where this object is in.</p> </li> </ul> <p>Below is an example of a service.</p> <p> <code>\{ "Type": "Service", "Name": "visits-service", "Environment": "petclinic-test" \}</code> </p> <p>Below is an example of a resource.</p> <p> <code>\{ "Type": "AWS::Resource", "ResourceType": "AWS::DynamoDB::Table", "Identifier": "Customers" \}</code> </p>
+     * @public
+     */
+    Entity: Record<string, string> | undefined;
+    /**
+     * <p>The start of the time period to retrieve change events for. When used in a raw HTTP Query API, it is formatted as epoch time in seconds. For example: <code>1698778057</code> </p>
+     * @public
+     */
+    StartTime: Date | undefined;
+    /**
+     * <p>The end of the time period to retrieve change events for. When used in a raw HTTP Query API, it is formatted as epoch time in seconds. For example: <code>1698778057</code> </p>
+     * @public
+     */
+    EndTime: Date | undefined;
+    /**
+     * <p>The maximum number of change events to return in one operation. If you omit this parameter, the default of 50 is used.</p>
+     * @public
+     */
+    MaxResults?: number | undefined;
+    /**
+     * <p>Include this value, if it was returned by the previous operation, to get the next set of change events.</p>
+     * @public
+     */
+    NextToken?: string | undefined;
+}
+/**
+ * <p>A structure that contains information about a change event that occurred for a service, such as a deployment or configuration change.</p>
+ * @public
+ */
+export interface ChangeEvent {
+    /**
+     * <p>The timestamp when this change event occurred. When used in a raw HTTP Query API, it is formatted as epoch time in seconds.</p>
+     * @public
+     */
+    Timestamp: Date | undefined;
+    /**
+     * <p>The Amazon Web Services account ID where this change event occurred.</p>
+     * @public
+     */
+    AccountId: string | undefined;
+    /**
+     * <p>The Amazon Web Services region where this change event occurred.</p>
+     * @public
+     */
+    Region: string | undefined;
+    /**
+     * <p>The entity (service or resource) that was affected by this change event, including its key attributes.</p> <p>This is a string-to-string map. It can include the following fields.</p> <ul> <li> <p> <code>Type</code> designates the type of object this is.</p> </li> <li> <p> <code>ResourceType</code> specifies the type of the resource. This field is used only when the value of the <code>Type</code> field is <code>Resource</code> or <code>AWS::Resource</code>.</p> </li> <li> <p> <code>Name</code> specifies the name of the object. This is used only if the value of the <code>Type</code> field is <code>Service</code>, <code>RemoteService</code>, or <code>AWS::Service</code>.</p> </li> <li> <p> <code>Identifier</code> identifies the resource objects of this resource. This is used only if the value of the <code>Type</code> field is <code>Resource</code> or <code>AWS::Resource</code>.</p> </li> <li> <p> <code>Environment</code> specifies the location where this object is hosted, or what it belongs to.</p> </li> <li> <p> <code>AwsAccountId</code> specifies the account where this object is in.</p> </li> </ul> <p>Below is an example of a service.</p> <p> <code>\{ "Type": "Service", "Name": "visits-service", "Environment": "petclinic-test" \}</code> </p> <p>Below is an example of a resource.</p> <p> <code>\{ "Type": "AWS::Resource", "ResourceType": "AWS::DynamoDB::Table", "Identifier": "Customers" \}</code> </p>
+     * @public
+     */
+    Entity: Record<string, string> | undefined;
+    /**
+     * <p>The type of change event that occurred, such as <code>DEPLOYMENT</code>.</p>
+     * @public
+     */
+    ChangeEventType: ChangeEventType | undefined;
+    /**
+     * <p>A unique identifier for this change event. For CloudTrail-based events, this is the CloudTrail event id. For other events, this will be <code>Unknown</code>.</p>
+     * @public
+     */
+    EventId: string | undefined;
+    /**
+     * <p>The name of the user who initiated this change event, if available.</p>
+     * @public
+     */
+    UserName?: string | undefined;
+    /**
+     * <p>The name or description of this change event.</p>
+     * @public
+     */
+    EventName?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListEntityEventsOutput {
+    /**
+     * <p>The start of the time period that the returned change events apply to. When used in a raw HTTP Query API, it is formatted as epoch time in seconds. For example: <code>1698778057</code> </p>
+     * @public
+     */
+    StartTime: Date | undefined;
+    /**
+     * <p>The end of the time period that the returned change events apply to. When used in a raw HTTP Query API, it is formatted as epoch time in seconds. For example: <code>1698778057</code> </p>
+     * @public
+     */
+    EndTime: Date | undefined;
+    /**
+     * <p>An array of structures, where each structure contains information about one change event that occurred for the specified entity during the requested time period.</p>
+     * @public
+     */
+    ChangeEvents: ChangeEvent[] | undefined;
+    /**
+     * <p>Include this value in your next use of this API to get the next set of change events.</p>
      * @public
      */
     NextToken?: string | undefined;
@@ -1131,28 +1252,38 @@ export interface ListAuditFindingsOutput {
  */
 export interface ListGroupingAttributeDefinitionsInput {
     /**
-     * <p>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.</p>
+     * <p>Include this value, if it was returned by the previous operation, to get the next set of grouping attribute definitions.</p>
      * @public
      */
     NextToken?: string | undefined;
+    /**
+     * <p>The Amazon Web Services account ID to retrieve grouping attribute definitions for. Use this when accessing grouping configurations from a different account in cross-account monitoring scenarios.</p>
+     * @public
+     */
+    AwsAccountId?: string | undefined;
+    /**
+     * <p>If you are using this operation in a monitoring account, specify <code>true</code> to include grouping attributes from source accounts in the returned data.</p>
+     * @public
+     */
+    IncludeLinkedAccounts?: boolean | undefined;
 }
 /**
- * <p>Defines how services should be grouped based on specific attributes. This allows logical organization of services in dashboards and service maps.</p>
+ * <p>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.</p>
  * @public
  */
 export interface GroupingAttributeDefinition {
     /**
-     * <p>The name of the grouping attribute, such as "Environment", "Team", or "Application".</p>
+     * <p>The friendly name for this grouping attribute, such as <code>BusinessUnit</code> or <code>Environment</code>. This name is used to identify the grouping in the console and APIs.</p>
      * @public
      */
     GroupingName: string | undefined;
     /**
-     * <p>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.</p>
+     * <p>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.</p>
      * @public
      */
     GroupingSourceKeys?: string[] | undefined;
     /**
-     * <p>The default value to use for grouping when a service doesn't have any of the specified source keys, such as "Unknown" or "Unassigned".</p>
+     * <p>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.</p>
      * @public
      */
     DefaultGroupingValue?: string | undefined;
@@ -1162,17 +1293,17 @@ export interface GroupingAttributeDefinition {
  */
 export interface ListGroupingAttributeDefinitionsOutput {
     /**
-     * <p>An array of available grouping attribute definitions that can be used to create grouping configurations.</p>
+     * <p>An array of structures, where each structure contains information about one grouping attribute definition, including the grouping name, source keys, and default values.</p>
      * @public
      */
     GroupingAttributeDefinitions: GroupingAttributeDefinition[] | undefined;
     /**
-     * <p>The timestamp when the grouping attribute definitions were last updated. Expressed as the number of milliseconds since January 1, 1970, 00:00:00 UTC.</p>
+     * <p>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.</p>
      * @public
      */
     UpdatedAt?: Date | undefined;
     /**
-     * <p>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.</p>
+     * <p>Include this value in your next use of this API to get the next set of grouping attribute definitions.</p>
      * @public
      */
     NextToken?: string | undefined;
@@ -1501,7 +1632,7 @@ export interface ServiceSummary {
      */
     MetricReferences: MetricReference[] | undefined;
     /**
-     * <p>An array of service groups that this service belongs to, providing a summary view of the service's organizational context.</p>
+     * <p>An array of service groups that this service belongs to, based on the configured grouping attributes.</p>
      * @public
      */
     ServiceGroups?: ServiceGroup[] | undefined;
@@ -1532,17 +1663,17 @@ export interface ListServicesOutput {
     NextToken?: string | undefined;
 }
 /**
- * <p>Represents a filter for service attributes. Used to narrow down results based on specific attribute names and values.</p>
+ * <p>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.</p>
  * @public
  */
 export interface AttributeFilter {
     /**
-     * <p>The name of the attribute to filter on. This corresponds to service metadata attributes such as environment, team, or custom tags.</p>
+     * <p>The name of the attribute to filter by, such as <code>Platform</code>, <code>Environment</code>, or <code>BusinessUnit</code>.</p>
      * @public
      */
     AttributeFilterName: string | undefined;
     /**
-     * <p>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.</p>
+     * <p>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.</p>
      * @public
      */
     AttributeFilterValues: string[] | undefined;
@@ -1552,104 +1683,58 @@ export interface AttributeFilter {
  */
 export interface ListServiceStatesInput {
     /**
-     * <p>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.</p>
+     * <p>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, <code>1698778057</code>.</p>
      * @public
      */
     StartTime: Date | undefined;
     /**
-     * <p>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.</p>
+     * <p>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, <code>1698778057</code>.</p>
      * @public
      */
     EndTime: Date | undefined;
     /**
-     * <p>The maximum number of service states to return in a single request. Valid range is 1 to 100. If not specified, defaults to 50.</p>
+     * <p>The maximum number of service states to return in one operation. If you omit this parameter, the default of 20 is used.</p>
      * @public
      */
     MaxResults?: number | undefined;
     /**
-     * <p>The token for the next set of results. Use this token to retrieve additional pages of service states when the result set is large.</p>
+     * <p>Include this value, if it was returned by the previous operation, to get the next set of service states.</p>
      * @public
      */
     NextToken?: string | undefined;
     /**
-     * <p>Specifies whether to include service states from linked AWS accounts in the results. Set to <code>true</code> to include linked accounts, or <code>false</code> to only include the current account. Defaults to <code>false</code>.</p>
+     * <p>If you are using this operation in a monitoring account, specify <code>true</code> to include service states from source accounts in the returned data.</p>
      * @public
      */
     IncludeLinkedAccounts?: boolean | undefined;
     /**
-     * <p>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.</p>
+     * <p>The Amazon Web Services account ID to filter service states by. Use this to limit results to services from a specific account.</p>
      * @public
      */
     AwsAccountId?: string | undefined;
     /**
-     * <p>An array of attribute filters to narrow down the service states returned. Each filter specifies an attribute name and the values to match against.</p>
+     * <p>A list of attribute filters to narrow down the services. You can filter by platform, environment, or other service attributes.</p>
      * @public
      */
     AttributeFilters?: AttributeFilter[] | undefined;
 }
 /**
- * <p>Represents a change event that occurred in the system, such as deployments, configuration changes, or other operational events that may impact service performance.</p>
- * @public
- */
-export interface ChangeEvent {
-    /**
-     * <p>The timestamp when the change event occurred, expressed as the number of milliseconds since January 1, 1970, 00:00:00 UTC.</p>
-     * @public
-     */
-    Timestamp: Date | undefined;
-    /**
-     * <p>The AWS account ID where the change event occurred.</p>
-     * @public
-     */
-    AccountId: string | undefined;
-    /**
-     * <p>The AWS region where the change event occurred.</p>
-     * @public
-     */
-    Region: string | undefined;
-    /**
-     * <p>The entity or resource that was changed, such as a service, deployment, or configuration.</p>
-     * @public
-     */
-    Entity: Record<string, string> | undefined;
-    /**
-     * <p>The type of change that occurred, such as "Deployment", "Configuration", or "Infrastructure".</p>
-     * @public
-     */
-    ChangeEventType: ChangeEventType | undefined;
-    /**
-     * <p>A unique identifier for the change event.</p>
-     * @public
-     */
-    EventId: string | undefined;
-    /**
-     * <p>The name of the user or system that initiated the change event.</p>
-     * @public
-     */
-    UserName?: string | undefined;
-    /**
-     * <p>A descriptive name for the change event that provides context about what changed.</p>
-     * @public
-     */
-    EventName?: string | undefined;
-}
-/**
- * <p>Represents the current state and health information for a service monitored by Application Signals.</p>
+ * <p>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.</p>
  * @public
  */
 export interface ServiceState {
     /**
-     * <p>The attribute filters that were applied when retrieving this service state.</p>
+     * <p>The attribute filters that were applied when retrieving this service state information.</p>
      * @public
      */
     AttributeFilters?: AttributeFilter[] | undefined;
     /**
-     * <p>The service entity information for this service state.</p>
+     * <p>The key attributes that identify this service, including Type, Name, and Environment information.</p>
      * @public
      */
     Service: Record<string, string> | undefined;
     /**
-     * <p>An array of the most recent change events that may have affected this service, such as deployments or configuration changes.</p>
+     * <p>An array containing the most recent change events for this service, such as deployments, with information about when they occurred and who initiated them.</p>
      * @public
      */
     LatestChangeEvents: ChangeEvent[] | undefined;
@@ -1659,22 +1744,22 @@ export interface ServiceState {
  */
 export interface ListServiceStatesOutput {
     /**
-     * <p>The start time of the query range, expressed as the number of milliseconds since January 1, 1970, 00:00:00 UTC.</p>
+     * <p>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, <code>1698778057</code>.</p>
      * @public
      */
     StartTime: Date | undefined;
     /**
-     * <p>The end time of the query range, expressed as the number of milliseconds since January 1, 1970, 00:00:00 UTC.</p>
+     * <p>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, <code>1698778057</code>.</p>
      * @public
      */
     EndTime: Date | undefined;
     /**
-     * <p>An array of service state objects that match the specified criteria. Each service state includes current status, recent change events, and service metadata.</p>
+     * <p>An array of structures, where each structure contains information about the state of one service, including its latest change events such as deployments.</p>
      * @public
      */
     ServiceStates: ServiceState[] | undefined;
     /**
-     * <p>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.</p>
+     * <p>Include this value in your next use of this API to get the next set of service states.</p>
      * @public
      */
     NextToken?: string | undefined;
@@ -1720,23 +1805,23 @@ export interface ListTagsForResourceResponse {
  */
 export interface PutGroupingConfigurationInput {
     /**
-     * <p>An array of grouping attribute definitions that specify how services should be grouped. Each definition includes the grouping name, source keys, and default values.</p>
+     * <p>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.</p>
      * @public
      */
     GroupingAttributeDefinitions: GroupingAttributeDefinition[] | undefined;
 }
 /**
- * <p>Contains the complete configuration for how services are grouped and organized in Application Signals.</p>
+ * <p>A structure that contains the complete grouping configuration for an account, including all defined grouping attributes and metadata about when it was last updated.</p>
  * @public
  */
 export interface GroupingConfiguration {
     /**
-     * <p>An array of grouping attribute definitions that specify the rules for organizing services into groups.</p>
+     * <p>An array of grouping attribute definitions that specify how services should be grouped based on various attributes and source keys.</p>
      * @public
      */
     GroupingAttributeDefinitions: GroupingAttributeDefinition[] | undefined;
     /**
-     * <p>The timestamp when the grouping configuration was last updated, expressed as the number of milliseconds since January 1, 1970, 00:00:00 UTC.</p>
+     * <p>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.</p>
      * @public
      */
     UpdatedAt: Date | undefined;
@@ -1746,7 +1831,7 @@ export interface GroupingConfiguration {
  */
 export interface PutGroupingConfigurationOutput {
     /**
-     * <p>The created or updated grouping configuration, including all attribute definitions and metadata such as the update timestamp.</p>
+     * <p>A structure containing the updated grouping configuration, including all grouping attribute definitions and the timestamp when it was last updated.</p>
      * @public
      */
     GroupingConfiguration: GroupingConfiguration | undefined;
@@ -1840,7 +1925,7 @@ export interface ServiceLevelIndicatorMetricConfig {
      */
     MetricType?: ServiceLevelIndicatorMetricType | undefined;
     /**
-     * <p>The name of the CloudWatch metric used as a service level indicator (SLI) for measuring service performance.</p>
+     * <p>The name of the CloudWatch metric to use for the SLO, when using a custom metric rather than Application Signals standard metrics.</p>
      * @public
      */
     MetricName?: string | undefined;