Skip to main content
Imaginons qu’une boutique en ligne écrive une entrée de log chaque fois qu’un client effectue une recherche dans son catalogue. Une seule entrée décrit une recherche, mais le nombre d’entrées dans le temps peut révéler des changements plus larges. Si l’activité de recherche chute alors que le trafic global de la boutique reste stable, cela peut indiquer que les clients n’arrivent pas à accéder à la fonction de recherche ou à l’utiliser. AppSignal peut extraire les données de métrique des lignes de log correspondantes avant de les supprimer. La métrique reste disponible pour les tableaux de bord et les déclencheurs, mais AppSignal ne stocke pas les lignes correspondantes. Activez Drop log line after metric extraction lorsque vous créez ou modifiez une métrique basée sur les logs. AppSignal configure la suppression pour vous. Vous pouvez aussi créer les actions sous-jacentes via AppSignal MCP, comme décrit dans le workflow de traitement des logs.

​
Comment cela fonctionne

Lorsqu’une nouvelle ligne de log correspond à une métrique basée sur les logs enregistrée, AppSignal extrait les données de métrique avant de supprimer la ligne. La métrique reste disponible pour les tableaux de bord et les déclencheurs, mais la ligne de log correspondante n’est pas stockée. L’activation crée un filter associé directement après l’action metrics, utilisant la même requête et les mêmes sources de log. Lorsque vous modifiez la métrique dans l’interface AppSignal, AppSignal met aussi à jour le filter. Désactiver l’option ou supprimer la métrique retire le filter associé.
Ce paramètre ne s’applique qu’aux logs reçus après son activation. Il ne supprime pas les logs déjà stockés par AppSignal.
Le Data preview du formulaire de métrique et la page Logs utilisent les données de log stockées. Ils peuvent encore afficher les lignes correspondantes précédentes, mais n’incluent pas les lignes supprimées après l’extraction de métrique. Utilisez un tableau de bord pour confirmer que la métrique enregistrée reçoit de nouvelles données.

​
Avant de commencer

  • Une source de log qui reçoit les lignes que vous souhaitez mesurer
  • Une requête qui correspond à ces lignes
  • Pour la voie MCP, AppSignal MCP configuré dans votre agent IA, avec un accès en écriture aux outils de logging

​
Activer via l’option

  1. Sur la page Logs, filtrez les lignes que vous voulez mesurer et ouvrez-en une.
  2. Dans la section Actions, sélectionnez Create a metric.
  3. Nommez la métrique, choisissez son type et vérifiez le Data preview. Activez Drop log line after metric extraction, confirmez avec Drop log lines, puis sélectionnez Create metric.
Avant d’activer la suppression, utilisez le Data preview pour confirmer que la requête ne correspond qu’aux lignes que vous voulez écarter.
Vous pouvez aussi activer ce paramètre pour une métrique existante :
  1. Ouvrez la page Metrics depuis le menu latéral Logging.
  2. Ouvrez le menu à trois points de la métrique et sélectionnez Edit.
  3. Activez Drop log line after metric extraction, confirmez avec Drop log lines, puis sélectionnez Update metric.
Le menu à trois points contient aussi les actions Add to dashboard, Create trigger et Delete. La métrique affiche maintenant Drop after match dans la colonne Action de la page Metrics.

​
Configurer via AppSignal MCP

L’outil MCP n’expose pas l’option de l’interface. Votre agent crée à la place deux actions indépendantes : une action metrics suivie d’un filter utilisant la même requête et les mêmes sources de log. Comme les actions ne sont pas liées, mettez à jour les deux si vous modifiez ensuite la requête ou les sources. AppSignal traite les log line actions dans l’ordre. Un filter empêche une ligne correspondante d’atteindre les actions suivantes, donc l’action metrics doit s’exécuter avant le filter.

​
Étape 1 : Enregistrer une métrique à partir des lignes

Demandez à votre agent d’ajouter une action metrics. Par exemple, pour compter la fréquence des recherches dans votre catalogue :
Sur MyStore production, ajoute une log line action metrics qui compte les lignes de log correspondant à message:"Type your message here" sous forme de counter nommé log.catalog_searches, limitée à la source de log de l’application.
Votre agent peut appeler manage_log_line_action avec :
Pour plus de détails sur ces champs, consultez la référence manage_log_line_action.

​
Étape 2 : Vérifiez la métrique avant de supprimer quoi que ce soit

Une fois qu’AppSignal a reçu des lignes correspondantes, relisez la métrique :
Montre-moi le counter log.catalog_searches pour MyStore production sur les 15 dernières minutes.
Confirmez que le counter enregistre bien les valeurs et que la requête ne correspond qu’aux lignes que vous voulez écarter. AppSignal ne stocke pas les lignes supprimées, vous ne pouvez donc pas les récupérer depuis AppSignal.

​
Étape 3 : Supprimer les lignes correspondantes

Ajoutez une action filter avec la même requête :
Sur MyStore production, ajoute une log line action filter qui supprime les lignes de log correspondant à message:"Type your message here".

​
Étape 4 : Gardez l’action metrics avant le filter

Les nouvelles actions sont ajoutées à la fin de l’ordre, donc le filter s’exécute déjà après l’action metrics. Confirmez l’ordre :
Liste les log line actions sur MyStore production, et garde l’action metrics avant le filter.
Votre agent peut utiliser get_app_resources pour lire l’ordre, puis appeler manage_log_line_action avec action: "reorder" si le filter précède l’action metrics. Si le filter s’exécutait en premier, il supprimerait les lignes avant que l’action metrics ne les compte.

​
Vérifier que cela fonctionne

Une fois qu’AppSignal a appliqué les actions et reçoit de nouvelles lignes correspondantes, vérifiez le résultat :
  1. Lisez la métrique et confirmez qu’elle contient des données issues des nouvelles lignes correspondantes.
  2. Recherchez dans vos logs avec la même requête. Les lignes reçues après l’activation du filter ne devraient plus apparaître.
Si la métrique ne contient aucune nouvelle donnée, ou si des lignes correspondantes continuent d’apparaître, vérifiez la requête et l’ordre des actions. Puis réessayez avec de nouvelles lignes de log.

​
Comportement et limites

  • Les actions ne sont pas rétroactives. Les logs stockés avant la création de l’action restent inchangés.
  • Les modifications dans l’interface gardent les actions associées synchronisées. Modifier la métrique dans l’interface AppSignal met aussi à jour son filter associé. Supprimer le filter via MCP conserve la métrique et désactive la suppression.
  • Les actions créées via MCP sont indépendantes. Pour mesurer et supprimer les mêmes lignes, donnez aux deux actions la même requête et les mêmes sources de log, et mettez à jour les deux lorsque leur configuration change.