Requisitos previos Configuración Crear métricas de flota Vea las métricas de la flota en CloudWatch Limpieza

Explicación introductoria

En este tutorial, creará una métrica de flota para monitorizar las temperaturas de sus sensores y detectar posibles anomalías. Al crear la métrica de flota, defina una consulta de agregación que detecte el número de sensores con temperaturas superiores a 80 grados Fahrenheit. Usted especifica que la consulta se ejecute cada 60 segundos y los resultados de la consulta se CloudWatch emitirán allí, donde podrá ver la cantidad de sensores que presentan posibles riesgos de alta temperatura y configurar las alarmas. Para completar este tutorial utilizará la AWS CLI.

En este tutorial, aprenderá a:

Configurar.
Crear métricas de flota
Vea las métricas en CloudWatch
Limpiar recursos

Para completar este tutorial se necesitan aproximadamente 15 minutos.

Requisitos previos

Instale la versión más reciente de AWS CLI
Familiarícese con las consultas de datos agregados
Familiarízate con el uso de CloudWatch las métricas de Amazon

Configuración

Para utilizar las métricas de flota, active la indexación de flotas. Para habilitar la indexación de flotas de sus objetos o grupos de objetos con orígenes de datos específicos y configuraciones asociadas, siga las instrucciones de Administrar la indexación de objetos y Administrar la indexación de grupos de objetos.

Para configurar

Ejecute el siguiente comando para habilitar la indexación de flotas y especifique los orígenes de datos en los que realizar la búsqueda.
```
aws iot update-indexing-configuration \
--thing-indexing-configuration "thingIndexingMode=REGISTRY_AND_SHADOW,customFields=[{name=attributes.temperature,type=Number},{name=attributes.rackId,type=String},{name=attributes.stateNormal,type=Boolean}],thingConnectivityIndexingMode=STATUS" \
```
El comando de la CLI del ejemplo anterior permite que la indexación de flotas admita la búsqueda de datos de registro, datos de sombras y el estado de conectividad de las objetos mediante el índice AWS_Things.

El cambio de la configuración puede tardar algunos minutos en completarse. Compruebe que la indexación de flotas esté habilitada antes de crear las métricas de flota.

Para comprobar si la indexación de flotas está habilitada, ejecute el siguiente comando de la CLI:
```
aws --region us-east-1 iot describe-index --index-name "AWS_Things"
```
Para obtener más información, consulte Habilitar la indexación de objetos.

Ejecute el siguiente script bash para crear diez objetos y describirlos.


# Bash script. Type `bash` before running in other shells.

Temperatures=(70 71 72 73 74 75 47 97 98 99)
Racks=(Rack1 Rack1 Rack2 Rack2 Rack3 Rack4 Rack5 Rack6 Rack6 Rack6)
IsNormal=(true true true true true true false false false false)

for ((i=0; i < 10; i++))
do
  thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[@]:$i:1},rackId=${Racks[@]:$i:1},stateNormal=${IsNormal[@]:$i:1}}")
  aws iot describe-thing --thing-name "TempSensor$i"
done

Este script crea diez objetos para representar diez sensores. Cada objeto tiene los atributos de temperature, rackId, y stateNormal, tal como se describe en la siguiente tabla:

Atributo	Tipo de datos	Descripción
`temperature`	Número	Valor de temperatura en grados Fahrenheit
`rackId`	Cadena	ID del rack de servidores que contiene los sensores
`stateNormal`	Booleano	Si el valor de temperatura del sensor es normal o no

La salida de este script contiene diez archivos JSON. Uno de los archivos JSON tiene el siguiente aspecto:


{
    "version": 1, 
    "thingName": "TempSensor0", 
    "defaultClientId": "TempSensor0", 
    "attributes": {
        "rackId": "Rack1", 
        "stateNormal": "true", 
        "temperature": "70"
    }, 
    "thingArn": "arn:aws:iot:region:account:thing/TempSensor0", 
    "thingId": "example-thing-id"
}

Para obtener más información, consulte la sección Crear un objeto.

Crear métricas de flota

Para crear una métrica de flota

Ejecute el siguiente comando para crear una métrica de flota llamada high_temp_FM. Usted crea la métrica de la flota para monitorear la cantidad de sensores con temperaturas superiores a 80 grados Fahrenheit in. CloudWatch
```
aws iot create-fleet-metric --metric-name "high_temp_FM" --query-string "thingName:TempSensor* AND attributes.temperature >80" --period 60 --aggregation-field "attributes.temperature" --aggregation-type name=Statistics,values=count
```
--metric-name

Tipo de datos: cadena. El parámetro --metric-name especifica el nombre de una métrica de flota. En este ejemplo, va a crear una métrica de flota llamada high_temp_FM.

--query-string

Tipo de datos: cadena. El parámetro --query-string especifica la cadena de consulta. En este ejemplo, la cadena de consulta significa consultar todos los elementos cuyos nombres comiencen por TempSensory con temperaturas superiores a 80 grados Fahrenheit. Para obtener más información, consulte Sintaxis de consultas.

--period

Tipo de datos: entero. El parámetro --period especifica el tiempo necesario para recuperar los datos agregados en segundos. En este ejemplo, se especifica que la métrica de flota que está creando recupera los datos agregados cada 60 segundos.

--aggregation-field

Tipo de datos: cadena. El parámetro --aggregation-field especifica el atributo que se va a evaluar. En este ejemplo, se va a evaluar el atributo de temperatura.

--aggregation-type

El parámetro --aggregation-type especifica el resumen estadístico que se mostrará en la métrica de la flota. Para sus tareas de monitorización, puede personalizar las propiedades de consulta de agregación para los diferentes tipos de agregación (estadísticas, cardinalidad y percentil). En este ejemplo, se especifica el recuento para el tipo de agregación y Statistics para que devuelva el recuento de dispositivos que tienen atributos que coinciden con la consulta, es decir, para devolver el recuento de los dispositivos cuyos nombres comiencen por TempSensory con temperaturas superiores a 80 grados Fahrenheit. Para obtener mas información, consulte Consulta de datos agregados.

El resultado de este comando tendrá un aspecto similar al siguiente.
```
{
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "metricName": "high_temp_FM"
}
```
nota
Los puntos de datos pueden tardar un momento en mostrarse. CloudWatch

Para obtener más información sobre cómo crear una métrica de flota, consulte Administración de métricas de flota.

Si no puede crear una métrica de flota, vaya a Solución de problemas de métricas de flota.

(Opcional) Ejecute el siguiente comando para describir su métrica de flota llamada high_temp_FM:


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

El resultado de este comando tendrá un aspecto similar al siguiente.


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

Vea las métricas de la flota en CloudWatch

Tras crear la métrica de flota, puede ver los datos de la métrica en CloudWatch. En este tutorial, verá la métrica que muestra el número de sensores cuyos nombres comienzan por TempSensory con temperaturas superiores a 80 grados Fahrenheit.

Para ver los puntos de datos en CloudWatch

Abra la CloudWatch consola en https://console.aws.amazon.com/cloudwatch/.
En el CloudWatch menú del panel izquierdo, selecciona Métricas para expandir el submenú y, a continuación, selecciona Todas las métricas. Esto abre la página con la mitad superior para mostrar el gráfico y la mitad inferior contiene cuatro secciones con pestañas.
La primera sección con pestañas Todas las métricas muestra todas las métricas que puede ver en grupos, elija IoT FleetMetrics. Contiene todas las métricas de su flota.
En la sección Tipo de agregación de la pestaña Todas las métricas, seleccione Tipo de agregación para ver todas las métricas de flota que ha creado.
Elija la métrica de flota para mostrar el gráfico a la izquierda de la sección Tipos de agregación. Verá el recuento de valores a la izquierda del nombre de la métrica, y este es el valor del tipo de agregación que especificó en la sección Crear métricas de flota de este tutorial.
Seleccione la segunda pestaña, denominada Métricas graficadas, a la derecha de la pestaña Todas las métricas para ver la métrica de flota que eligió en el paso anterior.

Debería poder ver un gráfico que muestre el número de sensores con temperaturas superiores a 80 grados Fahrenheit, como el siguiente:

nota
El atributo Periodo CloudWatch por defecto es de 5 minutos. Es el intervalo de tiempo entre los puntos de datos que aparecen CloudWatch. Puede cambiar la configuración de Period en función de sus necesidades.
(Opcional) Puede configurar una alarma métrica.
1. En el CloudWatch menú del panel izquierdo, selecciona Alarmas para expandir el submenú y, a continuación, selecciona Todas las alarmas.
2. En la página Alarmas, seleccione Crear alarma en la esquina superior derecha. Sigue las instrucciones Crear alarma en la consola para crear una alarma según sea necesario. Para obtener más información, consulta Cómo usar CloudWatch las alarmas de Amazon.

Para obtener más información, consulta Cómo usar CloudWatch las métricas de Amazon.

Si no puedes ver los puntos de datos CloudWatch, lee Solución de problemas con las métricas de flota.

Limpieza

Para eliminar métricas de flota

El comando de la CLI delete-fleet-metric se utiliza para eliminar las métricas de flota.

Para eliminar la métrica de flota denominada high_temp_FM, ejecute el comando siguiente.


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

Para limpiar objetos

Puede utilizar el comando de la CLI delete-thing para eliminar objetos.

Para eliminar los diez objetos que ha creado, ejecute el siguiente script:


# Bash script. Type `bash` before running in other shells.

for ((i=0; i < 10; i++))
do
  thing=$(aws iot delete-thing --thing-name "TempSensor$i")
done

Para limpiar las métricas en CloudWatch

CloudWatch no admite la eliminación de métricas. Las métricas caducan en función de sus programas de retención. Para obtener más información, consulta Cómo usar CloudWatch las métricas de Amazon.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Métricas de flota

Administración de métricas de flota