IoT Platform:Crear una métrica

Requisitos previos

Debe haber importado las métricas de definición original y agregado los términos atómicos. Para obtener más información, consulte Import preset metrics y Add atomic words.

Procedimiento

1. En la consola de IoT Platform, vaya a la página Overview y haga clic en el ID o alias de la instancia Enterprise Edition deseada.

2. En el panel de navegación izquierdo, seleccione Data Service > Data Metric y haga clic en Customize Metric.

3. Vaya a la pestaña All Metrics y haga clic en Create a Metric.

4. Siga las indicaciones en pantalla para configurar la definición de la métrica.

   1. Seleccione el dominio de la nueva métrica y elija la entidad específica y el Derivation Scope según las instrucciones.

      Parámetro	Observaciones
      Esta entidad	La entidad actual.
      Subentidad	Una subentidad de la entidad actual. Para las métricas de definición derivada, debe seleccionar una subentidad. Por ejemplo, si la subentidad de un producto es un dispositivo, la métrica de definición derivada se calcula para cada dispositivo en lugar del producto completo.

   2. Utilice las pautas a continuación para definir la métrica.

      Parámetro	Observaciones
      Modificador de tiempo	Seleccione un modificador de tiempo para definir el rango de datos estadísticos de la nueva métrica.
      Término atómico	Seleccione los términos atómicos agregados previamente en el dominio de la métrica. Para agregar términos atómicos, haga clic en el botón Go to Create Atomic Term ubicado a la derecha. Para obtener más información, consulte Add atomic words.
      Nombre de la métrica	El nombre de la métrica es fijo y combina automáticamente el modificador de tiempo con el término atómico. Ejemplo: Average Temperature of the Last 1 Day.
      Unidad de medida	Seleccione el tipo de unidad y la unidad correspondiente.
      Tipo de datos	Defina el tipo de datos, la precisión, los decimales y el rango de valores. Haga clic en el icono de ayuda para ver descripciones detalladas de los tipos de datos.
      Método de procesamiento	Derivado de activos de métricas existentes. Este valor no se puede modificar.
      Es calculable	Para métricas numéricas acumulables como recuento, cantidad o frecuencia, seleccione Yes.
      Frecuencia estadística	Los datos se procesan y generan diariamente. Este valor no se puede modificar.
      Fecha de vencimiento	Establezca la fecha de vencimiento de la métrica. Importante Cuando la métrica vence, se detiene la programación de producción de datos.
      Descripción de la métrica	Proporcione una descripción empresarial para la métrica; por lo general, incluye el modificador de tiempo y el término atómico. Ejemplo: Time Modifier: Last 1 Day, Atomic Term: Average Temperature

   3. Siga estas instrucciones para establecer las reglas de cálculo.

      Método de cálculo	Observaciones	Ejemplo
      Cálculo agregado	Seleccione una función de agregación, una métrica y un operador en el menú desplegable. Puede agregar hasta 10 expresiones.	Por ejemplo, seleccione la subentidad del dominio de producto, la función COUNT(Count) y la temperatura del producto (od3**). Esto indica el cálculo del número de registros de temperatura en el producto (od3**) mediante métricas de definición derivada.
      Cálculo de expresión	Introduzca la expresión de operación en el cuadro de entrada. Para consultar las funciones compatibles, véase Appendix: Function List a continuación. Haga clic en el botón Function situado encima del cuadro de entrada para ver instrucciones y ejemplos. La sintaxis de la expresión consiste en introducir la función de agregación en el cuadro de entrada, insertar el símbolo $ o @ dentro del cuerpo de la función, seleccionar el dominio de la métrica, agregar un punto (.), elegir la entidad bajo el dominio de la métrica, añadir otro punto (.) y, finalmente, seleccionar la métrica para la derivación y el cálculo. Los símbolos $ y @ se utilizan para distintos tipos de métricas: $: Métricas de definición original y derivada. @: Métricas originales y derivadas. Nota No se admiten operadores básicos dentro de las expresiones de funciones de agregación.	Para el producto Sensor de temperatura y humedad con 100 dispositivos, incluido el TH_sensor, la expresión de la métrica derivada para Temperatura promedio del último día, basada en la métrica original y la definición de Temperatura, es la siguiente: avg($Product.Temperature and Humidity Sensor.Temperature): Calcula la temperatura promedio de todos los dispositivos del producto mediante métricas de definición derivada. avg(@Device.TH_sensor.Temperature): Calcula la temperatura promedio del dispositivo TH_sensor mediante métricas de definición derivada.

5. Haga clic en Complete and Publish.

   Consulte las métricas recién completadas en la lista All Metrics.

   Nota

   • Las métricas seleccionadas con un solo clic en el botón Complete se marcarán como Unpublished y no recopilarán datos.

   • Las métricas incompletas se pueden enviar al borrador al hacer clic en Enter Draft Box, lo que permite editarlas posteriormente y completar el proceso de publicación.

6. De forma opcional, en la lista All Metrics, localice la métrica deseada, haga clic en el botón de función en la columna de operaciones y realice las acciones a continuación:

   Nota

   Las métricas de definición original solo admiten las funciones de consulta y eliminación.

   Operación	Observaciones
   View	Consulte la información básica, la lógica de cálculo, la vista previa de datos y otros detalles de la métrica.
   Edit	Modifique la configuración de la métrica derivada.
   Unpublish	Revierta la métrica al estado no publicado. Las métricas derivadas y los servicios relacionados fallarán.
   Publish	Publique la métrica para que esté disponible públicamente.
   Clone	Duplique la métrica. En la página de clonación de métricas, modifique la definición y la configuración según sea necesario para crear una nueva métrica. Importante No se pueden guardar métricas con configuraciones idénticas a la original.
   Delete	Elimine la métrica del sistema. Importante No se puede eliminar una métrica en las condiciones a continuación: La métrica tiene métricas dependientes asociadas. La métrica se utiliza en informes de análisis de datos.

Siguientes pasos

Las métricas derivadas representan datos estadísticos T+1. Para ver los datos inmediatamente después de agregar nuevas métricas, inicie manualmente una tarea de actualización.

Para obtener instrucciones detalladas, consulte Metric Refresh.

Apéndice: Lista de funciones