Référence des outils MCP - AppSignal Documentation

AppSignal MCP expose 24 outils répartis sur sept domaines : incidents d’erreur, performance, Anomaly detection, journalisation, métriques, tableaux de bord et découverte d’applications. Les outils comprennent à la fois des opérations de lecture et d’écriture.

Flux de travail

Ces exemples montrent comment les outils se combinent pour des tâches courantes.

Enquête sur une erreur en production

Lister les exceptions ouvertes récentes : « Show me all open incidents in production from the last 24 hours »
Obtenir les détails complets sur un incident spécifique : « Get the details for incident #847 including the stack trace »
Récupérer les traces pour voir ce qui s’est passé au niveau du code : « Get the error traces for incident #847 »
Documenter vos conclusions : « Add a note to incident #847: investigated the database timeout — connection pool was exhausted during peak traffic »
La résoudre : « Close incident #847 »

Profilage d’une action lente

Obtenir un aperçu des performances : « Which actions are slowest in the web namespace right now? »
Récupérer les traces pour le pire contrevenant : « Get traces for BlogPostsController#index from the last hour »
Inspecter l’arbre des spans pour trouver le goulot d’étranglement : « Show me the full span tree for trace abc123 »
Plonger dans un span spécifique : « Get the details for span def456 in trace abc123 »

Triage d’un lot d’incidents

« Find all open incidents in the background namespace from the last week »
« Mark incidents #120, #121, and #122 as work in progress and assign them to Jana »
« Close all incidents related to ActionMailer — they were fixed in the last deploy »

Recherche de journaux pendant un incident

« Find all error logs from the last hour »
« Show me logs where message contains ‘timeout’ on web-1 between 14:00 and 15:00 »
« Get fatal logs from the payments source over the last 30 minutes »

Reconstruction du parcours d’un client

Lorsqu’un utilisateur signale qu’un problème est survenu, la réponse est généralement répartie sur les journaux de plusieurs sources, ainsi que sur les erreurs et les traces. Recoller cette chronologie à la main est le genre de travail que l’interface de journalisation ne peut pas faire pour vous, mais qu’un agent peut faire.

« Get all logs for user.id=4321 from production over the last 24 hours, across every source »
« Narrow that to the window between 14:00 and 15:30 UTC and group the results by source »
« List any open exception incidents from production in that same window — anything tagged with user.id=4321? »
« For incident #903, pull the error traces and walk the span tree »
« Summarize what happened: which actions did this user hit, what failed, and where did the error originate? »

Cela utilise get_log_lines, get_exception_incidents et get_traces dans une seule conversation. L’étape finale de résumé est là où MCP justifie son intérêt — l’agent compose le récit, pas vous.

Configuration du traitement des journaux

AppSignal exécute les actions de ligne de journal lors de l’ingestion, dans l’ordre que vous définissez. Un modèle courant consiste à émettre une métrique, créer un déclencheur, puis filtrer — cela garantit qu’AppSignal capture le signal avant d’écarter la ligne de journal.

Vérifier les actions de ligne de journal existantes et leur ordre : utilisez get_app_resources avec sections: ["log_line_actions"]
« Create a metrics action that counts log lines where severity is error as log.error_count »
« Add a trigger action that fires an alert when severity is fatal »
« Add a filter to drop all health check log lines »
« Reorder those actions so the metrics action runs first, then the trigger, then the filter »

Création d’un déclencheur de Anomaly detection

Découvrir les métriques disponibles : « What metrics are available for my production app? »
Vérifier les tags disponibles : « What tags are available for response_time? »
Créer le déclencheur : « Create a trigger that fires when mean response time exceeds 500ms for more than 5 minutes, and notify the Slack #alerts channel »
Archiver un ancien déclencheur une fois remplacé : utilisez get_triggers pour trouver d’abord l’ID, puis « Archive the old response_time trigger »

Construction d’un tableau de bord de surveillance

« What metrics are available for my production app? »
« Create a dashboard called ‘API Health’ in production »
« Add a line chart of p95 response time by action to the API Health dashboard »
« Add an area chart of error rate broken down by namespace »

Référence des outils

Chaque outil prend app_name et app_environment pour identifier l’application cible. Les deux sont mis en correspondance sans tenir compte de la casse, donc MyApp/Production et myapp/production se résolvent vers la même application. Si le nom ne correspond à aucune application à laquelle vous avez accès, l’outil renvoie une erreur qui liste les applications qui vous sont disponibles, afin que l’agent puisse réessayer avec un nom valide.

Découverte d’applications

`get_applications`

Obtenez toutes les applications AppSignal auxquelles l’utilisateur a accès. Retourne les applications au format app_name/app_environment. Utilisez-le d’abord pour découvrir les applications disponibles avant d’appeler d’autres outils. Aucun paramètre requis.

`get_app_resources`

Découvrez les ressources disponibles dans une application AppSignal — namespaces, tableaux de bord, utilisateurs, notifieurs, sources de journaux, actions de ligne de journal, marqueurs de déploiement et moniteurs de disponibilité. Particulièrement utile lors de la configuration de déclencheurs, de l’attribution d’incidents ou de la compréhension de la structure d’une application.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement (par exemple `production`, `staging`).
`sections`	non	Sections à récupérer : `users`, `notifiers`, `namespaces`, `dashboards`, `log_sources`, `log_line_actions`, `log_views`, `deploy_markers`, `uptime_monitors`. Retourne tout si non spécifié.
`deploy_marker_namespace`	non	N’afficher que les déploiements dans cet namespace (par exemple `web`).
`deploy_marker_revision`	non	N’afficher que les déploiements avec cette révision. Un préfixe court fonctionne (par exemple `a1b2c3d`).

La section deploy_markers retourne jusqu’à 100 déploiements récents, chacun avec sa révision complète et la plage horaire pendant laquelle il était actif. Restreignez-la avec deploy_marker_namespace ou deploy_marker_revision. Pour trouver les erreurs qu’un déploiement a introduites, passez sa révision à get_exception_incidents (ou utilisez revision: "last" pour le déploiement le plus récent). La section uptime_monitors liste chaque URL surveillée et ses paramètres. La disponibilité elle-même n’est pas stockée — elle est calculée à partir de métriques, donc interrogez le compteur uptime_monitor_error_count avec get_metrics_timeseries pour la calculer.

Incidents d’erreur

`get_exception_incidents`

Listez et recherchez les exceptions et erreurs AppSignal. Utilisez-le pour obtenir un aperçu des exceptions récentes, rechercher dans une période, trouver des incidents par état, ou vérifier quels incidents nécessitent attention. Retourne 50 incidents par page.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`namespaces`	non	Liste séparée par des virgules des namespaces à filtrer (par exemple `web,background`).
`start`	non	Début de la plage horaire au format ISO 8601. Par défaut, le déploiement le plus récent si omis.
`end`	non	Fin de la plage horaire au format ISO 8601. Requis si `start` est fourni.
`states`	non	États séparés par des virgules : `open`, `closed`, `wip`. Retourne tous les états si non spécifié.
`page`	non	Numéro de page (basé sur 1, par défaut 1).

`get_incident`

Obtenez des informations détaillées sur un incident AppSignal. Retourne l’état actuel, l’attribution, la première et la dernière occurrence, les messages d’erreur, les traces de pile ou les détails de l’alerte d’anomalie. Prend en charge les incidents d’exception et d’anomalie.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`number`	oui	L’ID numérique de l’incident affiché dans les URL et listes d’incidents AppSignal.

`update_incidents`

Mettez à jour en masse les incidents d’une application AppSignal. Utilisez-le pour modifier l’état d’incidents, mettre à jour la gravité ou attribuer et désattribuer des membres d’équipe sur plusieurs incidents à la fois. Utilisez get_app_resources avec sections: ["users"] pour trouver les ID utilisateur pour l’attribution.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`incidents`	non	Liste des numéros d’incident à mettre à jour (par exemple `[123, 456, 789]`).
`state`	non	`open`, `closed` ou `wip` (work in progress).
`severity`	non	`critical`, `high`, `low`, `none`, `informational` ou `untriaged`.
`assign_users`	non	Liste des ID utilisateur à attribuer comme gestionnaires.
`unassign_users`	non	Liste des ID utilisateur à retirer de l’incident.

`manage_incident_note`

Créez ou mettez à jour une note sur un incident AppSignal. Markdown est pris en charge. Utilisez-le pour ajouter des commentaires, mises à jour de statut, conclusions d’enquête ou étapes de résolution. Incluez une URL complète d’issue GitHub dans la note pour lier cette issue à l’incident, lorsque GitHub est configuré pour l’application.

Cet outil s’appelait auparavant create_incident_note. L’ancien nom fonctionne toujours comme alias, afin que les invites et configurations existantes continuent de fonctionner.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`number`	oui	L’ID numérique de l’incident.
`content`	oui	Contenu de la note. Le formatage Markdown est pris en charge.
`id`	non	ID d’une note existante à mettre à jour. Omettez pour créer une nouvelle note. Vous ne pouvez modifier que les notes que vous avez rédigées.

Performance

`get_performance`

Aperçu des performances : incidents de performance basés sur des échantillons et actions lentes à partir des traces. Pour les applications Ruby et Elixir standard, retourne les incidents de performance basés sur des échantillons. Pour les applications qui envoient également des traces OpenTelemetry, retourne en plus une liste classée d’actions avec la durée moyenne, le débit et le taux d’erreur. Les applications en cours de migration vers OpenTelemetry peuvent retourner les deux. Outils de suivi : utilisez get_incident pour inspecter un incident de performance spécifique, get_traces pour récupérer des traces d’échantillon pour une action lente, et update_incidents pour modifier l’état, la gravité ou les attributions.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`namespaces`	non	Namespaces séparés par des virgules. S’applique à la fois aux incidents de performance et aux actions OpenTelemetry.
`start`	non	Début de la plage horaire au format ISO 8601. Par défaut, le déploiement le plus récent pour les incidents basés sur des échantillons, ou il y a 24 heures pour les actions OpenTelemetry.
`end`	non	Fin de la plage horaire au format ISO 8601. Requis si `start` est fourni.
`states`	non	États séparés par des virgules : `open`, `closed`, `wip`. S’applique uniquement aux incidents basés sur des échantillons.
`revision`	non	Limiter à un déploiement spécifique. Utilisez `"last"` pour le déploiement le plus récent, ou passez un hash de révision. Ignoré lorsque `start`/`end` est fourni. Utilisez `get_app_resources(sections: ["deploy_markers"])` pour lister les révisions disponibles.
`page`	non	Numéro de page pour les incidents basés sur des échantillons (basé sur 1, par défaut 1). Les actions OpenTelemetry sont retournées sous forme de liste classée complète.

`get_traces`

Interrogez les traces de performance et d’erreur, inspectez les arbres de spans et consultez les détails des spans. Prend en charge deux types de traces :

Traces de performance — identifiées par le namespace et action_name. Utilisez-les pour enquêter sur des requêtes lentes.
Traces d’erreur — identifiées par digest. Obtenez le digest depuis get_incident ou get_exception_incidents, puis utilisez-le ici pour voir les traces d’erreur réelles.

Chaque type de trace prend en charge trois modes :

Mode liste — trouvez des traces et obtenez les ID de trace. Fournissez le namespace + action_name, ou digest.
Mode arbre — passez un trace_id pour voir tous les spans sous forme d’arbre compact.
Mode détail de span — passez trace_id et span_id pour les attributs de span complets, les événements et les informations de ressource.

Le flux de travail typique est : lister les traces → inspecter un arbre de trace → plonger dans un span.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`namespace`	oui (performance)	L’namespace dans lequel rechercher (par exemple `web`, `background`). Non nécessaire pour les traces d’erreur.
`action_name`	oui (performance)	Le nom de l’action (par exemple `BlogPostsController#index`). Non nécessaire pour les traces d’erreur.
`digest`	oui (erreur)	Le digest de l’incident d’exception. Bascule en mode trace d’erreur. Ne peut pas être combiné avec `namespace` ou `action_name`.
`trace_id`	non	Bascule en mode arbre. Retourne tous les spans pour cette trace.
`span_id`	non	Bascule en mode détail de span. Nécessite `trace_id`.
`start`	non	Début de la plage horaire au format ISO 8601. Par défaut, il y a 24 heures. Traces de performance uniquement.
`end`	non	Fin de la plage horaire au format ISO 8601. Par défaut, maintenant. Traces de performance uniquement.
`min_duration_ms`	non	Filtrer les traces plus lentes que ce seuil en millisecondes. Mode liste uniquement.
`limit`	non	Nombre maximum de traces à retourner (1–100, par défaut 25). Mode liste uniquement.

Anomaly detection

`get_anomaly_incidents`

Listez et recherchez les alertes de Anomaly detection AppSignal. Retourne 50 alertes par page, y compris les horodatages et valeurs pour chaque alerte.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`state`	non	`open`, `closed`, `warmup`, `cooldown` ou `archived`. Retourne tous les états si non spécifié.
`trigger_id`	non	Filtrer les incidents d’un déclencheur spécifique. Utilisez `get_triggers` pour trouver les ID de déclencheur.
`page`	non	Numéro de page (basé sur 1, par défaut 1).

`get_triggers`

Listez les déclencheurs de Anomaly detection pour une application AppSignal. Retourne les déclencheurs actifs (non archivés) avec leur configuration complète — conditions, notifieurs et liens vers les tableaux de bord. Utilisez-le pour trouver les ID de déclencheur avant d’appeler manage_trigger ou archive_trigger.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_name`	non	Filtrer par nom de métrique (par exemple `response_time`, `error_rate`).
`kind`	non	Filtrer par type de déclencheur.
`tags`	non	Filtrer par tags, par exemple `[{"key": "hostname", "value": "web-1"}]`.
`page`	non	Numéro de page (basé sur 1, par défaut 1).

`manage_trigger`

Créer ou mettre à jour un déclencheur de Anomaly detection. Les déclencheurs sont immuables. Lorsque vous mettez à jour un déclencheur, AppSignal archive celui existant (fermant toutes ses alertes et incidents) et en crée un nouveau avec une référence de chaîne de versions. Fournissez tous les champs pour les opérations de création et de mise à jour. Utilisez get_metric_names et get_metric_tags pour découvrir les métriques et champs disponibles. Utilisez get_app_resources(sections: ["notifiers"]) pour trouver les ID de notifieur.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_name`	oui	La métrique que ce déclencheur surveille.
`kind`	oui	Type de déclencheur. Utilisez `"Advanced"` pour les métriques personnalisées.
`field`	oui	Champ de métrique à comparer : `gauge`, `mean`, `p90`, `p95`, `counter` ou `count`.
`condition_value`	oui	Valeur seuil (par exemple `500.0` pour « response time > 500ms »).
`comparison_operator`	oui	`<`, `>`, `<=`, `>=`, `==` ou `!=`.
`warmup_duration`	oui	Minutes pendant lesquelles la condition doit être remplie avant qu’une alerte ne s’ouvre. Utilisez `0` pour immédiat.
`cooldown_duration`	oui	Minutes pendant lesquelles la condition ne doit plus être remplie avant qu’une alerte ne se ferme.
`id`	non	ID d’un déclencheur existant à mettre à jour. Si fourni, archive l’ancien déclencheur et en crée un nouveau.
`notifier_ids`	non	ID des notifieurs vers lesquels envoyer les alertes.
`tags`	non	Filtres de tags pour limiter quelles métriques sont incluses. Prend en charge les caractères génériques (`*`).
`name`	non	Nom d’affichage. Par défaut, le nom de la métrique si non fourni.
`description`	non	Description de ce que ce déclencheur surveille et de ce qu’il faut faire lorsqu’il se déclenche.
`dashboard_id`	non	ID du tableau de bord à lier dans les notifications.
`no_match_is_zero`	non	Si vrai, traiter les données métriques manquantes comme 0. Utile pour les compteurs qui peuvent ne pas signaler lorsqu’ils sont inactifs.
`format`	non	Format des données de la métrique (par exemple `duration`, `size`, `percent`).

`archive_trigger`

Archiver un déclencheur de Anomaly detection et fermer toutes les alertes et incidents associés. Idempotent — n’effectue aucune opération si le déclencheur est déjà archivé. Utilisez get_triggers pour trouver l’ID du déclencheur.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`id`	oui	ID du déclencheur à archiver.

Journalisation

`get_log_lines`

Interrogez les lignes de journal en utilisant la syntaxe d’expression d’AppSignal. Prend en charge la correspondance exacte, contient, la négation, les comparaisons numériques, la logique booléenne et les attributs imbriqués. Retourne jusqu’à 100 lignes par appel, du plus récent au plus ancien par défaut. Pour les grandes plages horaires, divisez en plusieurs appels et itérez vers l’avant. Syntaxe de requête :

Modèle	Exemple
Correspondance exacte	`severity=error`
Contient	`message:timeout`
Ne contient pas	`message!:debug`
Non égal	`hostname!=web-1`
Comparaison numérique	`duration>100`
Logique booléenne	`severity=error AND (hostname=web-1 OR hostname=web-2)`
Valeurs entre guillemets	`group="background jobs"`
Attributs imbriqués	`user.id=123`

Champs disponibles : severity, hostname, group, message et tout attribut personnalisé.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`query`	oui	Requête d’expression. Utilisez une chaîne vide pour récupérer tous les journaux.
`source_ids`	non	ID des sources de journaux à interroger. Interroge toutes les sources si non spécifié. Utilisez `get_app_resources(sections: ["log_sources"])` pour trouver les ID de source.
`start`	non	Début de la plage horaire au format ISO 8601. Par défaut, une fenêtre de requête plus tôt.
`end`	non	Fin de la plage horaire au format ISO 8601. Par défaut, maintenant.
`limit`	non	Nombre de lignes de journal à retourner (1–100, par défaut 50).
`order`	non	`desc` (du plus récent au plus ancien, par défaut) ou `asc` (du plus ancien au plus récent).

`manage_log_line_action`

Créer ou mettre à jour une action de ligne de journal. Les actions de ligne de journal s’exécutent pendant l’ingestion des journaux, dans l’ordre que vous définissez. Il existe trois types :

filter — écarte les lignes de journal correspondantes afin qu’elles ne soient jamais stockées ni traitées
trigger — déclenche des alertes et incidents lorsque la requête correspond
metrics — extrait des métriques de compteur, jauge ou distribution à partir des lignes de journal correspondantes

L’ordre d’exécution est important : si un filtre écarte une ligne de journal, les actions suivantes ne la verront jamais. Un modèle courant consiste à placer les actions de métriques et de déclencheurs avant toute action de filtre. Utilisez reorder_log_line_actions pour modifier l’ordre après la création. Les nouvelles actions sont ajoutées à la fin de l’ordre d’exécution.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`name`	oui (création)	Nom de l’action (par exemple `"Drop health checks"`, `"Track error count"`).
`query`	oui (création)	Expression de requête à comparer aux lignes de journal.
`action_type`	oui (création)	`filter`, `trigger` ou `metrics`. Ne peut pas être modifié lors d’une mise à jour.
`id`	non	ID d’une action existante à mettre à jour. Si omis, crée une nouvelle action.
`source_ids`	non	ID des sources de journaux auxquelles cette action s’applique. S’applique à toutes les sources si non spécifié.
`log_line_metrics`	non	Définitions de métriques à extraire. Requis lors de la création d’une action `metrics`. Chaque métrique requiert `name` et `metric_type` (`counter`, `gauge` ou `distribution`). `gauge` et `distribution` requièrent également un `field` pour extraire la valeur. Lors d’une mise à jour, remplace toutes les définitions de métriques existantes.

`reorder_log_line_actions`

Modifier l’ordre d’exécution des actions de ligne de journal. Fournissez les ID d’action dans l’ordre souhaité. Les ID d’action non inclus sont ajoutés à la fin dans leur ordre relatif actuel. Utilisez get_app_resources(sections: ["log_line_actions"]) pour trouver les ID et voir l’ordre actuel.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`action_ids`	oui	Liste ordonnée des ID d’actions de ligne de journal. Le premier ID de la liste est exécuté en premier pendant l’ingestion.

`delete_log_line_action`

Supprimer définitivement une action de ligne de journal. Utilisez get_app_resources(sections: ["log_line_actions"]) pour d’abord trouver l’ID de l’action.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`id`	oui	ID de l’action de ligne de journal à supprimer.

Métriques

`discover_metrics`

Découvrez les catégories de métriques disponibles et leurs métriques pour la surveillance. Utilisez-le pour obtenir un aperçu de ce que vous pouvez surveiller, ou pour explorer une catégorie spécifique. Accepte également une référence dashboard:id pour afficher les métriques utilisées dans un tableau de bord spécifique.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_subject`	non	Nom de la catégorie de métrique (par exemple `performance_metrics`, `host_metrics`) ou une référence `dashboard:id`.

`get_metric_names`

Obtenez les noms de toutes les métriques pour l’application donnée. Retourne les noms des métriques sous forme de chaîne séparée par des virgules. Utilisez-les comme entrée pour get_metric_tags, get_metrics_timeseries et get_metrics_list.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.

`get_metric_tags`

Obtenez les tags et le type de métrique (Gauge, Counter, etc.) pour une métrique spécifique. Utilisez les résultats pour construire des requêtes valides avec get_metrics_timeseries et get_metrics_list.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_name`	oui	Nom de la métrique. Utilisez `get_metric_names` pour trouver les métriques disponibles.

`get_metrics_timeseries`

Obtenez une série chronologique pour une métrique dans l’application donnée. Retourne des données point par point pour une plage horaire, un type de métrique et une combinaison de tags donnés. Les valeurs des tags prennent en charge la correspondance par caractère générique avec *.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_name`	oui	Nom de la métrique.
`metric_type`	oui	`COUNT`, `COUNTER`, `GAUGE`, `MEAN`, `P90` ou `P95`. Utilisez `get_metric_tags` pour trouver le type valide.
`start`	oui	Début de la plage horaire au format ISO 8601.
`end`	oui	Fin de la plage horaire au format ISO 8601.
`tags`	non	Filtres de tags, par exemple `[{"key": "hostname", "value": "web"}]`. Prend en charge les caractères génériques ``.

`get_metrics_list`

Obtenez une valeur agrégée pour une métrique sur une plage horaire. Retourne une seule valeur agrégée plutôt qu’une série chronologique point par point. Utile pour les vues récapitulatives.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`metric_name`	oui	Nom de la métrique.
`metric_type`	oui	`COUNT`, `COUNTER`, `GAUGE`, `MEAN`, `P90` ou `P95`.
`start`	oui	Début de la plage horaire au format ISO 8601.
`end`	oui	Fin de la plage horaire au format ISO 8601.
`tags`	non	Filtres de tags, par exemple `[{"key": "hostname", "value": "frontend1"}]`.

Tableaux de bord

`manage_dashboard`

Créer ou mettre à jour un tableau de bord AppSignal. Cet outil gère uniquement les métadonnées du tableau de bord (titre et description). Utilisez create_dashboard_visual et update_dashboard_visual pour ajouter des graphiques.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`title`	oui	Titre du tableau de bord.
`description`	non	Description de l’objectif et du contenu du tableau de bord.
`id`	non	ID du tableau de bord pour mettre à jour un tableau de bord existant. Omettez pour en créer un nouveau.

`create_dashboard_visual`

Ajoutez un nouveau graphique à un tableau de bord existant. Utilisez discover_metrics ou get_metrics_list pour trouver d’abord les métriques disponibles.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`dashboard_id`	oui	ID du tableau de bord auquel ajouter le visuel.
`title`	oui	Titre du graphique.
`metrics`	oui	Tableau de métriques à afficher. Chacune requiert `name`, `fields` (par exemple `mean`, `p90`, `p95`, `count`) et facultativement `tags`.
`description`	non	Contexte supplémentaire sur le visuel.
`display`	non	`line` (par défaut), `area` ou `area_relative`.
`line_label`	non	Étiquette personnalisée pour les lignes du graphique. Prend en charge les remplacements `%name%`, `%field%` et `%tag%`.
`format`	non	Format de valeur, par exemple `duration`, `size`, `percentage`.
`draw_null_as_zero`	non	Indique s’il faut dessiner les points de données manquants comme zéro. Par défaut : `false`.
`min_y_axis`	non	Valeur minimale de l’axe Y.
`tags`	non	Tags globaux appliqués à toutes les métriques de ce visuel.

`update_dashboard_visual`

Mettez à jour un graphique existant sur un tableau de bord. Tous les champs sont facultatifs sauf les identifiants. Les champs non spécifiés conservent leurs valeurs actuelles. Si metrics est fourni, il remplace toutes les métriques existantes sur ce visuel.

Paramètre	Requis	Description
`app_name`	oui	Nom de l’application AppSignal.
`app_environment`	oui	Environnement.
`visual_id`	oui	ID du composant visuel à mettre à jour.
`title`	non	Nouveau titre. Le titre actuel est conservé si non fourni.
`description`	non	Nouvelle description. Définir sur une chaîne vide pour supprimer.
`metrics`	non	Tableau de métriques mis à jour. Remplace toutes les métriques existantes si fourni.
`display`	non	`line`, `area` ou `area_relative`.
`line_label`	non	Étiquette personnalisée pour les lignes du graphique. Prend en charge les remplacements `%name%`, `%field%` et `%tag%`.
`format`	non	Format de valeur, par exemple `duration`, `size`, `percentage`.
`draw_null_as_zero`	non	Indique s’il faut dessiner les points de données manquants comme zéro.
`min_y_axis`	non	Valeur minimale de l’axe Y.
`tags`	non	Tags globaux. Remplace les tags globaux existants si fourni.

Permissions des tokens

Chaque token MCP a des permissions configurables par ensemble d’outils : app, exceptions, performance, metrics, anomalies, dashboards, logging. Chaque ensemble d’outils peut être défini sur read, write ou désactivé. Les tokens peuvent également être limités à des applications spécifiques et configurés pour exposer automatiquement les nouveaux outils à mesure qu’ils sont ajoutés. Pour connaître les étapes de création, consultez Authentification.

Un outil manquant ?

En complément des jeux d’outils ci-dessus, AppSignal MCP expose get_more_tools, un outil de découverte et de retour d’expérience. Il ne débloque aucun outil caché aujourd’hui. À la place, il confirme la liste actuelle des outils et journalise ce que vous avez demandé, afin que l’équipe AppSignal puisse voir vers quelles capacités les utilisateurs se tournent. get_more_tools prend deux paramètres :

Paramètre	Requis	Description
`description`	oui	La capacité que vous recherchez, en langage naturel. Ce texte est journalisé comme votre demande de fonctionnalité.
`context`	oui	Pourquoi vous appelez l’outil. Suivi interne uniquement — cela ne change pas la réponse.

La plupart des agents n’y auront pas recours d’eux-mêmes, il faut donc demander explicitement : « Utilise l’outil AppSignal get_more_tools pour chercher un moyen d’exporter en masse les incidents au format CSV. » Le serveur répond que la liste complète des outils est déjà affichée et que votre demande a été journalisée sur votre compte et votre organisation. Rien de nouveau n’est renvoyé à l’agent — la valeur réside dans la demande journalisée.

Vous butez sur les limites du jeu d’outils actuel ? Demandez à votre agent d’appeler get_more_tools, puis publiez la même demande dans la communauté Discord afin que l’équipe AppSignal puisse l’évaluer.

​Flux de travail

​Enquête sur une erreur en production

​Profilage d’une action lente

​Triage d’un lot d’incidents

​Recherche de journaux pendant un incident

​Reconstruction du parcours d’un client

​Configuration du traitement des journaux

​Création d’un déclencheur de Anomaly detection

​Construction d’un tableau de bord de surveillance

​Référence des outils

​Découverte d’applications

​get_applications

​get_app_resources

​Incidents d’erreur

​get_exception_incidents

​get_incident

​update_incidents

​manage_incident_note

​Performance

​get_performance

​get_traces

​Anomaly detection

​get_anomaly_incidents

​get_triggers

​manage_trigger

​archive_trigger

​Journalisation

​get_log_lines

​manage_log_line_action

​reorder_log_line_actions

​delete_log_line_action

​Métriques

​discover_metrics

​get_metric_names

​get_metric_tags

​get_metrics_timeseries

​get_metrics_list

​Tableaux de bord

​manage_dashboard

​create_dashboard_visual

​update_dashboard_visual

​Permissions des tokens

​Un outil manquant ?

Flux de travail

Enquête sur une erreur en production

Profilage d’une action lente

Triage d’un lot d’incidents

Recherche de journaux pendant un incident

Reconstruction du parcours d’un client

Configuration du traitement des journaux

Création d’un déclencheur de Anomaly detection

Construction d’un tableau de bord de surveillance

Référence des outils

Découverte d’applications

`get_applications`

`get_app_resources`

Incidents d’erreur

`get_exception_incidents`

`get_incident`

`update_incidents`

`manage_incident_note`

Performance

`get_performance`

`get_traces`

Anomaly detection

`get_anomaly_incidents`

`get_triggers`

`manage_trigger`

`archive_trigger`

Journalisation

`get_log_lines`

`manage_log_line_action`

`reorder_log_line_actions`

`delete_log_line_action`

Métriques

`discover_metrics`

`get_metric_names`

`get_metric_tags`

`get_metrics_timeseries`

`get_metrics_list`

Tableaux de bord

`manage_dashboard`

`create_dashboard_visual`

`update_dashboard_visual`

Permissions des tokens

Un outil manquant ?