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 AWS IoT consola y cómo AWS CLI gestionar las métricas de tu flota.

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 haber activado la indexación de la flota con las fuentes de datos y las configuraciones asociadas antes de crear las métricas de la 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/.

  2. En el AWS IoT menú, selecciona 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. Abre la AWS IoT consola en https://console.aws.amazon.com/iot/.

  2. En el AWS IoT menú, selecciona Administrar y, a continuación, selecciona 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.

    • Seleccione 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, introduce la hora (con qué frecuencia) quieres que la métrica de flota emita datos CloudWatch.

    • Seleccione 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 utilizarlos AWS CLI para gestionar las métricas de la flota. Asegúrese de haber activado la indexación de la flota con las fuentes de datos y las configuraciones asociadas antes de crear las métricas de la 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 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 update-fleet-metric comando no produce ningún resultado. 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.

Autorización del etiquetado de los recursos de IoT

Para tener un mejor control de las métricas de flota que puede crear, modificar o usar, puede adjuntar etiquetas a las métricas de la flota.

Para etiquetar las métricas de flota que cree utilizando AWS Management Console o AWS CLI, debe incluir la iot:TagResource acción en su política de IAM para conceder permisos al usuario. Si tu política de IAM no lo incluyeiot:TagResource, cualquier acción que se lleve a cabo para crear una métrica de flota con una etiqueta generará un AccessDeniedException error.

Para obtener información general sobre cómo etiquetar tus recursos, consulta Etiquetar tus recursos. AWS IoT

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.