> ## Documentation Index > Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving (bijv. `production`, `staging`). | | `sections` | nee | Op te halen secties: `users`, `notifiers`, `namespaces`, `dashboards`, `log_sources`, `log_line_actions`, `log_views`, `deploy_markers`. Retourneert alles indien niet gespecificeerd. | *** ### 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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | ------------------------------------------------------------------------------------------------------------ | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `namespaces` | nee | Door komma's gescheiden lijst met namespaces om op te filteren (bijv. `web,background`). | | `start` | nee | Begin van het tijdsbereik in ISO 8601-formaat. Standaard de meest recente deploy indien weggelaten. | | `end` | nee | Einde van het tijdsbereik in ISO 8601-formaat. Vereist als `start` is opgegeven. | | `states` | nee | Door komma's gescheiden states: `open`, `closed`, `wip`. Retourneert alle states indien niet gespecificeerd. | | `page` | nee | Paginanummer (1-gebaseerd, standaard 1). | *** #### `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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | --------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `number` | ja | De numerieke incident-ID die in AppSignal-URL's en incidentlijsten wordt getoond. | *** #### `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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | --------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `incidents` | nee | Lijst met incidentnummers om bij te werken (bijv. `[123, 456, 789]`). | | `state` | nee | `open`, `closed` of `wip` (work in progress). | | `severity` | nee | `critical`, `high`, `low`, `none`, `informational` of `untriaged`. | | `assign_users` | nee | Lijst met gebruikers-ID's om als handlers toe te wijzen. | | `unassign_users` | nee | Lijst met gebruikers-ID's om uit het incident te verwijderen. | *** #### `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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | --------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `number` | ja | De numerieke incident-ID. | | `content` | ja | Inhoud van de notitie. Markdown-opmaak wordt ondersteund. | *** ### 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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `namespaces` | nee | Door komma's gescheiden namespaces. Geldt voor zowel performance-incidents als OpenTelemetry-actions. | | `start` | nee | Begin van het tijdsbereik in ISO 8601-formaat. Standaard de meest recente deploy voor sample-gebaseerde incidents, of 24 uur geleden voor OpenTelemetry-actions. | | `end` | nee | Einde van het tijdsbereik in ISO 8601-formaat. Vereist als `start` is opgegeven. | | `states` | nee | Door komma's gescheiden states: `open`, `closed`, `wip`. Geldt alleen voor sample-gebaseerde incidents. | | `revision` | nee | Beperk tot een specifieke deploy. Gebruik `"last"` voor de meest recente deploy, of geef een revision-hash door. Genegeerd wanneer `start`/`end` is opgegeven. Gebruik `get_app_resources(sections: ["deploy_markers"])` om beschikbare revisies op te lijsten. | | `page` | nee | Paginanummer voor sample-gebaseerde incidents (1-gebaseerd, standaard 1). OpenTelemetry-actions worden geretourneerd als een volledige gerangschikte lijst. | *** #### `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. | Parameter | Vereist | Beschrijving | | ----------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `namespace` | ja (performance) | De namespace waarin gezocht moet worden (bijv. `web`, `background`). Niet nodig voor error traces. | | `action_name` | ja (performance) | De action-naam (bijv. `BlogPostsController#index`). Niet nodig voor error traces. | | `digest` | ja (error) | De digest van het exception-incident. Schakelt over naar error trace-modus. Kan niet worden gecombineerd met `namespace` of `action_name`. | | `trace_id` | nee | Schakelt over naar tree-modus. Retourneert alle spans voor deze trace. | | `span_id` | nee | Schakelt over naar span detail-modus. Vereist `trace_id`. | | `start` | nee | Begin van het tijdsbereik in ISO 8601-formaat. Standaard 24 uur geleden. Alleen voor performance traces. | | `end` | nee | Einde van het tijdsbereik in ISO 8601-formaat. Standaard nu. Alleen voor performance traces. | | `min_duration_ms` | nee | Filter naar traces die trager zijn dan deze drempel in milliseconden. Alleen list-modus. | | `limit` | nee | Maximaal aantal traces om te retourneren (1–100, standaard 25). Alleen list-modus. | *** ### Anomaly detection #### `get_anomaly_incidents` Lijst en zoek alerts van AppSignal-anomaliedetectie. Retourneert 50 alerts per pagina, inclusief tijdstempels en waarden voor elke alert. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | --------------------------------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `state` | nee | `open`, `closed`, `warmup`, `cooldown` of `archived`. Retourneert alle states indien niet gespecificeerd. | | `trigger_id` | nee | Filter op incidents van een specifieke trigger. Gebruik `get_triggers` om trigger-ID's te vinden. | | `page` | nee | Paginanummer (1-gebaseerd, standaard 1). | *** #### `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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | ---------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `metric_name` | nee | Filter op metric-naam (bijv. `response_time`, `error_rate`). | | `kind` | nee | Filter op trigger-soort. | | `tags` | nee | Filter op tags, bijv. `[{"key": "hostname", "value": "web-1"}]`. | | `page` | nee | Paginanummer (1-gebaseerd, standaard 1). | *** #### `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. | Parameter | Vereist | Beschrijving | | --------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `metric_name` | ja | De metric die deze trigger bewaakt. | | `kind` | ja | Triggersoort. Gebruik `"Advanced"` voor custom metrics. | | `field` | ja | Metric-veld om mee te vergelijken: `gauge`, `mean`, `p90`, `p95`, `counter` of `count`. | | `condition_value` | ja | Drempelwaarde (bijv. `500.0` voor "response time > 500ms"). | | `comparison_operator` | ja | `<`, `>`, `<=`, `>=`, `==` of `!=`. | | `warmup_duration` | ja | Aantal minuten waarin aan de voorwaarde moet worden voldaan voordat er een alert opent. Gebruik `0` voor onmiddellijk. | | `cooldown_duration` | ja | Aantal minuten waarin niet meer aan de voorwaarde moet worden voldaan voordat een alert sluit. | | `id` | nee | ID van een bestaande trigger om bij te werken. Indien opgegeven, archiveert de oude trigger en maakt een nieuwe aan. | | `notifier_ids` | nee | Notifier-ID's om alerts naartoe te sturen. | | `tags` | nee | Tag-filters om te bepalen welke metrics worden meegenomen. Ondersteunt wildcards (`*`). | | `name` | nee | Weergavenaam. Standaard de metric-naam indien niet opgegeven. | | `description` | nee | Beschrijving van wat deze trigger bewaakt en wat te doen wanneer deze afgaat. | | `dashboard_id` | nee | Dashboard-ID om te koppelen in meldingen. | | `no_match_is_zero` | nee | Indien true, behandel ontbrekende metric-gegevens als 0. Handig voor counters die mogelijk niet rapporteren wanneer ze inactief zijn. | | `format` | nee | Dataformaat van de metric (bijv. `duration`, `size`, `percent`). | *** #### `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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | --------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `id` | ja | ID van de te archiveren trigger. | *** ### 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:** | Patroon | Voorbeeld | | ---------------------- | ------------------------------------------------------- | | Exact match | `severity=error` | | Contains | `message:timeout` | | Bevat niet | `message!:debug` | | Niet gelijk | `hostname!=web-1` | | Numerieke vergelijking | `duration>100` | | Booleaanse logica | `severity=error AND (hostname=web-1 OR hostname=web-2)` | | Quoted values | `group="background jobs"` | | Geneste attributen | `user.id=123` | Beschikbare velden: `severity`, `hostname`, `group`, `message` en eventuele custom attributen. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `query` | ja | Expressie-query. Gebruik een lege string om alle logs op te halen. | | `source_ids` | nee | ID's van te bevragen logbronnen. Bevraagt alle bronnen indien niet gespecificeerd. Gebruik `get_app_resources(sections: ["log_sources"])` om bron-ID's te vinden. | | `start` | nee | Begin van het tijdsbereik in ISO 8601-formaat. Standaard één queryvenster geleden. | | `end` | nee | Einde van het tijdsbereik in ISO 8601-formaat. Standaard nu. | | `limit` | nee | Aantal logregels om te retourneren (1–100, standaard 50). | | `order` | nee | `desc` (nieuwste eerst, standaard) of `asc` (oudste eerst). | *** #### `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. | Parameter | Vereist | Beschrijving | | ------------------ | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `name` | ja (aanmaken) | Naam van de action (bijv. `"Drop health checks"`, `"Track error count"`). | | `query` | ja (aanmaken) | Query-expressie om tegen logregels te matchen. | | `action_type` | ja (aanmaken) | `filter`, `trigger` of `metrics`. Kan niet worden gewijzigd bij update. | | `id` | nee | ID van een bestaande action om bij te werken. Indien weggelaten, wordt er een nieuwe action aangemaakt. | | `source_ids` | nee | Logbron-ID's waarvoor deze action geldt. Geldt voor alle bronnen indien niet gespecificeerd. | | `log_line_metrics` | nee | Metric-definities om te extraheren. Vereist bij het aanmaken van een `metrics` action. Elke metric vereist `name` en `metric_type` (`counter`, `gauge` of `distribution`). `gauge` en `distribution` vereisen ook een `field` om de waarde uit te extraheren. Bij update vervangt het alle bestaande metric-definities. | *** #### `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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | ----------------------------------------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `action_ids` | ja | Geordende lijst met log line action-ID's. De eerste ID in de lijst wordt als eerste uitgevoerd tijdens ingestion. | *** #### `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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | ----------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `id` | ja | ID van de te verwijderen log line action. | *** ### 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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | ------------------------------------------------------------------------------------------------------------ | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `metric_subject` | nee | Naam van de metric-categorie (bijv. `performance_metrics`, `host_metrics`) of een `dashboard:id`-verwijzing. | *** #### `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`. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | --------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | *** #### `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`. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | -------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `metric_name` | ja | Naam van de metric. Gebruik `get_metric_names` om beschikbare metrics te vinden. | *** #### `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 `*`. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | ------------------------------------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `metric_name` | ja | Naam van de metric. | | `metric_type` | ja | `COUNT`, `COUNTER`, `GAUGE`, `MEAN`, `P90` of `P95`. Gebruik `get_metric_tags` om het geldige type te vinden. | | `start` | ja | Begin van het tijdsbereik in ISO 8601-formaat. | | `end` | ja | Einde van het tijdsbereik in ISO 8601-formaat. | | `tags` | nee | Tag-filters, bijv. `[{"key": "hostname", "value": "web*"}]`. Ondersteunt `*`-wildcards. | *** #### `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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | ----------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `metric_name` | ja | Naam van de metric. | | `metric_type` | ja | `COUNT`, `COUNTER`, `GAUGE`, `MEAN`, `P90` of `P95`. | | `start` | ja | Begin van het tijdsbereik in ISO 8601-formaat. | | `end` | ja | Einde van het tijdsbereik in ISO 8601-formaat. | | `tags` | nee | Tag-filters, bijv. `[{"key": "hostname", "value": "frontend1"}]`. | *** ### 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. | Parameter | Vereist | Beschrijving | | ----------------- | ------- | ------------------------------------------------------------------------------------------------ | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `title` | ja | Titel van het dashboard. | | `description` | nee | Beschrijving van het doel en de inhoud van het dashboard. | | `id` | nee | Dashboard-ID voor het bijwerken van een bestaand dashboard. Weglaten om een nieuwe aan te maken. | *** #### `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. | Parameter | Vereist | Beschrijving | | ------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `dashboard_id` | ja | ID van het dashboard waaraan de visual moet worden toegevoegd. | | `title` | ja | Titel van de grafiek. | | `metrics` | ja | Array van metrics om weer te geven. Elke vereist `name`, `fields` (bijv. `mean`, `p90`, `p95`, `count`) en optioneel `tags`. | | `description` | nee | Aanvullende context over de visual. | | `display` | nee | `line` (standaard), `area` of `area_relative`. | | `line_label` | nee | Aangepast label voor grafieklijnen. Ondersteunt `%name%`-, `%field%`- en `%tag%`-vervangingen. | | `format` | nee | Waardeformaat, bijv. `duration`, `size`, `percentage`. | | `draw_null_as_zero` | nee | Of ontbrekende datapunten als nul worden getekend. Standaard: `false`. | | `min_y_axis` | nee | Minimumwaarde voor de Y-as. | | `tags` | nee | Globale tags die worden toegepast op alle metrics in deze visual. | *** #### `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. | Parameter | Vereist | Beschrijving | | ------------------- | ------- | ---------------------------------------------------------------------------------------------- | | `app_name` | ja | Naam van de AppSignal-applicatie. | | `app_environment` | ja | Omgeving. | | `visual_id` | ja | ID van de visual-component om bij te werken. | | `title` | nee | Nieuwe titel. Huidige titel blijft behouden indien niet opgegeven. | | `description` | nee | Nieuwe beschrijving. Stel in op een lege string om te verwijderen. | | `metrics` | nee | Bijgewerkte metrics-array. Vervangt alle bestaande metrics indien opgegeven. | | `display` | nee | `line`, `area` of `area_relative`. | | `line_label` | nee | Aangepast label voor grafieklijnen. Ondersteunt `%name%`-, `%field%`- en `%tag%`-vervangingen. | | `format` | nee | Waardeformaat, bijv. `duration`, `size`, `percentage`. | | `draw_null_as_zero` | nee | Of ontbrekende datapunten als nul worden getekend. | | `min_y_axis` | nee | Minimumwaarde voor de Y-as. | | `tags` | nee | Globale tags. Vervangt bestaande globale tags indien opgegeven. | *** ## 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? Als uw AI-agent of editor iets niet kan dat u zou verwachten mogelijk te zijn, laat het hem dan weten. AppSignal MCP bevat een ingebouwd feedbackmechanisme dat verzoeken vastlegt voor mogelijkheden die nog niet bestaan — dit helpt het AppSignal-team te prioriteren wat er als volgende gebouwd moet worden. U kunt ook feature requests plaatsen in de Discord-community.