Naar hoofdinhoud gaan
Een Big Number is een KPI-grafiek met één enkele waarde, handig om in één oogopslag een totaal, de laatste meting of een geaggregeerde metric weer te geven (bijv. totaal aantal fouten, huidige wachtrijdiepte, gemiddelde request-latency). Deze pagina behandelt het gebruik van die functie vanuit een AI-agent die is verbonden met AppSignal MCP. Voor een rondleiding door alle grafiektypes voor dashboards in de UI, zie Dashboards.

​
Wat u kunt doen

Met de permission dashboards ingesteld op write kan een agent:
  • Een nieuw dashboard aanmaken om de grafiek in onder te brengen (manage_dashboard)
  • Een Big Number-grafiek toevoegen aan een willekeurig dashboard (create_dashboard_visual met type: "number")
  • De metric, aggregatie of opmaak op een bestaande grafiek wijzigen (update_dashboard_visual)
De grafiek wordt op dezelfde manier weergegeven als een grafiek die in de AppSignal-app is gemaakt; MCP is gewoon een andere manier om deze samen te stellen. Big Number-grafiek op een dashboard

​
Voorbeeldprompt

Text
Add a Big Number chart to the "API Health" dashboard showing the mean
of request_latency_ms over the selected time range, formatted as a duration.
De agent vertaalt dat naar een create_dashboard_visual-aanroep met:
  • type: "number"
  • metric.name: "request_latency_ms"
  • metric.field: "mean"
  • metric.aggregate: "avg"
  • format: "duration"

​
De grafiek configureren

Een Big Number-grafiek heeft één metric en één aggregatie over het geselecteerde tijdsbereik nodig:
  • Metric — De naam van de metric die in deze grafiek moet worden weergegeven. U kunt ofwel de volledige metric-naam gebruiken om één metric te selecteren, of een wildcard (_) gebruiken om meerdere metrics tegelijk te selecteren: db_users_document_count, db\__\_size. Zie metric naming voor de volledige regels.
  • Aggregation type — De aggregatie die wordt gebruikt om de metric-waarde weer te geven. Het getal op de grafiek wordt geselecteerd of berekend op basis van deze aggregatie, toegepast op de gerapporteerde metric-gegevens in het geselecteerde tijdsbestek op het dashboard of de preview:
    • Maximum value — de hoogste metric-waarde
    • Minimum value — de laagste metric-waarde
    • Average value — het gemiddelde van de metric-waarden
    • Total value — de gecombineerde waarde van de metric-waarden
    • First value — de eerste metric-waarde
    • Last value — de laatste metric-waarde
  • Data format — Selecteer het waardeformaat dat wordt gebruikt om waarden in de grafiek en grafieklegenda’s weer te geven. Zie value formatting voor de beschikbare formaten.
  • Tags (optioneel) — Selecteer welke tags van de metric in de grafiek moeten worden weergegeven:
    • Wanneer leeg, creëren alle variaties van een tag hun eigen lijn in de grafiek.
    • Voer tags in om te filteren op bepaalde tagwaarden. In dit geval moeten alle tags van de metric worden gespecificeerd, ofwel met een waarde of een wildcard.
    Zie metric tags voor de volledige referentie.
Big Number-grafiekconfiguratie in de AppSignal-UI

​
De gegevens verzenden

MCP stelt de visual samen; het neemt geen metrics op. De metric waarnaar u een grafiek laat verwijzen, moet al naar AppSignal stromen via uw integratie. Zie custom metrics voor hoe u deze vanuit uw applicatie verzendt.