As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Gerenciar métricas de frota

Este tópico mostra como usar o console do AWS IoT e a AWS CLI para gerenciar as métricas da sua frota.

Gerenciar métricas de frota (console)

As seções a seguir mostram como usar o console AWS IoT para gerenciar as métricas da frota. Habilite a indexação de frotas com as fontes de dados e configurações associadas antes de criar métricas de frota.

Habilitar a indexação de frotas

Caso já tenha ativado a indexação de frotas, pule esta seção.

Caso não tenha ativado a indexação de frotas, siga estas instruções.

Criação de uma métrica de frota

Após a criação com êxito, a métrica da frota estará listada na página Métrica da frota.

Atualização de uma métrica de frota

Exclusão de uma métrica de frota

Gerenciar métricas de frota (CLI)

As seções a seguir mostram como usar o AWS CLI para gerenciar as métricas da frota. Habilite a indexação de frotas com as fontes de dados e configurações associadas antes de criar métricas de frota. Para habilitar a indexação de frotas para suas objetos ou grupos de objetos siga as instruções de Gerenciar a indexação de objetos e Gerenciar a indexação de grupos de objetos.

Criação de uma métrica de frota

É possível usar o comando create-fleet-metric da CLI para criar uma métrica de frota.

aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum

A saída deste comando possui o nome e o nome do recurso da Amazon (ARN) da sua métrica de frota. A saída será exibida como a seguir:

{
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "metricName": "YourFleetMetricName"
}

Listagem de métricas de frota

É possível usar o comando list-fleet-metric da CLI para listar todas as métricas de frota da sua conta.

aws iot list-fleet-metrics

A saída deste comando possui todas as métricas de frota. A saída será exibida como a seguir:

{
    "fleetMetrics": [
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric1", 
            "metricName": "YourFleetMetric1"
        }, 
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric2", 
            "metricName": "YourFleetMetric2"
        }
    ]
}

Descrição de uma métrica de frota

É possível usar o comando describe-fleet-metric da CLI para exibir informações mais detalhadas sobre uma métrica de frota.

aws iot describe-fleet-metric --metric-name "YourFleetMetricName"

A saída do comando contém as informações detalhadas sobre a métrica de frota especificada. A saída será exibida como a seguir:

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625790642.355, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "sum"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625790642.355, 
    "metricName": "YourFleetMetricName"
}

Atualização de uma métrica de frota

É possível usar o comando update-fleet-metric da CLI para atualizar uma métrica de frota.

aws iot update-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 120 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum,count --index-name AWS_Things

O comando update-fleet-metric não produz saída alguma. Você pode usar o comando describe-fleet-metric da CLI para ver o resultado.

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625792300.881, 
    "queryString": "*", 
    "period": 120, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 2, 
    "aggregationType": {
        "values": [
            "sum", 
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625792300.881, 
    "metricName": "YourFleetMetricName"
}

Exclusão de uma métrica de frota

Utilize o comando delete-fleet-metric da CLI para excluir uma métrica de frota.

aws iot delete-fleet-metric --metric-name "YourFleetMetricName"

Esse comando não produz saída alguma se a exclusão obtiver êxito ou se você especificar uma métrica de frota inexistente.

Para obter mais informações, consulte Solução de problemas de métricas de frota.

Autorize a marcação de recursos de IoT

Para um controle melhor sobre as métricas da frota que você pode criar, modificar ou usar, você pode anexar tags às métricas da frota.

Para marcar as métricas de frota que você cria usando AWS Management Console ou AWS CLI, inclua a ação iot:TagResource na sua política do IAM para conceder permissões ao usuário. Se sua política do IAM não incluir iot:TagResource, qualquer ação para criar uma métrica de frota com uma tag retornará um erro AccessDeniedException.

Para informações gerais sobre a marcação de recursos, consulte Marcar seus recursos de AWS IoT.

Exemplo de política do IAM

Consulte o seguinte exemplo de políticas do IAM que concedem permissões de marcação ao criar uma métrica da frota:

{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Action": [
				"iot:TagResource"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		},
		{
			"Action": [
				"iot:CreateFleetMetric"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:index/*",
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		}
	]
}

Para obter mais informações, consulte Ações, recursos e chaves de condição do AWS IoT.