Expand description
Data structures used by operation inputs/outputs.
Modules§
Structs§
- Attribute
Filter 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.
- Audit
Finding 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.
- Audit
Target A structure that specifies the target entity for audit analysis, such as a
service
,SLO
, orservice_operation
.- Auditor
Result A structure that contains the result of an automated audit analysis, including the auditor name, description of findings, and severity level.
- Batch
Update Exclusion Windows Error An array of structures, where each structure includes an error indicating that one of the requests in the array was not valid.
- Burn
Rate Configuration This object defines the length of the look-back window used to calculate one burn rate metric for this SLO. The burn rate measures how fast the service is consuming the error budget, relative to the attainment goal of the SLO. A burn rate of exactly 1 indicates that the SLO goal will be met exactly.
For example, if you specify 60 as the number of minutes in the look-back window, the burn rate is calculated as the following:
burn rate = error rate over the look-back window / (100% - attainment goal percentage)
For more information about burn rates, see Calculate burn rates.
- Calendar
Interval If the interval for this service level objective is a calendar interval, this structure contains the interval specifications.
- Change
Event A structure that contains information about a change event that occurred for a service, such as a deployment or configuration change.
- Dependency
Config Identifies the dependency using the
DependencyKeyAttributes
andDependencyOperationName
.When creating a service dependency SLO, you must specify the
KeyAttributes
of the service, and theDependencyConfig
for the dependency. You can specify theOperationName
of the service, from which it calls the dependency. Alternatively, you can excludeOperationName
and the SLO will monitor all of the service's operations that call the dependency.- Dependency
Graph A structure that represents the dependency relationships relevant to an audit finding, containing nodes and edges that show how services and resources are connected.
- Dimension
A dimension is a name/value pair that is part of the identity of a metric. Because dimensions are part of the unique identifier for a metric, whenever you add a unique name/value pair to one of your metrics, you are creating a new variation of that metric. For example, many Amazon EC2 metrics publish
InstanceId
as a dimension name, and the actual instance ID as the value for that dimension.You can assign up to 30 dimensions to a metric.
- Edge
A structure that represents a connection between two nodes in a dependency graph, showing the relationship and characteristics of the connection.
- Exclusion
Window The core SLO time window exclusion object that includes Window, StartTime, RecurrenceRule, and Reason.
- Goal
This structure contains the attributes that determine the goal of an SLO. This includes the time period for evaluation and the attainment threshold.
- Grouping
Attribute Definition 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.
- Grouping
Configuration A structure that contains the complete grouping configuration for an account, including all defined grouping attributes and metadata about when it was last updated.
- Metric
This structure defines the metric used for a service level indicator, including the metric name, namespace, and dimensions
- Metric
Data Query Use this structure to define a metric or metric math expression that you want to use as for a service level objective.
Each
MetricDataQuery
in theMetricDataQueries
array specifies either a metric to retrieve, or a metric math expression to be performed on retrieved metrics. A singleMetricDataQueries
array can include as many as 20MetricDataQuery
structures in the array. The 20 structures can include as many as 10 structures that contain aMetricStat
parameter to retrieve a metric, and as many as 10 structures that contain theExpression
parameter to perform a math expression. Of thoseExpression
structures, exactly one must have true as the value forReturnData
. The result of this expression used for the SLO.For more information about metric math expressions, see CloudWatchUse metric math.
Within each
MetricDataQuery
object, you must specify eitherExpression
orMetricStat
but not both.- Metric
Graph A structure that contains metric data queries and time range information that provides context for audit findings through relevant performance metrics.
- Metric
Reference This structure contains information about one CloudWatch metric associated with this entity discovered by Application Signals.
- Metric
Stat This structure defines the metric to be used as the service level indicator, along with the statistics, period, and unit.
- Node
A structure that represents a node in a dependency graph, containing information about a service, resource, or other entity and its characteristics.
- Recurrence
Rule The recurrence rule for the SLO time window exclusion .
- Request
Based Service Level Indicator This structure contains information about the performance metric that a request-based SLO monitors.
- Request
Based Service Level Indicator Config This structure specifies the information about the service and the performance metric that a request-based SLO is to monitor.
- Request
Based Service Level Indicator Metric This structure contains the information about the metric that is used for a request-based SLO.
- Request
Based Service Level Indicator Metric Config Use this structure to specify the information for the metric that a period-based SLO will monitor.
- Rolling
Interval If the interval for this SLO is a rolling interval, this structure contains the interval specifications.
- Service
This structure contains information about one of your services that was discovered by Application Signals.
- Service
Dependency This structure contains information about one dependency of this service.
- Service
Dependent This structure contains information about a service dependent that was discovered by Application Signals. A dependent is an entity that invoked the specified service during the provided time range. Dependents include other services, CloudWatch Synthetics canaries, and clients that are instrumented with CloudWatch RUM app monitors.
- Service
Entity A structure that contains identifying information for a service entity.
- Service
Group A structure that represents a logical grouping of services based on shared attributes such as business unit, environment, or entry point.
- Service
Level Indicator This structure contains information about the performance metric that a period-based SLO monitors.
- Service
Level Indicator Config This structure specifies the information about the service and the performance metric that a period-based SLO is to monitor.
- Service
Level Indicator Metric This structure contains the information about the metric that is used for a period-based SLO.
- Service
Level Indicator Metric Config Use this structure to specify the information for the metric that a period-based SLO will monitor.
- Service
Level Objective A structure containing information about one service level objective (SLO) that has been created in Application Signals. Creating SLOs can help you ensure your services are performing to the level that you expect. SLOs help you set and track a specific target level for the reliability and availability of your applications and services. Each SLO uses a service level indicator (SLI), which is a key performance metric, to calculate how much underperformance can be tolerated before the goal that you set for the SLO is not achieved.
- Service
Level Objective Budget Report A structure containing an SLO budget report that you have requested.
- Service
Level Objective Budget Report Error A structure containing information about one error that occurred during a BatchGetServiceLevelObjectiveBudgetReport operation.
- Service
Level Objective Entity A structure that contains identifying information for a service level objective entity.
- Service
Level Objective Summary A structure that contains information about one service level objective (SLO) created in Application Signals.
- Service
Operation This structure contains information about an operation discovered by Application Signals. An operation is a specific function performed by a service that was discovered by Application Signals, and is often an API that is called by an upstream dependent.
- Service
Operation Entity A structure that contains identifying information for a service operation entity.
- Service
State 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.
- Service
Summary This structure contains information about one of your services that was discovered by Application Signals
- Tag
A key-value pair associated with a resource. Tags can help you organize and categorize your resources.
- Window
The object that defines the time length of an exclusion window.
Enums§
- Audit
Target Entity A union structure that contains the specific entity information for different types of audit targets.
- Change
Event Type - When writing a match expression against
ChangeEventType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Connection
Type - When writing a match expression against
ConnectionType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Duration
Unit - When writing a match expression against
DurationUnit
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Evaluation
Type - When writing a match expression against
EvaluationType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Interval
The time period used to evaluate the SLO. It can be either a calendar interval or rolling interval.
- Metric
Source Type - When writing a match expression against
MetricSourceType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Monitored
Request Count Metric Data Queries This structure defines the metric that is used as the "good request" or "bad request" value for a request-based SLO. This value observed for the metric defined in
TotalRequestCountMetric
is divided by the number found forMonitoredRequestCountMetric
to determine the percentage of successful requests that this SLO tracks.- Service
Level Indicator Comparison Operator - When writing a match expression against
ServiceLevelIndicatorComparisonOperator
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Service
Level Indicator Metric Type - When writing a match expression against
ServiceLevelIndicatorMetricType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Service
Level Objective Budget Status - When writing a match expression against
ServiceLevelObjectiveBudgetStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Severity
- When writing a match expression against
Severity
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Standard
Unit - When writing a match expression against
StandardUnit
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature.