Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Administración de métricas de flota
En este tema se muestra cómo utilizar la AWS IoT consola y cómo AWS CLI gestionar las métricas de tu flota.
**Topics**
+ [Administración de métricas de flota (consola)](#managing-fleet-metrics-console)
+ [Administración de métricas de flota (CLI)](#managing-fleet-metrics-cli)
+ [Autorización del etiquetado de los recursos de IoT](#managing-fleet-metrics-policy)
## Administración de métricas de flota (consola)
En las siguientes secciones, se muestra cómo utilizar la AWS IoT consola para gestionar las métricas de la flota. Asegúrese de activar la indexación de flotas con los orígenes de datos y las configuraciones asociadas antes de crear las métricas de flota.
### Habilitar la indexación de flotas
Si ya ha habilitado la indexación de flotas, puede omitir esta sección.
Si no ha habilitado la indexación de flotas, siga estas instrucciones.
1. Abre la AWS IoT consola en [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/).
1. En el AWS IoT menú, selecciona **Configuración**.
1. Para ver la configuración detallada, en la página **Configuración** desplácese hacia abajo hasta la sección **Indexación de flotas**.
1. Para actualizar la configuración de indexación de flotas, a la derecha de la sección **Indexación de flotas**, seleccione **Administrar indexación**.
1. En la página **Administrar indexación de flotas**, actualice la configuración de indexación de flotas en función de sus necesidades.
+ **Configuración**
Para activar la indexación de objetos, active **Indexación de objetos** y, a continuación, seleccione los orígenes de datos desde los que desee indexar.
Para activar la indexación de grupos de objetos, active **Indexación de grupo de objetos**.
+ **Campos personalizados para la agregación: *opcional***
Los campos personalizados son una lista de pares de nombres y tipos de campo.
Para agregar un par de campos personalizados, seleccione **Agregar un campo nuevo**. Introduzca un nombre de campo personalizado, por ejemplo `attributes.temperature`, y, a continuación, seleccione un tipo de campo en el menú **Tipo de campo**. Tenga en cuenta que el nombre de un campo personalizado comienza por `attributes.` y se guardará como un atributo para ejecutar [consultas de agregación de objetos](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html).
Para actualizar y guardar la configuración, seleccione **Actualizar**.
### Crear una métrica de flota
1. Abre la AWS IoT consola en [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/).
1. En el AWS IoT menú, selecciona **Administrar** y, a continuación, selecciona **Estadísticas de flota**.
1. En la página **Métricas de flota**, seleccione **Crear métrica de flota** y complete los pasos de creación.
1. En el paso 1, **Configurar las métricas de flota**
+ En la sección **Consulta**, introduzca una cadena de consulta para especificar los objetos o grupos de objetos que quiere que realicen la búsqueda agregada. La cadena de consulta consta de un atributo y un valor. En **Propiedades**, elija el atributo que desee o, si no aparece en la lista, introdúzcalo en el campo. Especifique el valor después de `:`. Un ejemplo de cadena de consulta puede ser `thingName:TempSensor*`. Para cada cadena de consulta que introduzca, pulse **Intro** en el teclado. Si introduce varias cadenas de consulta, especifique su relación seleccionando los operadores **and**, **or**, **and not** u **or not**.
+ En **Propiedades del informe**, elija las opciones **Nombre del índice**, **Tipo de agregación** y **Campo de agregación** en sus respectivas listas. A continuación, seleccione los datos que desee agregar en **Seleccionar datos**, donde puede seleccionar varios valores de datos.
+ Elija **Siguiente**.
1. En el paso 2, **Especificar las propiedades de las métricas de flota**
+ En el campo **Nombre de la métrica de flota**, introduzca un nombre para la métrica de flota que está creando.
+ En el campo **Descripción: *opcional***, introduzca una descripción para la métrica de flota que está creando. Este campo es opcional.
+ En los campos **Horas** y **Minutos**, introduce la hora (con qué frecuencia) quieres que la métrica de flota emita datos CloudWatch.
+ Elija **Siguiente**.
1. En el paso 3, **Revisar y crear**
+ Revise la configuración de los pasos 1 y 2. Para editar esta configuración, elija **Editar**.
+ Seleccione **Crear métrica de flota**.
Una vez creada correctamente, la métrica de flota aparece en la página **Métrica de flota**.
### Actualizar una métrica de flota
1. En la página **Métricas de flota**, seleccione la métrica de flota que quiera actualizar.
1. En la página **Detalles** de la métrica de flota, seleccione **Editar**. Se abren los pasos de creación, en los que puede actualizar la métrica de su flota en cualquiera de los tres pasos.
1. Cuando termine de actualizar la métrica de flota, seleccione **Actualizar métrica de flota**.
### Eliminar una métrica de flota
1. En la página **Métricas de flota**, seleccione la métrica de flota que quiera eliminar.
1. En la página siguiente que muestra los detalles de la métrica de su flota, seleccione **Eliminar**.
1. En el cuadro de diálogo, escriba el nombre de la métrica de flota para confirmar la eliminación.
1. Elija **Eliminar**. Este paso elimina la métrica de flota de forma permanente.
## Administración de métricas de flota (CLI)
En las siguientes secciones, se muestra cómo utilizarlos AWS CLI para gestionar las métricas de la flota. Asegúrese de activar la indexación de flotas con los orígenes de datos y las configuraciones asociadas antes de crear las métricas de flota. Para habilitar la indexación de flotas de sus objetos o grupos de objetos, siga las instrucciones de [Administrar la indexación de objetos](managing-index.md#enable-index) o [Administrar la indexación de grupos de objetos](thinggroup-index.md#enable-group-index).
### Crear una métrica de flota
Puede usar el comando create-fleet-metric CLI para crear una métrica de flota.
```
aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum
```
La salida de este comando contiene el nombre y el nombre de recurso de Amazon (ARN) de su métrica de flota. El resultado es similar al siguiente:
```
{
"metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName",
"metricName": "YourFleetMetricName"
}
```
### Enumerar métricas de flota
Puede usar el comando list-fleet-metric CLI para enumerar todas las métricas de la flota de su cuenta.
```
aws iot list-fleet-metrics
```
La salida de este comando contiene todas las métricas de flota. El resultado es similar al siguiente:
```
{
"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"
}
]
}
```
### Describir una métrica de flota
Puede usar el comando describe-fleet-metric CLI para mostrar información más detallada sobre una métrica de flota.
```
aws iot describe-fleet-metric --metric-name "YourFleetMetricName"
```
La salida del comando contiene información acerca de la métrica de flota especificada. El resultado es similar al siguiente:
```
{
"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"
}
```
### Actualizar una métrica de flota
Puede usar el comando update-fleet-metric CLI para actualizar una métrica de flota.
```
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
```
El comando update-fleet-metric no genera ninguna salida. Puede usar el comando describe-fleet-metric CLI para ver el 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"
}
```
### Eliminar una métrica de flota
Utilice el comando delete-fleet-metric CLI para eliminar una métrica de flota.
```
aws iot delete-fleet-metric --metric-name "YourFleetMetricName"
```
Este comando no produce ningún resultado si la eliminación se realiza correctamente o si se especifica una métrica de flota que no existe.
Para obtener más información, consulte la [Solución de problemas de métricas de flota](fleet-indexing-troubleshooting.md#fleet-metrics-troubleshooting).
## Autorización del etiquetado de los recursos de IoT
Para controlar mejor las métricas de flota que puede crear, modificar o usar, puede asociarles etiquetas.
Para etiquetar las métricas de flota que cree utilizando Consola de administración de AWS o AWS CLI, debe incluir la `iot:TagResource` acción en su política de IAM para conceder permisos al usuario. Si la política de IAM no incluye la acción `iot:TagResource`, cualquier acción para crear una métrica de flota con una etiqueta devolverá un error `AccessDeniedException`.
Para obtener más información general sobre los recursos, consulte [Tagging your AWS IoT resources](https://docs.aws.amazon.com//iot/latest/developerguide/tagging-iot.html).
### Ejemplo de política de IAM
Consulte el siguiente ejemplo de política de IAM que concede permisos de etiquetado al crear una métrica de flota:
****
```
{
"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 obtener información, consulte [Acciones, recursos y claves de condición para AWS IoT](https://docs.aws.amazon.com//service-authorization/latest/reference/list_awsiot.html).