MCP Tool Reference

AppSignal MCP biedt 24 tools verdeeld over zeven gebieden: error incidents, performance, anomaly detection, logging, metrics, dashboards en app discovery. Tools omvatten zowel lees- als schrijfoperaties.

​

Workflows

Deze voorbeelden laten zien hoe tools samen werken voor veelvoorkomende taken.

​

Een productiefout onderzoeken

1. Recente open excepties weergeven: “Show me all open incidents in production from the last 24 hours”
2. Volledige details over een specifiek incident ophalen: “Get the details for incident #847 including the stack trace”
3. Traces ophalen om te zien wat er op codeniveau gebeurde: “Get the error traces for incident #847”
4. Uw bevindingen documenteren: “Add a note to incident #847: investigated the database timeout — connection pool was exhausted during peak traffic”
5. Het oplossen: “Close incident #847”

​

Een trage actie profileren

1. Een prestatieoverzicht ophalen: “Which actions are slowest in the web namespace right now?”
2. Traces ophalen voor de slechtste presteerder: “Get traces for BlogPostsController#index from the last hour”
3. De span tree inspecteren om de bottleneck te vinden: “Show me the full span tree for trace abc123”
4. Inzoomen op een specifieke span: “Get the details for span def456 in trace abc123”

​

Een batch incidents triagen

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

​

Logs doorzoeken tijdens een incident

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

​

Een klantreis reconstrueren

Wanneer een gebruiker meldt dat er iets misging, is het antwoord meestal verspreid over logs van meerdere bronnen, plus fouten en traces. Die tijdlijn handmatig aan elkaar plakken is precies het soort werk dat de logging-UI niet voor u kan doen, maar een agent wel.

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

Dit trekt uit get_log_lines, get_exception_incidents en get_traces in één gesprek. De laatste samenvattingsstap is waar MCP zijn waarde bewijst — de agent stelt het verhaal samen, niet u.

​

Logverwerking instellen

AppSignal voert log line actions uit tijdens ingestion, in de volgorde die u definieert. Een veelvoorkomend patroon is om een metric uit te zenden, een trigger aan te maken en vervolgens te filteren — dit zorgt ervoor dat AppSignal het signaal vastlegt voordat de logregel wordt weggegooid.

1. Controleer de bestaande log line actions en hun volgorde: gebruik get_app_resources met sections: ["log_line_actions"]
2. “Create a metrics action that counts log lines where severity is error as log.error_count”
3. “Add a trigger action that fires an alert when severity is fatal”
4. “Add a filter to drop all health check log lines”
5. “Reorder those actions so the metrics action runs first, then the trigger, then the filter”

​

Een trigger voor anomaliedetectie aanmaken

1. Beschikbare metrics ontdekken: “What metrics are available for my production app?”
2. Beschikbare tags controleren: “What tags are available for response_time?”
3. De trigger aanmaken: “Create a trigger that fires when mean response time exceeds 500ms for more than 5 minutes, and notify the Slack #alerts channel”
4. Een oude trigger archiveren zodra deze is vervangen: gebruik get_triggers om eerst de ID te vinden, en vervolgens “Archive the old response_time trigger”

​

Een monitoring-dashboard bouwen

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

---

​

Tool reference

Elke tool vereist app_name en app_environment om te bepalen welke applicatie het doelwit is. Beide worden hoofdletter-ongevoelig vergeleken, dus MyApp/Production en myapp/production verwijzen naar dezelfde applicatie.

​

App discovery

​

get_applications

Haal alle AppSignal-applicaties op waartoe de gebruiker toegang heeft. Retourneert applicaties in app_name/app_environment-formaat. Gebruik dit eerst om beschikbare applicaties te ontdekken voordat u andere tools aanroept. Geen parameters vereist.

---

​

get_app_resources

Ontdek beschikbare bronnen in een AppSignal-applicatie — namespaces, dashboards, gebruikers, notifiers, logbronnen, log line actions en deploy markers. Bijzonder handig bij het instellen van triggers, het toewijzen van incidents of het begrijpen van de structuur van een applicatie.

---

​

Error incidents

​

get_exception_incidents

Lijst en zoek AppSignal-excepties en fouten. Gebruik dit om een overzicht te krijgen van recente excepties, te zoeken binnen een tijdsperiode, incidents per state te vinden of te controleren welke incidents aandacht nodig hebben. Retourneert 50 incidents per pagina.

---

​

get_incident

Haal gedetailleerde informatie op over een AppSignal-incident. Retourneert de huidige state, toewijzing, eerste en laatste keer dat het optrad, foutmeldingen, stack traces of details over anomaly-alerts. Ondersteunt exception- en anomaly-incidents.

---

​

update_incidents

Werk incidents voor een AppSignal-applicatie in bulk bij. Gebruik dit om de incident-state te wijzigen, severity bij te werken of teamleden in één keer aan meerdere incidents toe te wijzen of te verwijderen. Gebruik get_app_resources met sections: ["users"] om gebruikers-ID’s te vinden voor toewijzing.

---

​

create_incident_note

Maak een notitie aan op een AppSignal-incident. Markdown wordt ondersteund. Gebruik dit om opmerkingen, status-updates, onderzoeksbevindingen of oplossingsstappen toe te voegen.

---

​

Performance

​

get_performance

Performance-overzicht: sample-gebaseerde performance-incidents en trage actions uit traces. Voor standaard Ruby- en Elixir-apps retourneert deze sample-gebaseerde performance-incidents. Voor apps die ook OpenTelemetry-traces verzenden, retourneert deze daarnaast een gerangschikte lijst van actions met gemiddelde duur, throughput en error rate. Apps die worden gemigreerd naar OpenTelemetry kunnen beide retourneren. Vervolg-tools: gebruik get_incident om een specifiek performance-incident te inspecteren, get_traces om sample traces voor een trage action op te halen en update_incidents om state, severity of assignees te wijzigen.

---

​

get_traces

Vraag performance- en error traces op, inspecteer span trees en bekijk spandetails. Ondersteunt twee soorten traces:

• Performance traces — geïdentificeerd door namespace en action_name. Gebruik deze om trage requests te onderzoeken.
• Error traces — geïdentificeerd door digest. Haal de digest op uit get_incident of get_exception_incidents, en gebruik deze hier om de daadwerkelijke error traces te zien.

Elk tracetype ondersteunt drie modi:

1. List mode — vind traces en haal trace-ID’s op. Geef namespace + action_name op, of digest.
2. Tree mode — geef een trace_id door om alle spans als een compacte boom te zien.
3. Span detail mode — geef trace_id en span_id door voor volledige spanattributen, events en resource-info.

De typische workflow is: traces oplijsten → een trace tree inspecteren → inzoomen op een span.

---

​

Anomaly detection

​

get_anomaly_incidents

Lijst en zoek alerts van AppSignal-anomaliedetectie. Retourneert 50 alerts per pagina, inclusief tijdstempels en waarden voor elke alert.

---

​

get_triggers

Lijst de anomaliedetectie-triggers voor een AppSignal-applicatie. Retourneert actieve (niet-gearchiveerde) triggers met hun volledige configuratie — voorwaarden, notifiers en dashboard-links. Gebruik dit om trigger-ID’s te vinden voordat u manage_trigger of archive_trigger aanroept.

---

​

manage_trigger

Maak een anomaliedetectie-trigger aan of werk deze bij. Triggers zijn onveranderlijk. Wanneer u een trigger bijwerkt, archiveert AppSignal de bestaande (sluit alle bijbehorende alerts en incidents) en maakt een nieuwe aan met een versie-keten-referentie. Geef alle velden op voor zowel aanmaak- als update-operaties. Gebruik get_metric_names en get_metric_tags om beschikbare metrics en velden te ontdekken. Gebruik get_app_resources(sections: ["notifiers"]) om notifier-ID’s te vinden.

---

​

archive_trigger

Archiveer een anomaliedetectie-trigger en sluit alle bijbehorende alerts en incidents. Idempotent — doet niets als de trigger al is gearchiveerd. Gebruik get_triggers om de trigger-ID te vinden.

---

​

Logging

​

get_log_lines

Vraag logregels op met de expressie-syntaxis van AppSignal. Ondersteunt exact match, contains, negatie, numerieke vergelijkingen, booleaanse logica en geneste attributen. Retourneert maximaal 100 regels per call, standaard nieuwste eerst. Voor grote tijdsbereiken, splits in meerdere calls en itereer voorwaarts. Query-syntaxis: Beschikbare velden: severity, hostname, group, message en eventuele custom attributen.

---

​

manage_log_line_action

Maak een log line action aan of werk deze bij. Log line actions worden uitgevoerd tijdens log-ingestion, in de volgorde die u definieert. Er zijn drie types:

• filter — gooit overeenkomende logregels weg, zodat ze nooit worden opgeslagen of verder verwerkt
• trigger — vuurt alerts en incidents af wanneer de query overeenkomt
• metrics — extraheert counter-, gauge- of distributie-metrics uit overeenkomende logregels

Volgorde van uitvoering is belangrijk: als een filter een logregel weggooit, zien volgende actions deze nooit. Een veelvoorkomend patroon is om metric- en trigger-actions vóór eventuele filter-actions te plaatsen. Gebruik reorder_log_line_actions om de volgorde na aanmaak te wijzigen. Nieuwe actions worden achteraan in de uitvoeringsvolgorde toegevoegd.

---

​

reorder_log_line_actions

Wijzig de uitvoeringsvolgorde van log line actions. Geef action-ID’s in de gewenste volgorde door. Action-ID’s die niet zijn opgenomen, worden aan het einde toegevoegd in hun huidige relatieve volgorde. Gebruik get_app_resources(sections: ["log_line_actions"]) om ID’s te vinden en de huidige volgorde te zien.

---

​

delete_log_line_action

Verwijder een log line action permanent. Gebruik eerst get_app_resources(sections: ["log_line_actions"]) om de action-ID te vinden.

---

​

Metrics

​

discover_metrics

Ontdek beschikbare metric-categorieën en hun metrics voor monitoring. Gebruik dit om een overzicht te krijgen van wat u kunt monitoren, of om in te zoomen op een specifieke categorie. Accepteert ook een dashboard:id-verwijzing om metrics weer te geven die in een specifiek dashboard worden gebruikt.

---

​

get_metric_names

Haal de namen op van alle metrics voor de gegeven applicatie. Retourneert metric-namen als een door komma’s gescheiden string. Gebruik deze als invoer voor get_metric_tags, get_metrics_timeseries en get_metrics_list.

---

​

get_metric_tags

Haal de tags en het metric-type (Gauge, Counter, enz.) op voor een specifieke metric. Gebruik de resultaten om geldige queries te bouwen met get_metrics_timeseries en get_metrics_list.

---

​

get_metrics_timeseries

Haal een tijdreeks op voor een metric in de gegeven applicatie. Retourneert punt-voor-punt-gegevens voor een gegeven tijdsbereik, metric-type en tag-combinatie. Tagwaarden ondersteunen wildcard-matching met *.

---

​

get_metrics_list

Haal een geaggregeerde waarde op voor een metric over een tijdsbereik. Retourneert één geaggregeerde waarde in plaats van een punt-voor-punt-tijdreeks. Handig voor overzichtsweergaven.

---

​

Dashboards

​

manage_dashboard

Maak een AppSignal-dashboard aan of werk het bij. Deze tool beheert alleen de metadata van het dashboard (titel en beschrijving). Gebruik create_dashboard_visual en update_dashboard_visual om grafieken toe te voegen.

---

​

create_dashboard_visual

Voeg een nieuwe grafiek of diagram toe aan een bestaand dashboard. Gebruik eerst discover_metrics of get_metrics_list om beschikbare metrics te vinden.

---

​

update_dashboard_visual

Werk een bestaande grafiek of diagram op een dashboard bij. Alle velden zijn optioneel behalve de identifiers. Niet-gespecificeerde velden behouden hun huidige waarden. Als metrics is opgegeven, vervangt het alle bestaande metrics op die visual.

---

​

Tokenrechten

Elk MCP-token heeft configureerbare rechten per toolset: app, exceptions, performance, metrics, anomalies, dashboards, logging. Elke toolset kan worden ingesteld op read, write of uitgeschakeld. Tokens kunnen ook worden beperkt tot specifieke applicaties en zo worden ingesteld dat nieuwe tools automatisch beschikbaar worden gemaakt zodra ze worden toegevoegd. Een token genereren:

1. Selecteer uw profielpictogram.
2. Ga naar Account Settings.
3. Selecteer MCP Tokens om een nieuw token aan te maken.

---

​

Mist u een tool?