Visualisation d’événements

Créez et filtrez des requêtes sur des événements CDF, et annotez les événements avec des graphiques sur votre tableau de bord Grafana. Vous pouvez personnaliser la plage de temps, les événements à afficher et les colonnes en fonction de vos besoins.

Gestion des événements dans un tableau

Ouvrez l’onglet Événement dans Grafana pour gérer les événements dans un tableau.

Définition d’une requête

La requête events utilise le point de terminaison events/list pour extraire des données.

Format : events{someFilter=number, otherFilter="string"}

Exemple :

events{externalIdPrefix='WORKORDER', assetSubtreeIds=[{id=12}, {externalId='ext_id'}]}

Vous pouvez filtrer en fonction des propriétés suivantes : externalIdPrefix, metadata, assetIds, assetExternalIds, rootAssetIds, assetSubtreeIds, dataSetIds, source, type et subtype.

Par défaut, la requête renvoie des événements actifs sur la plage de temps, mais vous pouvez personnaliser la requête avec les filtres temporels supplémentaires startTime, endTime, activeAtTime, createdTime et lastUpdatedTime.

Cet exemple retourne tous les événements terminés qui ont commencé sur la plage de temps actuelle :

events{startTime={min=$__from}, endTime={isNull=false}}

Cet exemple retourne seulement des événements terminés :

events{endTime={isNull=false}}

Filtrage côté client

Spécifiez plus de critères de filtrage côté client avec les opérateurs =~, !~ et !=. Une virgule entre plusieurs filtres équivaut à un AND logique.

Format :

• =~ - égalité regex. Retourne des résultats qui respectent l’expression régulière.

• !~ - inégalité regex. Exclut les résultats qui respectent l’expression régulière.

• != - inégalité stricte. Retourne des éléments où une propriété n’est pas égale à une valeur donnée.

Exemple :

events{type='WORKORDER', subtype=~'SUB.*'}

REMARQUE

N’utilisez pas les filtres côté client comme principale méthode de filtrage. Grafana applique les filtres une fois les éléments retournés par CDF, et il est possible que vous ne voyiez pas toutes les données si CDF retourne le nombre maximum d’éléments (1000).

Création de modèles

Créez des modèles en utilisant la syntaxe $variable_name.

Exemple :

events{type='WORKORDER', subtype=$variable}

Renommage et organisation des champs

Sélectionnez l’onglet Transformer pour renommer et organiser des champs.

Annotation de graphiques avec des événements

Utilisez des annotations pour superposer des informations d’événements de CDF sur des graphiques dans Grafana.

1. Naviguez jusqu’aux paramètres de votre tableau de bord, et sélectionnez Annotations.
2. Sélectionnez votre projet CDF dans le champ Source de données.

1. Spécifiez la requête pour extraire et filtrer des événements depuis CDF. Par exemple :

   events{type="some", subtype=~"sub.*"}

   La requête ci-dessus demande des événements avec le paramètre type="some" et filtre les résultats par subtype correspondant à sub.*.

   • Vous trouverez une liste complète de paramètres valides dans la documentation de l’API.

   • Découvrez comment filtrer les résultats.