2024/06/13 - AWS IoT Wireless - 1 updated api methods
Changes Add RoamingDeviceSNR and RoamingDeviceRSSI to Customer Metrics.
{'SummaryMetricQueries': {'MetricName': {'DeviceRoamingRSSI',
'DeviceRoamingSNR'}}}
Response {'SummaryMetricQueryResults': {'MetricName': {'DeviceRoamingRSSI',
'DeviceRoamingSNR'}}}
Get the summary metrics for this AWS account.
See also: AWS API Documentation
Request Syntax
client.get_metrics(
SummaryMetricQueries=[
{
'QueryId': 'string',
'MetricName': 'DeviceRSSI'|'DeviceSNR'|'DeviceRoamingRSSI'|'DeviceRoamingSNR'|'DeviceUplinkCount'|'DeviceDownlinkCount'|'DeviceUplinkLostCount'|'DeviceUplinkLostRate'|'DeviceJoinRequestCount'|'DeviceJoinAcceptCount'|'DeviceRoamingUplinkCount'|'DeviceRoamingDownlinkCount'|'GatewayUpTime'|'GatewayDownTime'|'GatewayRSSI'|'GatewaySNR'|'GatewayUplinkCount'|'GatewayDownlinkCount'|'GatewayJoinRequestCount'|'GatewayJoinAcceptCount'|'AwsAccountUplinkCount'|'AwsAccountDownlinkCount'|'AwsAccountUplinkLostCount'|'AwsAccountUplinkLostRate'|'AwsAccountJoinRequestCount'|'AwsAccountJoinAcceptCount'|'AwsAccountRoamingUplinkCount'|'AwsAccountRoamingDownlinkCount'|'AwsAccountDeviceCount'|'AwsAccountGatewayCount'|'AwsAccountActiveDeviceCount'|'AwsAccountActiveGatewayCount',
'Dimensions': [
{
'name': 'DeviceId'|'GatewayId',
'value': 'string'
},
],
'AggregationPeriod': 'OneHour'|'OneDay'|'OneWeek',
'StartTimestamp': datetime(2015, 1, 1),
'EndTimestamp': datetime(2015, 1, 1)
},
]
)
list
The list of queries to retrieve the summary metrics.
(dict) --
The summary metric query object.
QueryId (string) --
The id of the summary metric query.
MetricName (string) --
The name of the metric.
Dimensions (list) --
The dimensions of the summary metric.
(dict) --
The required list of dimensions for the metric.
name (string) --
The name of the dimension.
value (string) --
The dimension's value.
AggregationPeriod (string) --
The aggregation period of the summary metric.
StartTimestamp (datetime) --
The start timestamp for the summary metric query.
EndTimestamp (datetime) --
The end timestamp for the summary metric query.
dict
Response Syntax
{
'SummaryMetricQueryResults': [
{
'QueryId': 'string',
'QueryStatus': 'Succeeded'|'Failed',
'Error': 'string',
'MetricName': 'DeviceRSSI'|'DeviceSNR'|'DeviceRoamingRSSI'|'DeviceRoamingSNR'|'DeviceUplinkCount'|'DeviceDownlinkCount'|'DeviceUplinkLostCount'|'DeviceUplinkLostRate'|'DeviceJoinRequestCount'|'DeviceJoinAcceptCount'|'DeviceRoamingUplinkCount'|'DeviceRoamingDownlinkCount'|'GatewayUpTime'|'GatewayDownTime'|'GatewayRSSI'|'GatewaySNR'|'GatewayUplinkCount'|'GatewayDownlinkCount'|'GatewayJoinRequestCount'|'GatewayJoinAcceptCount'|'AwsAccountUplinkCount'|'AwsAccountDownlinkCount'|'AwsAccountUplinkLostCount'|'AwsAccountUplinkLostRate'|'AwsAccountJoinRequestCount'|'AwsAccountJoinAcceptCount'|'AwsAccountRoamingUplinkCount'|'AwsAccountRoamingDownlinkCount'|'AwsAccountDeviceCount'|'AwsAccountGatewayCount'|'AwsAccountActiveDeviceCount'|'AwsAccountActiveGatewayCount',
'Dimensions': [
{
'name': 'DeviceId'|'GatewayId',
'value': 'string'
},
],
'AggregationPeriod': 'OneHour'|'OneDay'|'OneWeek',
'StartTimestamp': datetime(2015, 1, 1),
'EndTimestamp': datetime(2015, 1, 1),
'Timestamps': [
datetime(2015, 1, 1),
],
'Values': [
{
'Min': 123.0,
'Max': 123.0,
'Sum': 123.0,
'Avg': 123.0,
'Std': 123.0,
'P90': 123.0
},
],
'Unit': 'string'
},
]
}
Response Structure
(dict) --
SummaryMetricQueryResults (list) --
The list of summary metrics that were retrieved.
(dict) --
The result of the summary metrics aggregation operation.
QueryId (string) --
The ID of the summary metric results query operation.
QueryStatus (string) --
The status of the summary metric query result.
Error (string) --
The error message for the summary metric query result.
MetricName (string) --
The name of the summary metric query result.
Dimensions (list) --
The dimensions of the metric.
(dict) --
The required list of dimensions for the metric.
name (string) --
The name of the dimension.
value (string) --
The dimension's value.
AggregationPeriod (string) --
The aggregation period of the metric.
StartTimestamp (datetime) --
The start timestamp for the summary metric query.
EndTimestamp (datetime) --
The end timestamp for the summary metric query.
Timestamps (list) --
The timestamp of each aggregation result.
(datetime) --
Values (list) --
The list of aggregated summary metric query results.
(dict) --
The aggregated values of the metric.
Min (float) --
The minimum of the values of all data points collected during the aggregation period.
Max (float) --
The maximum of the values of all the data points collected during the aggregation period.
Sum (float) --
The sum of the values of all data points collected during the aggregation period.
Avg (float) --
The average of the values of all data points collected during the aggregation period.
Std (float) --
The standard deviation of the values of all data points collected during the aggregation period.
P90 (float) --
The 90th percentile of the values of all data points collected during the aggregation period.
Unit (string) --
The units of measurement to be used for interpreting the aggregation result.