Transformez les données de vos logs en métriques que vous pouvez représenter graphiquement, sur lesquelles déclencher des alertes, et regrouper à l’échelle de votre application.
Si vous avez indexé des logs dans AppSignal, vous pouvez générer des métriques à partir d’eux directement dans la vue Explore. Utilisez ces métriques basées sur les logs pour suivre des signaux importants dans le temps, configurer des déclencheurs ou les ajouter à des tableaux de bord, le tout sans modifier le code de votre application ni quitter votre flux d’exploration des logs.Utilisez les métriques de log pour compter la fréquence d’un événement, suivre la dernière valeur d’un champ numérique, ou suivre sa moyenne et ses centiles dans le temps.Lorsque vous repérez quelque chose qui mérite d’être suivi dans vos logs, vous pouvez le transformer en métrique sans quitter la page Logs. La requête, la gravité et la source de log que vous avez utilisées pour affiner vos logs sont reportées dans la métrique, de sorte que le filtrage que vous avez déjà effectué définit ce que la métrique suit. Une fois la métrique enregistrée, vous pouvez l’ajouter à un tableau de bord ou l’utiliser dans un déclencheur dans le même flux.
Dans le panneau Define metric, remplissez les champs qui décrivent ce que vous souhaitez mesurer. Lorsque vous modifiez un champ, l’Aperçu des données sur la droite se met à jour afin que vous puissiez vérifier que la métrique renvoie les données attendues.
Metric name : un nom unique pour la métrique, utilisé lorsque vous y faites référence dans les tableaux de bord et les déclencheurs. Consultez nommage des métriques pour connaître les règles et recommandations.
Log source : la source de log à partir de laquelle la métrique tire ses événements.
Severity : filtrer par gravité, ou sélectionner all pour inclure tous les niveaux.
Query : la chaîne de requête utilisée pour faire correspondre les lignes de log. Même syntaxe que la page Logs.
Field to measure : pour les métriques Gauge et Measurement, le champ numérique à suivre — par exemple, la durée ou la taille de chaque événement, au lieu de compter les occurrences.
Group by tag : divisez la métrique par tag pour obtenir une série distincte par valeur unique (par exemple, regroupez par hostname pour obtenir une série par serveur).
Lorsque vous avez terminé, sélectionnez Create metric pour enregistrer.
Nous recommandons de nommer vos métriques de manière facilement reconnaissable.Les noms de métriques ne prennent en charge que les chiffres, les lettres, les points et les underscores ([a-z0-9._]) comme caractères valides. Tout autre caractère sera remplacé par un underscore par notre processeur.Voici quelques exemples de bons noms de métriques :
database_size
account_count
users.count
notifier.failed
orders.request.duration
Remarque : nous vous déconseillons d’ajouter des valeurs dynamiques à
vos noms de métriques comme ceci : eu.database_size, us.database_size et
asia.database_size. Cela crée plusieurs métriques qui servent le même objectif.
Nous recommandons plutôt d’utiliser Group by tag dans ce cas.
Le type de métrique définit comment AppSignal agrège les données dans le temps. Le champ Field to measure n’apparaît que pour Gauge et Measurement, car Count ne fait que compter les lignes de log correspondantes.
Le nombre total d’événements correspondants dans une plage de temps donnée. Utilisez ceci pour les événements comme les erreurs, les inscriptions ou les nouvelles tentatives de tâches.Count n’a pas besoin d’un Field to measure — il compte simplement chaque ligne de log correspondant à votre requête.
Moyennes, comptes et centiles pour un champ numérique au fil du temps. Utilisez ceci lorsque la distribution importe, comme la durée d’une requête.Measurement conserve la moyenne, le compte et les 90e/95e centiles du Field to measure pour chaque intervalle.
Un graphique en direct de la métrique pour la plage de temps sélectionnée. L’aperçu du graphique prend en charge la sélection de plusieurs sources de log et gravités, et se met à jour lorsque vous modifiez un champ dans le panneau Define metric.Utilisez le sélecteur de plage de temps sous le graphique pour basculer entre Last 24 hours, Last 48 hours et Last 7 days.
Les lignes de log qui correspondent à votre requête actuelle. Lorsque Field to measure est défini, ce champ apparaît comme une colonne mise en évidence afin que vous puissiez confirmer les valeurs avant d’enregistrer.
Après avoir enregistré une métrique pour la première fois, AppSignal vous demande ce que vous voulez en faire :
Add to dashboard : ajoutez la métrique à un graphique sur un tableau de bord existant.
Create a trigger : ouvrez le flux de création de déclencheur avec la métrique pré-remplie.
Edit metric : rouvrez la superposition pour affiner la configuration.
Pour les métriques suivantes, AppSignal affiche un message de confirmation à la place. Vous pouvez toujours accéder aux mêmes options depuis la page Metrics.Une nouvelle métrique peut prendre un moment avant de commencer à collecter des données. Un tableau de bord ou un déclencheur créé juste après peut donc brièvement afficher un avertissement « no data yet ».
Ouvrez la page Metrics depuis le menu latéral Logging.
Trouvez la métrique et sélectionnez Edit dans le menu à trois points.
Ajustez les champs Severity, Query, Field to measure ou Group by tag.
Sélectionnez Update metric pour enregistrer.
Le Metric name et le Metric type sont en lecture seule lors de la modification. Pour modifier l’un ou l’autre, créez une nouvelle métrique.Depuis le menu de ligne de la page Metrics, vous pouvez également ajouter la métrique à un tableau de bord, créer un déclencheur à partir d’elle ou la supprimer. La colonne Modified by indique qui a mis à jour chaque métrique en dernier, ce qui vous permet de voir en un coup d’œil quel membre de l’équipe a effectué la modification la plus récente.
