KPI Definitions

Le module Définitions des KPI permet aux administrateurs de configurer les indicateurs clés de performance (KPI) affichés sur les tableaux de bord IoTRoutes.

Les KPI offrent un aperçu rapide de l'activité de la plateforme, de son état opérationnel et des tendances des données, telles que les messages reçus, les attributs défectueux, l'état des périphériques, les exécutions de tâches, les performances des flux de travail ou les alertes d'interprétation des attributs.

Aperçu

Accessible depuis Paramètres de l'application → Définitions des KPI, cette section répertorie tous les KPI disponibles avec leurs descriptions, leurs objets cibles, leur type de visualisation et leurs zones d'affichage sur le tableau de bord.
Les administrateurs peuvent activer, désactiver ou restreindre les indicateurs de performance clés (KPI) en fonction des rôles des utilisateurs.

La définition d'indicateur de performance clé (KPI) comprend :

• Name – Identifiant unique de l'indicateur de performance clé (KPI).
• Description – Brève explication de ce que mesure l'indicateur clé de performance (KPI).
• Of Object – l'objet de données source (par exemple, Appareil, Message, Registre d'attributs, Historique de flux de travail).
• Chart Type – Type de visualisation : carte, jauge, ligne ou colonne.
• Dashboard Zone – Emplacement d'affichage préféré sur le tableau de bord (En-tête, Contenu, Côté droit ou Pied de page).
• User Role Assignment – Restriction de visibilité optionnelle pour les rôles utilisateurs.
• Enabled – Contrôle si l'indicateur de performance clé (KPI) est actif sur les tableaux de bord.

Formulaire de définition des KPIs

Lors de la création ou de la modification d'un indicateur de performance clé (KPI), l'écran de configuration est organisé en trois sections principales :

1. Calcul

Définit la logique de calcul de l'indicateur de performance clé (KPI) :

• Operation – Type de calcul (Nombre, Moyenne, Somme, Min, Max, etc.).
• Of Object – Entité source utilisée pour le calcul.
• Field – Champ ou attribut sur lequel appliquer l'opération.
• Calculation Period – Champ ou attribut sur lequel appliquer l'opération.
• Filters – Filtres optionnels pour affiner les résultats (par exemple, statut = Actif, type = Température).

2. Options d'affichage

Spécifie comment l'indicateur de performance clé (KPI) apparaîtra par défaut sur le tableau de bord.
Chaque utilisateur peut ensuite personnaliser son propre tableau de bord grâce à la fonctionnalité de personnalisation du tableau de bord : ajouter des indicateurs clés de performance (KPI), modifier leur position ou leur ordre et modifier les titres des sections du tableau de bord.

• Zone placement (Header, Content, Footer, etc.)
• Display order and layout behavior.
• Default chart type (Card, Gauge, Line, Column).

3. Indicateurs

Définit comment la valeur de l’indicateur clé de performance (KPI) est interprétée ou mise en évidence visuellement :

• Les seuils peuvent déclencher des signaux visuels (par exemple, des changements de couleur, des icônes d'avertissement).
• Les valeurs peuvent représenter des effectifs absolus ou des pourcentages.
• Utile pour des analyses conditionnelles telles que :
  • « Température élevée détectée »
  • « Valeur nécessitant une attention particulière »
  • « Niveau d'activité supérieur au seuil normal »

4- Attribution des rôles des utilisateurs

Chaque indicateur de performance clé (KPI) peut être limité à des rôles utilisateurs spécifiques via le champ « Attribution des rôles utilisateurs ».

Par défaut, les KPI sont affichés aux utilisateurs dont le rôle est pertinent au contexte du KPI.

Ce mécanisme permet de personnaliser les tableaux de bord, garantissant ainsi que chaque utilisateur ne voit que les informations correspondant à ses responsabilités.

Par exemple :

• Les administrateurs système consultent les indicateurs clés de performance (KPI) relatifs à l'infrastructure et aux performances de la plateforme (par exemple, le nombre d'appareils actifs, le débit de messages et les tâches ayant échoué).
• Les utilisateurs fonctionnels consultent les KPI reflétant les activités opérationnelles, comme les messages reçus, les attributs traités ou les exécutions de flux de travail.
• Les administrateurs de sécurité ont accès aux KPI axés sur la sécurité, tels que le nombre de connexions utilisateur, les tentatives d'authentification infructueuses ou les tentatives d'accès suspectes.

Cette approche améliore la clarté et réduit la surcharge d'informations tout en maintenant la visibilité basée sur les rôles et la pertinence des données sur l'ensemble de la plateforme.

Indicateurs clés de performance (KPI) prédéfinis

IoTRoutes inclut par défaut plusieurs indicateurs de performance clés (KPI) prédéfinis, offrant une visibilité immédiate sur les activités de la plateforme et des appareils :

• Abnormal attributes – Number of abnormal attribute values received during the last 24 hours that were not analyzed. “Abnormal” refers to interpretation levels flagged by the Attribute Interpreter, as described in the Application Settings section.
• Unanalyzed attributes – Attributes that were received and normalized into the Ledger but not yet processed by any Interpreter.
• Active devices – Number of devices that have connected to the platform in the last 24 hours.
• Received messages – Total number of IoT messages received during the last 24 hours.
• Faulty attributes – Count of received attributes identified as containing anomalies.
• Job failures – Number of workflow jobs that failed within the last 7 days.
• Sent commands – Number of commands transmitted from the platform to devices.
• Sample curves – Example chart showing temperature measurements over the last 3 days, provided as a model for users creating custom chart-based KPIs.