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 AWS IoT console e gerenciar AWS CLI as métricas da sua frota.
**Topics**
+ [Gerenciar métricas de frota (console)](#managing-fleet-metrics-console)
+ [Gerenciar métricas de frota (CLI)](#managing-fleet-metrics-cli)
+ [Autorize a marcação de recursos de IoT](#managing-fleet-metrics-policy)
## Gerenciar métricas de frota (console)
As seções a seguir mostram como usar o AWS IoT console para gerenciar as métricas da sua 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.
1. Abra seu AWS IoT console em [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/).
1. No AWS IoT menu, escolha **Configurações**.
1. Para ver as configurações detalhadas, na página **Configurações**, role para baixo até a seção **Indexação de frotas**.
1. Para atualizar suas configurações de indexação de frotas, à direita da seção **Indexação de frotas**, selecione **Gerenciar indexação**.
1. Na página **Gerenciar indexação de frotas**, atualize suas configurações de indexação de frotas conforme suas necessidades.
+ **Configuração**
Para ativar a indexação de objetos, ative a **Indexação de objetos** e selecione as fontes de dados a partir das quais você deseja indexar.
Para ativar a indexação de grupos de objetos, ative a **Indexação de grupos de objetos**.
+ **Campos personalizados para agregação - *opcional***
Os campos personalizados são uma lista de pares de nomes de campos e tipos de campos.
Para adicionar um par de campos personalizado, selecione **Adicionar novo campo**. Insira um nome de campo personalizado, como `attributes.temperature`, e escolha um tipo de campo no menu **Tipo de campo**. Observe que o nome de um campo personalizado começa com `attributes.` e será salvo como um atributo para execução de [consultas de agregações de objetos](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html).
Para atualizar e salvar a configuração, selecione **Atualizar**.
### Criação de uma métrica de frota
1. Abra seu AWS IoT console em [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/).
1. No AWS IoT menu, escolha **Gerenciar** e, em seguida, escolha **Métricas da frota**.
1. Na página **Métricas de frota**, selecione **Criar métrica de frota** e conclua as etapas de criação.
1. Na etapa 1, **Configure as métricas da frota**
+ Na seção **Consulta**, digite uma string de consulta para especificar as objetos ou grupos de objetos com as quais deseja realizar a pesquisa agregada. A string de consulta consiste em um atributo e um valor. Em **Propriedades**, escolha o atributo desejado ou, caso ele não apareça na lista, digite o atributo no campo. Insira o valor depois de `:`. Um exemplo de string de consulta: `thingName:TempSensor*`. Para cada string de consulta inserida, pressione **enter** em seu teclado. Se você inserir diversas strings de consulta, especifique seu relacionamento escolhendo **e**, **ou**, **e não** ou **ou não** entre elas.
+ Em **Propriedades do relatório**, selecione **Nome do índice**, **Tipo de agregação** e **Campo de agregação** em suas respectivas listas. Em sequência, selecione os dados que você deseja agregar em **Selecionar dados**, onde você pode selecionar vários valores de dados.
+ Escolha **Próximo**.
1. Na etapa 2, **Especifique as propriedades métricas da frota**
+ No campo **Nome da métrica da frota**, digite um nome para a métrica da frota em criação.
+ No campo **Descrição - *opcional***, digite uma descrição para a métrica da frota em criação. Esse campo é opcional.
+ Nos campos **Horas** e **Minutos**, insira a hora (com que frequência) você deseja que a métrica da frota emita dados. CloudWatch
+ Escolha **Próximo**.
1. Na etapa 3, **Revise e crie**
+ Revise as configurações da etapa 1 e etapa 2. Para editar as configurações, escolha **Editar**.
+ Selecione **Criar 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
1. Na página **Métrica da frota**, selecione a métrica da frota que você quer atualizar.
1. Na página **Detalhes** da métrica de frota, selecione **Editar**. Isso abre as etapas de criação nas quais você pode atualizar sua métrica de frota em qualquer uma das três etapas.
1. Depois de terminar de atualizar a métrica da frota, selecione **Atualizar métrica da frota**.
### Exclusão de uma métrica de frota
1. Na página **Métrica de frota**, selecione a métrica de frota que você quer excluir.
1. Na próxima página, que exibe detalhes da métrica da sua frota, selecione **Excluir**.
1. Na caixa de diálogo, digite o nome da métrica de frota para confirmar a exclusão.
1. Selecione **Excluir**. Essa etapa exclui permanentemente a métrica de frota.
## Gerenciar métricas de frota (CLI)
As seções a seguir mostram como usar o AWS CLI para gerenciar suas métricas de 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](managing-index.md#enable-index) e [Gerenciar a indexação de grupos de objetos](thinggroup-index.md#enable-group-index).
### Criação de uma métrica de frota
Você pode usar o comando create-fleet-metric 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
Você pode usar o comando list-fleet-metric CLI para listar todas as métricas da frota em 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
Você pode usar o comando describe-fleet-metric 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
Você pode usar o comando update-fleet-metric 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. Você pode usar o comando describe-fleet-metric 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
Use o comando delete-fleet-metric 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](fleet-indexing-troubleshooting.md#fleet-metrics-troubleshooting).
## 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 Console de gerenciamento da AWS ou AWS CLI, você deve incluir a `iot:TagResource` ação 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](https://docs.aws.amazon.com//iot/latest/developerguide/tagging-iot.html).
### 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](https://docs.aws.amazon.com//service-authorization/latest/reference/list_awsiot.html).