Administración de métricas de flota - AWS IoT Core
Administración de métricas de flota (consola)Administración de métricas de flota (CLI)Autorización del etiquetado de los recursos de IoT

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 consola de AWS IoT y la AWS CLI para administrar las métricas de flota.

Administración de métricas de flota (consola)

En las siguientes secciones se muestra cómo utilizar la consola de AWS IoT para administrar 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. Abra la consola de AWS IoT en https://console.aws.amazon.com/iot/.

  2. En el menú AWS IoT, elija Configuración.

  3. Para ver la configuración detallada, en la página Configuración desplácese hacia abajo hasta la sección Indexación de flotas.

  4. 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.

  5. 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.

      Para actualizar y guardar la configuración, seleccione Actualizar.

Crear una métrica de flota

  1. Abra la consola de AWS IoT en https://console.aws.amazon.com/iot/.

  2. En el menú AWS IoT, seleccione Administrar y, a continuación, Estadísticas de flota.

  3. En la página Métricas de flota, seleccione Crear métrica de flota y complete los pasos de creación.

  4. 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 el nombre del índice, el tipo de agregación y el 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.

  5. 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, introduzca la hora (frecuencia) a la que quiere que la métrica de flota emita datos a CloudWatch.

    • Elija Siguiente.

  6. 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.

  2. 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.

  3. 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.

  2. En la página siguiente que muestra los detalles de la métrica de su flota, seleccione Eliminar.

  3. En el cuadro de diálogo, escriba el nombre de la métrica de flota para confirmar la eliminación.

  4. 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 utilizar la AWS CLI para administrar 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 o Administrar la indexación de grupos de objetos.

Crear una métrica de flota

Puede usar el comando de la CLI create-fleet-metric 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 de la CLI list-fleet-metric para enumerar todas las métricas de 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 utilizar el comando de la CLI describe-fleet-metric para mostrar información acerca de 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 de la CLI update-fleet-metric 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 produce ningún resultado. Puede utilizar el comando de la CLI describe-fleet-metric 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 de la CLI delete-fleet-metric 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.

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 con la AWS Management Console o la AWS CLI, debe incluir la acción iot:TagResource en la 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.

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 de AWS IoT.