AppSignal GraphQL API Documentation

Authentication

The GraphQL API is available at POST /graphql. Requests require an authenticated session (cookie-based). All queries and mutations are scoped to the current user's accessible organizations and apps.

Endpoint

POST /graphql
Content-Type: application/json

{
  "query": "{ viewer { email } }",
  "variables": {}
}

Queries

QUERY app

AppSignal App

Arguments

Name Type Required Description
id String! Yes App id

Returns

App

QUERY organization

Organization the current user belongs to

Arguments

Name Type Required Description
slug String! Yes Slug of the organization

Returns

Organization

QUERY timezones

List of supported timezones

Returns

[Timezone!]!

QUERY viewer

Current logged in user

Returns

Viewer

Mutations

Core

MUTATION createApp

Create a new app

Input Fields

Name Type Required Description
organizationSlug String! Yes Parent organization of the app
name String! Yes App name
environment String! Yes App environment

Returns

App

MUTATION createHostedCollector

Create a hosted collector for an organization

Input Fields

Name Type Required Description
organizationSlug String! Yes Organization slug where the hosted collector belongs.
experimental Boolean No Run the experimental collector build with new features.

Returns

HostedCollector

MUTATION deleteApp Requires appId

Delete an app and all its data

Input Fields

Name Type Required Description
appId String! Yes

Returns

App

MUTATION pinApp Requires appId

Pin an app to the current user's pinned apps

Input Fields

Name Type Required Description
appId String! Yes

Returns

App

MUTATION unpinApp Requires appId

Unpin an app from the current user's pinned apps

Input Fields

Name Type Required Description
appId String! Yes

Returns

App

MUTATION updateHostedCollector

Update a hosted collector for an organization

Input Fields

Name Type Required Description
organizationSlug String! Yes Organization slug where the hosted collector belongs.
id String! Yes ID of the hosted collector to update.
experimental Boolean! Yes Run the experimental collector build with new features.

Returns

HostedCollector

MUTATION updateQuest

Update the state of a Discover AppSignal quest. Use OPEN to unskip.

Input Fields

Name Type Required Description
organizationSlug String! Yes Slug of the organization.
key String! Yes Key of the quest to update.
state QuestStateEnum! Yes New state for the quest. Pass OPEN to reset a skipped quest.

Returns

[Quest!]

Incidents

MUTATION bulkUpdateIncidents Requires appId

Update multiple incidents at once

Input Fields

Name Type Required Description
ids [String]! Yes List of ids to be updated with given state
marker String No If ID is present, returns marker-specific metrics
state IncidentStateEnum No New incident state
severity IncidentSeverityEnum No New incident severity
appId String! Yes

Returns

[Incident!]

MUTATION createIncidentNote Requires appId

Create a note on an incident

Input Fields

Name Type Required Description
incidentNumber Int! Yes Incident number
content String! Yes Content of the note
appId String! Yes

Returns

Incident

MUTATION deleteLogbookNote Requires appId

Delete a note from a logbook

Input Fields

Name Type Required Description
logbookableId String! Yes Logbookable ID
logbookableType LogbookableTypeEnum! Yes Logbookable type
id String! Yes Note ID that needs to be deleted
appId String! Yes

Returns

Logbook

MUTATION pinLogbookComment Requires appId

Pin a comment in a logbook

Input Fields

Name Type Required Description
logbookableId String! Yes Logbookable ID
logbookableType LogbookableTypeEnum! Yes Logbookable type
commentId String! Yes Comment ID
appId String! Yes

Returns

Logbook

MUTATION unpinLogbookComment Requires appId

Unpin a comment in a logbook

Input Fields

Name Type Required Description
logbookableId String! Yes Logbookable ID
logbookableType LogbookableTypeEnum! Yes Logbookable type
appId String! Yes

Returns

Logbook

MUTATION updateIncident Requires appId

Update an incident's state, severity, or assignees

Input Fields

Name Type Required Description
number Int! Yes Incident number
state IncidentStateEnum No Incident state
severity IncidentSeverityEnum No Incident severity
notificationFrequency IncidentNotificationFrequencyEnum No Incident notification option
notificationThreshold Int No Incident notification duration treshold
description String No Incident description or solution
assigneeIds [String!] No Array of user_ids that are assigned to resolve or investigate this incident
appId String! Yes

Returns

Incident

MUTATION updateLogbookNote Requires appId

Update a note in a logbook

Input Fields

Name Type Required Description
logbookableId String! Yes
logbookableType LogbookableTypeEnum! Yes
id String! Yes
content String! Yes
appId String! Yes

Returns

Logbook

Dashboards

MUTATION createDashboard Requires appId

Create a new dashboard

Input Fields

Name Type Required Description
title String! Yes Title of the dashboard.
description String No Description of the dashboard.
graphs [DashboardGraphInput!] No DEPRECATED: Use the `createVisual*` mutations instead.
appId String! Yes

Returns

Dashboard

MUTATION createSavedVisual Requires appId

Create a saved visual

Input Fields

Name Type Required Description
resolution String! Yes Time resolution for the visual
valueFormat String No Value format for display
valueInput String No Value input format
title String! Yes Title of the saved visual
series [SerieInput]! Yes Series to display
appId String! Yes

Returns

SavedVisual

MUTATION createVisualNumber Requires appId

Add a number visual to a dashboard

Input Fields

Name Type Required Description
dashboardId String! Yes Dashboard ID.
visual VisualNumberInput! Yes Big Number Visual to create.
appId String! Yes

Returns

Dashboard

MUTATION createVisualTimeseries Requires appId

Add a timeseries visual to a dashboard

Input Fields

Name Type Required Description
dashboardId String! Yes Dashboard ID.
visual VisualTimeseriesInput! Yes Visual to create.
appId String! Yes

Returns

Dashboard

MUTATION deleteDashboard Requires appId

Delete a dashboard

Input Fields

Name Type Required Description
id String! Yes Dashboard ID.
appId String! Yes

Returns

Dashboard

MUTATION deleteVisual Requires appId

Delete a visual from a dashboard

Input Fields

Name Type Required Description
id String! Yes Id of the visual to delete.
appId String! Yes

Returns

Dashboard

MUTATION dismissMagicDashboardUpdate Requires appId

Dismiss the update prompt for an auto-generated dashboard. The prompt will reappear once the upstream template changes again.

Input Fields

Name Type Required Description
id String! Yes Dashboard ID
appId String! Yes

Returns

Dashboard

MUTATION importDashboard Requires appId

Import a dashboard from JSON

Input Fields

Name Type Required Description
json String! Yes JSON encoded string containing dashboard definition
appId String! Yes

Returns

Dashboard

MUTATION replaceMagicDashboard Requires appId

Demote an auto-generated dashboard to a regular user dashboard (keeping the user's customizations) and create a fresh auto dashboard from the latest upstream template alongside it. Returns the new dashboard.

Input Fields

Name Type Required Description
id String! Yes ID of the existing auto dashboard to replace
appId String! Yes

Returns

Dashboard

MUTATION updateDashboard Requires appId

Update a dashboard

Input Fields

Name Type Required Description
id String! Yes Dashboard ID
title String! Yes Dashboard title.
description String No Dashboard description.
graphs [DashboardGraphInput!] No DEPRECATED: Use the `updateVisual*` and `removeVisual*` mutations instead.
appId String! Yes

Returns

Dashboard

MUTATION updateMagicDashboard Requires appId

Apply the latest upstream template to an auto-generated dashboard, overwriting any user customizations.

Input Fields

Name Type Required Description
id String! Yes Dashboard ID
appId String! Yes

Returns

Dashboard

MUTATION updateVisualLayouts Requires appId

Update layouts of visuals on a dashboard

Input Fields

Name Type Required Description
id String! Yes Dashboard ID
layouts [VisualLayoutUpdateInput!]! Yes List of visual layouts to update.
appId String! Yes

Returns

Dashboard

MUTATION updateVisualNumber Requires appId

Update a number visual

Input Fields

Name Type Required Description
visualId String! Yes Id of the Big Number Visual to update.
visual VisualNumberInput! Yes Big Number Visual data to update.
appId String! Yes

Returns

Dashboard

MUTATION updateVisualTimeseries Requires appId

Update a timeseries visual

Input Fields

Name Type Required Description
visualId String! Yes Id of the visual to update.
visual VisualTimeseriesInput! Yes Visual to update.
appId String! Yes

Returns

Dashboard

Alerts

MUTATION archiveAlert Requires appId

Archive an alert

Input Fields

Name Type Required Description
id String! Yes ID of alert to be archived
appId String! Yes

Returns

Boolean

MUTATION archiveTrigger Requires appId

Archive a trigger

Input Fields

Name Type Required Description
id String! Yes Id of record to remove.
appId String! Yes

Returns

Trigger

MUTATION createTrigger Requires appId

Create a trigger for metric-based alerts

Input Fields

Name Type Required Description
previousTriggerId String No Id of record, if present record will be updated
name String No Name describing the trigger, metric name is used if empty.
metricName String! Yes The metric this trigger is about.
notifierIds [String!] No List of notifier ids
noMatchIsZero Boolean No If no data is received for this metric, treat the value as 0
condition ThresholdConditionInput! Yes Threshold condition for the trigger
field MetricFieldEnum! Yes Field which will be compared against for this alert.
kind String! Yes Trigger kind (ExceptionRate/Throughput etc).
description String No Description provided by the user about the trigger.
warmupDuration Int! Yes Trigger warm up time.
cooldownDuration Int! Yes Trigger cool down time.
dashboardId String No Dashboard ID to link to in notifications.
format String No The data format of the metric the trigger is configured. For more information, see our docs: https://docs.appsignal.com/metrics/custom.html#metric-values
formatInput String No The data format input size for the "size" format. For more information, see our docs: https://docs.appsignal.com/metrics/custom.html#metric-values
tags [KeyStringValueInput!] No Map of tags that will filter which metrics to include. Values may include wildcards: *value*
appId String! Yes

Returns

Trigger

MUTATION endLastAlert Requires appId

Close the last open alert for an anomaly incident

Input Fields

Name Type Required Description
number Int! Yes The number of of the incident for which you want to end the last alert
appId String! Yes

Returns

AnomalyIncident

Logs

MUTATION createLogExport Requires appId

Create a log export

Input Fields

Name Type Required Description
sourceId String! Yes The ID of the source to create an export for
s3Url String! Yes S3 URL (including bucket/subdirectory)
s3AccessKey String! Yes S3 access key
s3SecretKey String! Yes S3 secret key
compressed Boolean! Yes Compress export with Gzip
appId String! Yes

Returns

Export

MUTATION createLogLineAction Requires appId

Input Fields

Name Type Required Description
name String! Yes Name of the action.
query String! Yes Query expression to match against log lines.
actionType LogLineActionTypeEnum! Yes Type of action (trigger, filter, or metrics).
sourceIds [String!] No List of log source IDs.
logLineMetrics [LogLineMetricInput!] No Metric definitions (required when action_type is metrics).
trigger LogLineTriggerInput No Trigger configuration (required when action_type is trigger).
appId String! Yes

Returns

LogLineAction

MUTATION createLogSource Requires appId

Create a log source

Input Fields

Name Type Required Description
name String! Yes Name of the source
type String! Yes Type of source
fmt SourceFormatEnum! Yes Format of source, can be plaintext, logfmt or JSON
projectId String No (Vercel) project id
integrationId String No (Vercel) integration id
parseSeverity Boolean No If true, the log severity will be parsed from the message
appId String! Yes

Returns

Source

MUTATION createLogTrigger Requires appId

Create a log trigger

Input Fields

Name Type Required Description
name String! Yes Name of the trigger
query String! Yes Log query to match against
description String No Description provided by the user about the trigger.
sourceIds [String!] No List of source ids
notifierIds [String!] No List of notifier ids
severities [String!] No List of severities
notificationOptions IncidentNotificationFrequencyEnum No Incident notification option
notificationTriggerValue Int No Incident notification duration treshold
appId String! Yes

Returns

LogLineActionTrigger

MUTATION createLogView Requires appId

Create a log view

Input Fields

Name Type Required Description
name String! Yes Name of the view
sourceIds [String!] No Source ids to include in the view
severities [String!] No Severities to include in the view
columns [String!] No Columns to include in the view
lineHeight String No Line height of this view
query String No Query to include in the view
appId String! Yes

Returns

View

MUTATION deleteLogExport Requires appId

Delete a log export

Input Fields

Name Type Required Description
id String! Yes Export ID.
appId String! Yes

Returns

Export

MUTATION deleteLogLineAction Requires appId

Input Fields

Name Type Required Description
id String! Yes Log line action ID.
appId String! Yes

Returns

LogLineAction

MUTATION deleteLogSource Requires appId

Delete a log source

Input Fields

Name Type Required Description
id String! Yes Source ID.
appId String! Yes

Returns

Source

MUTATION deleteLogTrigger Requires appId

Delete a log trigger

Input Fields

Name Type Required Description
id String! Yes Log Trigger ID.
appId String! Yes

Returns

LogLineActionTrigger

MUTATION deleteLogView Requires appId

Delete a log view

Input Fields

Name Type Required Description
id String! Yes Log View ID.
appId String! Yes

Returns

View

MUTATION reorderLogLineActions Requires appId

Input Fields

Name Type Required Description
actionIds [String]! Yes Ordered list of log line action IDs.
appId String! Yes

Returns

[LogLineAction]

MUTATION updateLogExport Requires appId

Update a log export

Input Fields

Name Type Required Description
id String! Yes The ID of the export to edit
s3Url String No S3 URL (including bucket/subdirectory)
s3AccessKey String No S3 access key
s3SecretKey String No S3 secret key
compressed Boolean No Compress export with Gzip
appId String! Yes

Returns

Export

MUTATION updateLogLineAction Requires appId

Input Fields

Name Type Required Description
id String! Yes Action ID.
name String No Name of the action.
query String No Query expression to match against log lines.
sourceIds [String!] No List of log source IDs.
logLineMetrics [LogLineMetricInput!] No Metric definitions (replaces existing metrics).
trigger LogLineTriggerInput No Trigger configuration (trigger only).
appId String! Yes

Returns

LogLineAction

MUTATION updateLogSource Requires appId

Update a log source

Input Fields

Name Type Required Description
id String! Yes Source ID
name String! Yes Source name.
fmt SourceFormatEnum! Yes Format of source, can be plaintext, logfmt or JSON
parseSeverity Boolean No If true, the log severity will be parsed from the message
appId String! Yes

Returns

Source

MUTATION updateLogTrigger Requires appId

Update a log trigger

Input Fields

Name Type Required Description
id String! Yes Trigger ID
name String No Name of the trigger
query String No Log query to match against
description String No Description provided by the user about the trigger.
sourceIds [String!] No List of source ids
notifierIds [String!] No List of notifier ids
severities [String!] No List of severities
notificationOptions IncidentNotificationFrequencyEnum No Incident notification option
notificationTriggerValue Int No Incident notification duration treshold
appId String! Yes

Returns

LogLineActionTrigger

MUTATION updateLogView Requires appId

Update a log view

Input Fields

Name Type Required Description
id String! Yes View ID
name String No View name.
sourceIds [String!] No Source ids to include in the view
severities [String!] No Severities to include in the view
columns [String!] No Columns to include in the view
lineHeight String No Line height of this view
query String No Query to include in the view
appId String! Yes

Returns

View

Markers

MUTATION createOrUpdateCustomMarker Requires appId

Create or update a custom marker

Input Fields

Name Type Required Description
id String No Id of record, if present record will be updated
icon String! Yes Emoji representing the marker icon
message String No Message for the custom marker
createdAt DateTime No DateTime of marker
appId String! Yes

Returns

CustomMarker

MUTATION deleteCustomMarker Requires appId

Delete a custom marker

Input Fields

Name Type Required Description
id String! Yes Id of custom marker to remove.
appId String! Yes

Returns

CustomMarker

Uptime

MUTATION createUptimeMonitor Requires appId

Create an uptime monitor

Input Fields

Name Type Required Description
uptimeMonitor UptimeMonitorInput! Yes Uptime monitor to create.
appId String! Yes

Returns

UptimeMonitor

MUTATION deleteUptimeMonitor Requires appId

Delete an uptime monitor

Input Fields

Name Type Required Description
id String! Yes ID of the uptime monitor to remove.
appId String! Yes

Returns

UptimeMonitor

MUTATION updateUptimeMonitor Requires appId

Update an uptime monitor

Input Fields

Name Type Required Description
id String! Yes ID of the uptime monitor to update.
uptimeMonitor UptimeMonitorInput! Yes Uptime monitor to update.
appId String! Yes

Returns

UptimeMonitor

Check-ins

MUTATION createCheckInTrigger Requires appId

Create a check-in trigger

Input Fields

Name Type Required Description
identifier String! Yes Identifier of the trigger
syntax String No Cron syntax
description String No Description of the trigger
kind CheckInTriggerKindEnum! Yes Kind of check-in trigger
waitTimeMinutes Int! Yes Time to wait before expecting the result
timezone String No Timezone of the server (UTC recommended)
notifierIds [String!] No List of notifier ids
appId String! Yes

Returns

CheckInTrigger

MUTATION createCheckInTriggerNote Requires appId

Create a note on a check-in trigger

Input Fields

Name Type Required Description
checkInTriggerId String! Yes Check-in trigger ID
content String! Yes Content of the note
appId String! Yes

Returns

CheckInTrigger

MUTATION deleteCheckIn Requires appId

Delete a check-in run

Input Fields

Name Type Required Description
id String! Yes Check-in ID.
appId String! Yes

Returns

CheckIn

MUTATION deleteCheckInTrigger Requires appId

Delete a check-in trigger

Input Fields

Name Type Required Description
id String! Yes Check-in Trigger ID.
appId String! Yes

Returns

CheckInTrigger

MUTATION updateCheckInTrigger Requires appId

Update a check-in trigger

Input Fields

Name Type Required Description
id String! Yes check-in trigger ID
identifier String No Identifier of the trigger
syntax String No Cron syntax
description String No Description of the trigger
waitTimeMinutes Int No Time to wait before expecting the result
timezone String No Timezone of the server (UTC recommended)
notifierIds [String!] No List of notifier ids
appId String! Yes

Returns

CheckInTrigger

Exports

MUTATION createCsvExport Requires appId

Start a CSV export

Input Fields

Name Type Required Description
type String! Yes Type of data to export
filters JSON No Filters to apply to the export
appId String! Yes

Returns

CreateCsvExportPayload

MUTATION createCsvExportUrl

Generate a download URL for a completed CSV export

Input Fields

Name Type Required Description
exportId String! Yes ID of the export
organizationSlug String! Yes Parent organization of the app

Returns

CreateCsvExportUrlPayload

Status Pages

MUTATION createStatusPage

Create a status page

Input Fields

Name Type Required Description
organizationSlug String! Yes Organization slug where the status pages belongs.
statusPage CreateStatusPageInput! Yes Status page to create

Returns

StatusPage

MUTATION createStatusPageUpdate

Create a status page update

Input Fields

Name Type Required Description
organizationSlug String! Yes Organization slug where the status pages belongs.
statusPageId String! Yes Id of the status page this update belongs to
statusPageUpdate StatusPageUpdateInput! Yes Status page update

Returns

StatusPageUpdate

MUTATION deleteStatusPage

Delete a status page

Input Fields

Name Type Required Description
organizationSlug String! Yes Organization slug where the status page belongs.
id String! Yes ID of the status page to remove.

Returns

StatusPage

MUTATION deleteStatusPageUpdate

Delete a status page update

Input Fields

Name Type Required Description
organizationSlug String! Yes Organization slug where the status page belongs.
statusPageId String! Yes Id of the status page this update belongs to
id String! Yes ID of the status page to remove.

Returns

StatusPageUpdate

MUTATION updateStatusPage

Update a status page

Input Fields

Name Type Required Description
organizationSlug String! Yes Organization slug where the status pages belongs.
id String! Yes Id of the status page to update.
statusPage UpdateStatusPageInput! Yes Status page to update

Returns

StatusPage

MUTATION updateStatusPageUpdate

Update a status page update

Input Fields

Name Type Required Description
organizationSlug String! Yes Organization slug where the status pages belongs.
statusPageId String! Yes Id of the status page this update belongs to
id String! Yes Id of the update to... update.
statusPageUpdate StatusPageUpdateInput! Yes Status page update

Returns

StatusPageUpdate

Integrations

MUTATION createAsanaTask Requires appId

Create an Asana task from an incident

Input Fields

Name Type Required Description
incidentNumber Int! Yes Incident number.
title String! Yes Asana task title.
description String! Yes Asana task description.
appId String! Yes

Returns

Incident

MUTATION createGithubIssue Requires appId

Create a GitHub issue from an incident

Input Fields

Name Type Required Description
incidentNumber Int! Yes Incident number.
title String! Yes GitHub issue title.
description String! Yes GitHub issue description.
appId String! Yes

Returns

Incident

MUTATION createGitlabIssue Requires appId

Create a GitLab issue from an incident

Input Fields

Name Type Required Description
incidentNumber Int! Yes Incident number.
title String! Yes GitLab issue title.
description String! Yes GitLab issue description.
appId String! Yes

Returns

Incident

MUTATION createJiraIssue Requires appId

Create a Jira issue from an incident

Input Fields

Name Type Required Description
incidentNumber Int! Yes Incident number.
title String! Yes Jira issue title.
description String! Yes Jira issue description.
appId String! Yes

Returns

Incident

MUTATION createLinearIssue Requires appId

Create a Linear issue from an incident

Input Fields

Name Type Required Description
incidentNumber Int! Yes Incident number.
title String! Yes Linear issue title.
description String! Yes Linear issue description.
appId String! Yes

Returns

Incident

MUTATION createShortcutStory Requires appId

Create a Shortcut story from an incident

Input Fields

Name Type Required Description
incidentNumber Int! Yes Incident number.
title String! Yes Shortcut story title.
description String! Yes Shortcut story description.
appId String! Yes

Returns

Incident

MUTATION createTrelloCard Requires appId

Create a Trello card from an incident

Input Fields

Name Type Required Description
incidentNumber Int! Yes Incident number.
listId String! Yes Trello list ID.
title String! Yes Trello card title.
description String! Yes Trello card description.
appId String! Yes

Returns

Incident

MUTATION removeIntegration Requires appId

Remove a linked integration from an incident

Input Fields

Name Type Required Description
incidentNumber Int! Yes Incident number
id String! Yes Integration id
appId String! Yes

Returns

Incident

User

MUTATION markTooltipAsSeen

Mark a tooltip as seen for the current user

Input Fields

Name Type Required Description
tooltip String! Yes Name of the tooltip

Returns

Viewer

MUTATION updateViewer

Update the current user's preferences

Input Fields

Name Type Required Description
chartShowHorizontalLines Boolean No Show horizontal chart lines when true
chartShowVerticalLines Boolean No Show vertical chart lines when true
chartShowMarkers Boolean No Show chart markers when true
chartLineThickness Float No Chart line thickness
chartColorPalette String No Chart color palette

Returns

Viewer

MUTATION usedFeature

Record that a user has used a feature

Input Fields

Name Type Required Description
feature String! Yes Feature user has used.

Returns

Viewer

Type Reference

ActionLinkAction (object)

An action endpoint in a distributed trace link

Field Type Description
id String! Action identifier
name String! Action name
namespace String! Action namespace

AggregateField (object)

A list of fields to return. Example: "fields": [ {"field": COUNT, "aggregate": SUM}, {"field": P90, "aggregate", AVG} ]

AggregationList (object)

Aggregation of metrics grouped by tags

Field Type Description
start DateTime! Start time of performed metric query
end DateTime! End time of performed metric query
total Int Total keys found for query, only populated when $offset is 0
rows [AggregationListRow!] Rows returned for aggregated list

AggregationListRow (object)

Row with grouped aggregation list data

Field Type Description
id String! ID of metric
name String! Name of metric
tags [KeyStringValue!] List of tags for metric
fields [KeyFloatValue!] List of fields with value for metric

Alert (object)

Alert triggered by metrics monitor

Field Type Description
id String! Triggered Alert ID
state AlertStateEnum! The current alert state
metricDigest String! Digest of metric that triggered the alert
closedReason String (optional) Reason alert was closed
message String (optional) Message
version Int! Version of alert
createdAt DateTime Time at which an alert was created. The condition for the parent Trigger was met at this time.
openedAt DateTime Time at which the alert was opened after warming up.
resolvedAt DateTime Time at which the alert was resolved before cooling down. Can be reopened if occurred during cooldown. Is 'null' if still open or warming up.
closedAt DateTime Time at which the alert was closed after cooling down. Is 'null' if still open.
firstNotifiedAt DateTime Time at which the first notification was sent.
lastProcessedAt DateTime Time at which the alert was last processed.
timeframeStartAt DateTime Start of timeframe for alert data
timeframeEndAt DateTime End of timeframe for alert data
lastValue Float! Last value that triggered the alert
peakValue Float! Peak value during alert
mean Float! Mean value during alert
tags [KeyStringValue!] List of tags
trigger Trigger! Alert trigger that triggered this alert
stateChanges [AlertStateChange!] List of state changes

AlertStateChange (object)

State changes for an alert

Field Type Description
time DateTime Time the state was changed
value Float Last value that triggered the alert
state AlertStateEnum! The current alert state

AlertStateEnum (enum)

Possible states of an alert

Value Description
OPEN Alert is currently active
CLOSED Alert has been resolved
WARMUP Alert is in warmup period before becoming active
COOLDOWN Alert is cooling down after being resolved
UNTRACKED Alert is no longer being tracked
ARCHIVED Alert has been archived

AnomalyIncident (object)

Anomaly incident in which a problem or exception was reported

Field Type Description
alertState AlertStateEnum Alert state of this incident
trigger Trigger Trigger that triggered this incident
tags [KeyStringValue!] Tags of metric that matches this triggered incident
alert Alert Alert that was triggered by this incident
alerts [Alert] Alerts that were triggered by this incident
id String! Incident ID
number Int! Incident number
state IncidentStateEnum State of incident (open/closed)
severity IncidentSeverityEnum Severity of incident (critical/high/low/etc.)
notificationFrequency IncidentNotificationFrequencyEnum Notification frequency for incident
description String Incident description, or steps to solve the issue
count Int! Total count of all recorded requests/jobs for this incident
lastOccurredAt DateTime Time incident last occurred at
digests [String!] All incident digests
createdAt DateTime Create time of incident
updatedAt DateTime Last update time of incident
logbook Logbook! Logbook for incident
assignees [User] Users assigned to investigate or resolve this incident
app App App in which the incident occurred
integrations [Integration] List of available integration types

App (object)

An AppSignal app

Field Type Description
id String! App ID
name String! App name
environment String! App environment
platforms [String!] List of seen platforms
languages [String!] Language integrations
organization Organization Organization that this app belongs to.
status String! App status
pushApiKey String! Push API key (Heroku apps only) (internal use only, might be removed)
frontendApiKey String! Front-End API key
lastPushProcessedAt DateTime Last time data was received
createdAt DateTime When the app was created
updatedAt DateTime When the app was last updated
viewerPinned Boolean Whether the current user has pinned this app
viewerEditorPreference EditorPreference
users [User] Team members with access to this app
dashboard Dashboard Single dashboard by ID
dashboards [Dashboard] List of dashboards
urlTemplates [UrlTemplate] Configured URL templates for linking to source code
logViews [View] List of saved log views
logView View Single saved log view by ID
incident Incident Single incident by number
incidents [Incident] List of all incidents (Exception and Performance)
exceptionIncidents [ExceptionIncident] List of exception incidents
paginatedExceptionIncidents PaginatedExceptionIncidents Paginated list of exception incidents
performanceIncidents [PerformanceIncident] List of performance incidents
paginatedPerformanceIncidents PaginatedPerformanceIncidents Paginated list of performance incidents
logIncidents [LogIncident] List of log incidents
paginatedLogIncidents PaginatedLogIncidents Paginated list of log incidents
anomalyIncidents [AnomalyIncident] List of anomaly incidents
paginatedAnomalyIncidents PaginatedAnomalyIncidents Paginated list of anomaly incidents
marker MarkerUnion Single marker of any type, by id
markers [MarkerUnion] List of all marker types (Deploy/Notification/Custom)
deployMarkers [DeployMarker] List of deploy markers
namespaces [Namespace] List of namespaces, filtered by optional filter
alerts [Alert] List triggered alerts
notifiers [Notifier] List of available 3rd party notifiers
eventGroupList AggregationList TEMPORARY, DO NOT USE. (top) list of event group metrics (e.g. active_record)
event Event TEMPORARY, DO NOT USE. Event
timeDetectivePerformanceDataPoints [TimeDetectiveDataPoint] List of time detective data points that occurred within a specific time.
timeDetectiveErrorDataPoints [TimeDetectiveDataPoint] List of time detective data points that occurred within a specific time.
metrics Metrics Metrics for app, (timelines/lists/gauges)
trigger Trigger Find a single trigger.
triggers [Trigger] List alert triggers for apps.
uptimeMonitors [UptimeMonitor] List of uptime monitors for app.
uptimeMonitor UptimeMonitor Single uptime monitor by ID
uptimeMonitorRegions [UptimeMonitorRegion] List of available uptime monitor regions
links [Link] Linked apps through distributed tracing
actionLinks [ActionLink] Linked apps through distributed tracing
logs Logs Log-related queries
spans Spans Span-related queries
checkIns CheckIns Check-in-related queries
backtrace [BacktraceLine] Backtrace for the given ID

Asana (object)

Field Type Description
tasks [AsanaTask]! List of Asana tasks
formData AsanaFormData Form data fields for Asana integration
name String! Integration title
needsMigration Boolean! Set to true if the integration needs a migration

AsanaFormData (object)

Field Type Description
title String! Title
body String! Body

AsanaTask (object)

Field Type Description
id String! Integration result ID
title String! Title provided by the AppSignal user
description String! Description provided by the AppSignal user
url String! Url to remote integration
remoteId String! Remote ID of integration (e.g. GitHub issue number or Asana ID

AssigneeChange (object)

A record of an assignee change

Field Type Description
previousAssignees [User!]! Previous assignees
currentAssignees [User!]! Current assignees
addedAssignees [User!]! Added assignees
removedAssignees [User!]! Removed assignees
via String The integration that was used to make the change
id String! Change ID.
createdAt DateTime! Time at which the change was created.
updatedAt DateTime! Time at which the change was updated last.
author User User that created the change. If empty, the user was deleted.

BacktraceLine (object)

A single line in a backtrace

Field Type Description
original String Original (unparsed) line
type String Backtrace type, (line/app)
line String Backtrace line number
column String Backtrace column number
method String Backtrace method
path String Backtrace path
url String Backtrace url
code [Code] Backtrace surrounding code
error Error Backtrace line parse error

BillingCycleUsage (object)

Usage information for the current billing cycle

Field Type Description
apmUsage Float Apm usage for this billing period
apmLimit Float Apm limit for this billing period
logUsage Float Log usage in bytes for this billing period
logLimit Float Log limit in bytes for this billing period
daysLeft Int Days left in this billing period

Breadcrumb (object)

Breadcrumb belonging to a sample

Field Type Description
time DateTime Time of breadcrumb creation
category String! Category (e.g. Network)
action String! Action performed to create breadcrumb (e.g The user clicked a button)
message String Log message
metadata [KeyStringValue] Metadata recorded when breadcrumb was created.

BulkTimeseries (object)

Field Type Description
series [Series!]! List if series used for metrics
values [Values!]! List of values to plot

CheckIn (object)

A single check-in run

Field Type Description
id String! ID of the run
expectedStart DateTime! Expected start time
actualStart DateTime Actual start time
expectedEnd DateTime Expected finish time
actualEnd DateTime Actual finish time
state CheckInStateEnum! State of the check-in
expectedDuration Int Expected duration of the run in milliseconds
actualDuration Int Actual duration of the run in milliseconds
updates [CheckInUpdate!] Update events within this run

CheckInKindEnum (enum)

Kind of check-in update

Value Description
START
FINISH

CheckInStateEnum (enum)

Possible states of a check-in

Value Description
NEW
STARTED
FINISHED
MISSED
LATE
UNEXPECTED

CheckInTrigger (object)

A check-in trigger that monitors scheduled tasks or heartbeats

Field Type Description
id String! ID of the check-in trigger
kind CheckInTriggerKindEnum! Kind of check-in trigger
identifier String! Identifier of the check-in trigger
syntax String Cron syntax
description String Description of the heartbeat trigger
waitTimeMinutes Int! Wait time in minutes
timezone String! Timezone
lastErrorAt DateTime Last error time, if present
lastSuccessAt DateTime Last success time, if present
lastUpdateAt DateTime Last update time, if present
lastState CheckInStateEnum! State of the last received check-in
notifiers [Notifier!] Notifiers attached to this trigger
logbook Logbook! Logbook for trigger
checkIns [CheckIn!] Check-in runs for this trigger
checkIn CheckIn A single check-in run

CheckInTriggerKindEnum (enum)

Kind of check-in trigger

Value Description
CRON
HEARTBEAT

CheckInUpdate (object)

An update event within a check-in run

Field Type Description
timestamp DateTime! Timestamp of check-in
digest String Digest provided by the user
kind CheckInKindEnum! Check-in kind

CheckIns (object)

Check-in management for an app

Field Type Description
triggers [CheckInTrigger!] List of check-in triggers
trigger CheckInTrigger Check-in trigger by id

Code (object)

Field Type Description
line String Code line number
source String Code source

CreateCsvExportPayload (object)

Autogenerated return type of CreateCsvExport.

Field Type Description
success Boolean!

CreateCsvExportUrlPayload (object)

Autogenerated return type of CreateCsvExportUrl.

Field Type Description
url String
filename String
success Boolean!
error String

CreateStatusPageInput (object)

Input for creating a status page

CsvExport (object)

CSV Export

Field Type Description
id String! CSV Export ID
status CsvExportStateEnum! Status of the export
fileName String Filename
fileUrl String Download url for the file
fileSize String Size of the file
completedAt DateTime
createdAt DateTime!
exportType String! Type of the export
rowCount Int Number of exported rows
errorMessage String
site App Site for the export
organization Organization Organization .for this export
requestedBy User User who requested the export. If empty, the user was deleted.

CsvExportStateEnum (enum)

Value Description
PENDING
PROCESSING
COMPLETED
FAILED

CustomMarker (object)

Marker with custom information

Field Type Description
icon String! (Emoji) Icon for custom marker
message String! Message for custom marker
id String! Marker ID
createdAt DateTime! UTC ISO8601 Datetime of deploy

Dashboard (object)

A dashboard containing multiple visualization components

Field Type Description
id String! Unique identifier for the dashboard
title String! Title of the dashboard
source DashboardSourceEnum! Source of the dashboard - user created or system generated
key String System-generated key for AUTO dashboards, used to identify specific magic dashboard types
description String Optional description of the dashboard's purpose
label String Optional label for the dashboard (e.g., beta, testing)
visuals [Visual!]! List of visualization components displayed on the dashboard
visual Visual Single visualization component from the dashboard, selected by ID
createdAt DateTime! When the dashboard was first created
updatedAt DateTime! When the dashboard was last modified
updateAvailable Boolean! Whether a newer version of the upstream magic dashboard template is available

DashboardDisplayEnum (enum)

Display style for a dashboard graph

Value Description
LINE
AREA
AREA_RELATIVE

DashboardGraphInput (object)

Input for creating or updating a dashboard graph

DashboardGraphMetricInput (object)

Input for a metric within a dashboard graph

DashboardSourceEnum (enum)

Dashboard source. User created or automatically added by the system. When AppSignal detects certain metrics, language or library specific metrics, it will add a "magic" dashboard for it and related metrics.

Value Description
USER Manually user created dashboards.
AUTO Automatically created dashboards when certain app metrics are detected.

DataInput (object)

DateTime (scalar)

UTC DateTime in ISO8601 format

DeployMarker (object)

Marker with deploy information

Field Type Description
shortRevision String First 8 characters of the git revision
revision String (Git) Revision
user String User that performed the deploy
gitCompareUrl String Git(hub/lab) compare url
namespace String Namespace of the deploy
lastOccurredAt DateTime Last occurred at
previousDeploy DeployMarker Previous deploy
liveForInWords String! Time deploy was live in words
liveFor Int! Time deploy was live in hours
exceptionCount Int! Number of exceptions in deploy
exceptionRate Float! Exception rate in deploy
newExceptionIncidents [ExceptionIncident]! Exceptions that first started happening in this deploy
id String! Marker ID
createdAt DateTime! UTC ISO8601 Datetime of deploy

EditorPreference (object)

Field Type Description
editor String
localPath String
urlTemplate String

Error (object)

Field Type Description
class String! Error class
message String Error message

ErrorCause (object)

Error cause for an exception sample

Field Type Description
name String! Error name
message String Error message
firstLine BacktraceLine First backtrace line of the error cause

Event (object)

A recorded event from a performance sample (e.g. SQL query, HTTP request)

Field Type Description
digest String Digest of event
name String Name of event
payload String Payload of event
title String Title of event
incidents [PerformanceIncident] List of actions where this event occurred
timeseries Timeseries Metrics timeseries data

Exception (object)

An exception with backtrace from a sample

Field Type Description
name String Type/Name of the exception
message String Message of the exception
backtrace [BacktraceLine] Backtrace of the exception

ExceptionIncident (object)

Exception incident in which a problem or exception was reported

Field Type Description
exceptionName String Name of exception, usually the error class
exceptionMessage String Exception message
source IncidentSourceEnum Source of exception, can be 'sample' or 'span'
firstBacktraceLine String First (application) backtrace line
errorGroupingStrategy IncidentErrorGroupingEnum! Error grouping strategy
firstMarker DeployMarker First deploy this error was seen in
notificationThreshold Int Notification threshold (nth in hour/day) for incident
sample ExceptionSample Sample for incident, returns first sample that matches the arguments
metadataDistributions [MetadataDistributions]! Metadata distributions
samples [ExceptionSample] Samples for incident
namespace String Namespace the incident occurred in.
perMarkerCount Int Total duration of all recorded requests/jobs for this incident and revision/marker
scopedCount Int Count of applied scope (e.g. selected revisions, or timeframe), defaults to total count
lastSampleOccurredAt DateTime Time of last recorded sample
hasSamplesInRetention Boolean! Indicates wether this incidents has any samples in the retention of an account
actionNames [String!] All action names where incident occurred, only exception incidents can have more than one action name
id String! Incident ID
number Int! Incident number
state IncidentStateEnum State of incident (open/closed)
severity IncidentSeverityEnum Severity of incident (critical/high/low/etc.)
notificationFrequency IncidentNotificationFrequencyEnum Notification frequency for incident
description String Incident description, or steps to solve the issue
count Int! Total count of all recorded requests/jobs for this incident
lastOccurredAt DateTime Time incident last occurred at
digests [String!] All incident digests
createdAt DateTime Create time of incident
updatedAt DateTime Last update time of incident
logbook Logbook! Logbook for incident
assignees [User] Users assigned to investigate or resolve this incident
app App App in which the incident occurred
integrations [Integration] List of available integration types

ExceptionIncidentQueryEnum (enum)

Value Description
MOST_RECENT
RECEIVING_DATA
SPECIFIC_DEPLOY
TIMEFRAME

ExceptionSample (object)

Exception sample containing relevant sample data

Field Type Description
exception Exception! Exception that occurred on the sample
firstMarker DeployMarker First deploy this error was seen in
breadcrumbs [Breadcrumb] Breadcrumbs that lead up to the exception
errorCauses [ErrorCause] Errors that lead to the sample error
id String! Internal id of the sample
appId String! Internal app id of the sample
incidentId String! Internal id of the incident this sample is linked to
namespace String Namespace the sample occurred in
action String The action name on which a sample was reported
createdAt DateTime Time at which the sample was reported
time DateTime Time when sample occurred
revision String Revision of sample
version Int Sample type version
duration Float
queueDuration Int Time spent in a queue before processing
originalId String Original ID of sample, if replaced by better sample
overview [KeyStringValue!] Overview of sample, contains request id, hostname and tags
originallyRequested SampleOriginalRequestEnum ID/timerange of original request, is present when sample differs from requested sample
params String Sample params
sessionData String Session data
attributes [KeyStringValue] Root span attributes
customData String Custom data
environment [KeyStringValue] Environment data
incident Incident Incident of sample
app App! App of sample

Export (object)

A log export

Field Type Description
id String! Export ID
s3Url String! S3 bucket URL for the export
s3AccessKey String! S3 access key for the export
compressed Boolean! Export will be Gzipped when enabled
lastRequestedAt DateTime When the export was last requested
retryCount Int Amount of export jobs that are in the `failed` state
state ExportStateEnum! Export will not run when state is Failed, and will run when state is Running or Retrying
exportJobs [ExportJob!]! Export jobs for this export

ExportJob (object)

A log export job

Field Type Description
id String! Export job ID
filename String! Filename of the exported file
url String! Download URL for the exported file
compressed Boolean! Export was compressed with Gzip
retryCount Int! Amount of times this job has been retried
timestampFrom DateTime! Start of the time range for this export job
timestampTo DateTime! End of the time range for this export job
state ExportJobStateEnum! Current state of the export job
updates [ExportJobUpdate!]! Updates for this job
duration Float Duration of the export job in milliseconds

ExportJobStateEnum (enum)

Possible states of a log export job

Value Description
REQUESTED
STARTED
COMPLETED
FAILED

ExportJobUpdate (object)

A log export job update

Field Type Description
timestamp DateTime! Time the update happened
state ExportJobStateEnum! Result (state) of the update
message String Optional message from the update

ExportStateEnum (enum)

Possible states of a log export

Value Description
RUNNING
RETRYING
FAILED

Field (object)

A list of fields to return. Example: "fields": [ {"field": COUNT}, {"field": P90} ]

GitHub (object)

Field Type Description
issues [GitHubIssue] GitHub issues
formData GitHubFormData Form data fields for GitHub integration
name String! Integration title
needsMigration Boolean! Set to true if the integration needs a migration

GitHubFormData (object)

Field Type Description
title String! Title
body String! Body

GitHubIssue (object)

Field Type Description
id String! Integration result ID
title String! Title provided by the AppSignal user
description String! Description provided by the AppSignal user
url String! Url to remote integration
remoteId String! Remote ID of integration (e.g. GitHub issue number or Asana ID

GitLab (object)

Field Type Description
issues [GitLabIssue] GitLab issues
formData GitLabFormData Form data fields for GitLab integration
name String! Integration title
needsMigration Boolean! Set to true if the integration needs a migration

GitLabFormData (object)

Field Type Description
title String! Title
body String! Body

GitLabIssue (object)

Field Type Description
id String! Integration result ID
title String! Title provided by the AppSignal user
description String! Description provided by the AppSignal user
url String! Url to remote integration
remoteId String! Remote ID of integration (e.g. GitHub issue number or Asana ID

HostedCollector (object)

A hosted collector for log collection

Field Type Description
id String! Hosted collector ID
subdomain String! Subdomain for the hosted collector
status HostedCollectorStatusEnum! Current status of the hosted collector
region String! Region where the hosted collector is deployed
isDefault Boolean! Whether this is the default hosted collector for the account
experimental Boolean! Whether this collector runs the experimental build with new features
createdAt DateTime! When the hosted collector was created
updatedAt DateTime! When the hosted collector was last updated
url String! Full URL for the hosted collector

HostedCollectorStatusEnum (enum)

Status of a hosted collector

Value Description
unprovisioned Hosted collector has not been provisioned yet
provisioning Hosted collector is being provisioned
provisioned Hosted collector is provisioned and ready to use
deprovisioning Hosted collector is being deprovisioned
deprovisioned Hosted collector has been deprovisioned
failed Hosted collector provisioning failed

Incident (union)

Incident objects. Can be performance, exception or log incident

Possible types: AnomalyIncident, ExceptionIncident, LogIncident, PerformanceIncident

IncidentErrorGroupingEnum (enum)

Error grouping of incident.

Value Description
TYPE_AND_ACTION Error grouping using the incident type (performance/error) and the namespace/action/error combination.
TYPE_AND_RELEVANT_BACKTRACE_LINE Error grouping using the backtrace line.

IncidentNotificationFrequencyEnum (enum)

Value Description
ALWAYS
NEVER
FIRST_IN_DEPLOY
FIRST_AFTER_CLOSE
NTH_IN_HOUR
NTH_IN_DAY

IncidentOrderEnum (enum)

Value Description
ID
LAST
TOTAL
IN_SELECTION

IncidentSeverityEnum (enum)

Severity levels for an incident

Value Description
UNTRIAGED
CRITICAL
HIGH
LOW
NONE
INFORMATIONAL

IncidentSourceEnum (enum)

The source of an incident (what generated this incident)

Value Description
SAMPLE This incident was generated by our sampling system
SPAN This incident was extracted from an OpenTelemetry span

IncidentStateEnum (enum)

Possible states of an incident

Value Description
OPEN Incident is active
CLOSED Incident is resolved
WIP Incident is being investigated

Integration (union)

Integration objects such as GitHub, GitLab, Trello etc.

Possible types: Asana, GitHub, GitLab, Jira, Linear, Shortcut, Trello

IntegrationCreate (object)

A record of an integration being linked

Field Type Description
name String Integration name
url String! Url to integration
via String The integration that was used to make the change
id String! Change ID.
createdAt DateTime! Time at which the change was created.
updatedAt DateTime! Time at which the change was updated last.
author User User that created the change. If empty, the user was deleted.

JSON (scalar)

Represents untyped JSON

Jira (object)

Field Type Description
issues [JiraIssue] Jira issues
formData JiraFormData Form data fields for Jira integration
name String! Integration title
needsMigration Boolean! Set to true if the integration needs a migration

JiraFormData (object)

Field Type Description
title String! Title
body String! Body

JiraIssue (object)

Field Type Description
id String! Integration result ID
title String! Title provided by the AppSignal user
description String! Description provided by the AppSignal user
url String! Url to remote integration
remoteId String! Remote ID of integration (e.g. GitHub issue number or Asana ID

KeyFloatValue (object)

Holds a key and a float value, used for metrics

Field Type Description
key String! Key of keyvalue
value Float Float value of keyvalue

KeyStringValue (object)

Holds a key and a value, used for metrics

Field Type Description
key String! Key of key value
value String Value of key value

KeyStringValueInput (object)

Key value hash GraphQL datastructure. Hash<String, String>

Linear (object)

Field Type Description
issues [LinearIssue] Linear issues
formData LinearFormData Form data fields for Linear integration
name String! Integration title
needsMigration Boolean! Set to true if the integration needs a migration

LinearFormData (object)

Field Type Description
title String! Title
body String! Body

LinearIssue (object)

Field Type Description
id String! Integration result ID
title String! Title provided by the AppSignal user
description String! Description provided by the AppSignal user
url String! Url to remote integration
remoteId String! Remote ID of integration (e.g. GitHub issue number or Asana ID

LogIncident (object)

Log incident in which a problem or exception was reported

Field Type Description
trigger LogLineActionTrigger! Trigger that triggered this incident
logLine LogLine Last log line for incident
id String! Incident ID
number Int! Incident number
state IncidentStateEnum State of incident (open/closed)
severity IncidentSeverityEnum Severity of incident (critical/high/low/etc.)
notificationFrequency IncidentNotificationFrequencyEnum Notification frequency for incident
description String Incident description, or steps to solve the issue
count Int! Total count of all recorded requests/jobs for this incident
lastOccurredAt DateTime Time incident last occurred at
digests [String!] All incident digests
createdAt DateTime Create time of incident
updatedAt DateTime Last update time of incident
logbook Logbook! Logbook for incident
assignees [User] Users assigned to investigate or resolve this incident
app App App in which the incident occurred
integrations [Integration] List of available integration types

LogLine (object)

A single log line entry

Field Type Description
id String! Log line UUID
timestamp PreciseDateTime! Time of log occurrence
source Source Source of the log
severity SeverityEnum! Severity (warn/info etc.).
hostname String! Hostname where log was recorded
group String Log group
message String! The log message
attributes [KeyStringValue!] Attributes for log line

LogLineAction (union)

A log line action. Can be a trigger, filter, or metrics action.

Possible types: LogLineActionFilter, LogLineActionMetrics, LogLineActionTrigger

LogLineActionFilter (object)

A log line filter action. Matches log lines and drops them.

Field Type Description
id String! Action ID.
name String! Action name.
query String! Query expression to match against log lines.
sourceIds [String]! Log source IDs.
actionType LogLineActionTypeEnum! Type of action.
sources [Source]! Log sources.
order Int! Order position.

LogLineActionMetrics (object)

A log line metrics action. Matches log lines and extracts metrics.

Field Type Description
id String! Action ID.
name String! Action name.
query String! Query expression to match against log lines.
sourceIds [String]! Log source IDs.
actionType LogLineActionTypeEnum! Type of action.
sources [Source]! Log sources.
logLineMetrics [LogLineMetric]! Metric definitions.
order Int! Order position.
user User The user who last modified this metric action.

LogLineActionTrigger (object)

A log line trigger action. Matches log lines and generates alerts.

Field Type Description
id String! Action ID.
name String! Action name.
description String Description provided by the user about the trigger.
query String! Query expression to match against log lines.
sourceIds [String]! Log source IDs.
severities [String]! Severities.
actionType LogLineActionTypeEnum! Type of action.
sources [Source]! Log sources.
order Int! Order position.
user User The user who created this trigger.
previousTrigger LogLineActionTrigger Previous version of this trigger.
logView View Linked log view.
notificationOptions IncidentNotificationFrequencyEnum Incident notification option.
notificationTriggerValue Int Incident notification duration threshold.
notifiers [Notifier!] Notifiers attached to this trigger.

LogLineActionTypeEnum (enum)

Value Description
TRIGGER
FILTER
METRICS

LogLineMetric (object)

A metric definition extracted from matching log lines.

Field Type Description
id String! Metric ID.
name String! Metric name.
field String Log line field to extract the value from. Null means count occurrences.
tags JSON! Tags for the metric.
metricType LogLineMetricTypeEnum! Type of metric.

LogLineMetricInput (object)

LogLineMetricTypeEnum (enum)

Value Description
COUNTER
GAUGE
DISTRIBUTION

LogLineTriggerInput (object)

Logbook (object)

Activity log for an incident or trigger

Field Type Description
id String! Note ID.
pinnedNoteId String ID of the pinned note.
items [LogbookItem!]! Logbook entries

LogbookItem (union)

Logbook item objects.

Possible types: AssigneeChange, IntegrationCreate, ManualAlertStateChange, Note, NotificationFrequencyChange, NotificationThresholdChange, NotifierResult, SeverityChange, StateChange

LogbookableTypeEnum (enum)

Types that can have a logbook

Value Description
INCIDENT
HEARTBEAT

Logs (object)

Log management for an app

Field Type Description
sources [Source]! Log sources
triggers [LogLineActionTrigger]! Log triggers
logLineActions [LogLineAction]! Log line actions
queryWindow Int! Query window in seconds
source Source Log source
vercelProjects [VercelProject]! Vercel projects linked to this app

ManualAlertStateChange (object)

A record of a manual alert state change

Field Type Description
previousState AlertStateEnum Previous state
currentState AlertStateEnum! Current state
via String The integration that was used to make the change
id String! Change ID.
createdAt DateTime! Time at which the change was created.
updatedAt DateTime! Time at which the change was updated last.
author User User that created the change. If empty, the user was deleted.

MarkerUnion (union)

Marker objects. Can be Deploy, Notification or Custom

Possible types: CustomMarker, DeployMarker, NotificationMarker

MetadataDistributions (object)

Distribution of metadata values across spans

Field Type Description
key String! Metadata key name
total Int! Total number of occurrences
unique Int! Number of unique values

MetricAggregateEnum (enum)

Fields to return in metric query

Value Description
MAX Returns maximum value of group
MIN Returns minimum value of group
AVG Returns average value of group
SUM Sums values of group
FIRST Returns the first seen value of field
LAST Returns the last seen value of field

MetricAggregation (object)

Input to request a Metric List Example of an Aggegration input query: { "name": "transaction_duration", "tags": [ {"key": "action", "value": "*"}, {"key": "namespace", "value": "b"} ], "fields": [{"field": COUNT, "aggregate": SUM}] }

MetricFieldEnum (enum)

Fields to return in metric query

Value Description
MEAN Mean of measurement
P90 90th percentile of measurement
P95 95th percentile of measurement
COUNT Count of measurement/counter
GAUGE Gauge value
COUNTER Counter value

MetricKey (object)

Metric key extracted from timeseries data.

Field Type Description
digest String! Digest of metric key.
name String! Metric key name.
fields [MetricFieldEnum!]! Metric fields
type MetricTypeEnum! Metric type
tags [KeyStringValue!] List of tags for metric key.

MetricTimeseries (object)

Input to request timeseries Metric data Example of an Aggegration input query: { "name": "transaction_duration", "tags": [ {"key": "action", "value": "*"}, {"key": "namespace", "value": "b"} ], "fields": [ { "field": COUNT }, { "field": MEAN } ] }

MetricTypeEnum (enum)

Type of metric

Value Description
GAUGE A point-in-time value
MEASUREMENT A distribution of values
COUNTER An incrementing value

Metrics (object)

Holds different metric fields

Field Type Description
list AggregationList (Aggregated) List of requested metrics and fields
timeseries Timeseries Metrics timeseries data
keys [MetricKey!] List of metric keys

Mutation (object)

The mutation root of this schema.

Field Type Description
createApp App Create a new app
deleteApp App Delete an app and all its data
pinApp App Pin an app to the current user's pinned apps
unpinApp App Unpin an app from the current user's pinned apps
createOrUpdateCustomMarker CustomMarker Create or update a custom marker
deleteCustomMarker CustomMarker Delete a custom marker
updateIncident Incident Update an incident's state, severity, or assignees
bulkUpdateIncidents [Incident!] Update multiple incidents at once
createIncidentNote Incident Create a note on an incident
deleteLogbookNote Logbook Delete a note from a logbook
updateLogbookNote Logbook Update a note in a logbook
pinLogbookComment Logbook Pin a comment in a logbook
unpinLogbookComment Logbook Unpin a comment in a logbook
createAsanaTask Incident Create an Asana task from an incident
createShortcutStory Incident Create a Shortcut story from an incident
createGithubIssue Incident Create a GitHub issue from an incident
createGitlabIssue Incident Create a GitLab issue from an incident
createJiraIssue Incident Create a Jira issue from an incident
createTrelloCard Incident Create a Trello card from an incident
createLinearIssue Incident Create a Linear issue from an incident
removeIntegration Incident Remove a linked integration from an incident
createTrigger Trigger Create a trigger for metric-based alerts
archiveTrigger Trigger Archive a trigger
createDashboard Dashboard Create a new dashboard
updateDashboard Dashboard Update a dashboard
deleteDashboard Dashboard Delete a dashboard
importDashboard Dashboard Import a dashboard from JSON
updateMagicDashboard Dashboard Apply the latest upstream template to an auto-generated dashboard, overwriting any user customizations.
replaceMagicDashboard Dashboard Demote an auto-generated dashboard to a regular user dashboard (keeping the user's customizations) and create a fresh auto dashboard from the latest upstream template alongside it. Returns the new dashboard.
dismissMagicDashboardUpdate Dashboard Dismiss the update prompt for an auto-generated dashboard. The prompt will reappear once the upstream template changes again.
createVisualTimeseries Dashboard Add a timeseries visual to a dashboard
updateVisualTimeseries Dashboard Update a timeseries visual
createVisualNumber Dashboard Add a number visual to a dashboard
updateVisualNumber Dashboard Update a number visual
updateVisualLayouts Dashboard Update layouts of visuals on a dashboard
deleteVisual Dashboard Delete a visual from a dashboard
usedFeature Viewer Record that a user has used a feature
createUptimeMonitor UptimeMonitor Create an uptime monitor
updateUptimeMonitor UptimeMonitor Update an uptime monitor
deleteUptimeMonitor UptimeMonitor Delete an uptime monitor
createSavedVisual SavedVisual Create a saved visual
createStatusPage StatusPage Create a status page
updateStatusPage StatusPage Update a status page
deleteStatusPage StatusPage Delete a status page
createStatusPageUpdate StatusPageUpdate Create a status page update
updateStatusPageUpdate StatusPageUpdate Update a status page update
deleteStatusPageUpdate StatusPageUpdate Delete a status page update
archiveAlert Boolean Archive an alert
createLogSource Source Create a log source
deleteLogSource Source Delete a log source
updateLogSource Source Update a log source
createLogView View Create a log view
updateLogView View Update a log view
deleteLogView View Delete a log view
updateViewer Viewer Update the current user's preferences
markTooltipAsSeen Viewer Mark a tooltip as seen for the current user
createLogTrigger LogLineActionTrigger Create a log trigger
updateLogTrigger LogLineActionTrigger Update a log trigger
deleteLogTrigger LogLineActionTrigger Delete a log trigger
createLogLineAction LogLineAction
updateLogLineAction LogLineAction
deleteLogLineAction LogLineAction
reorderLogLineActions [LogLineAction]
endLastAlert AnomalyIncident Close the last open alert for an anomaly incident
createLogExport Export Create a log export
updateLogExport Export Update a log export
deleteLogExport Export Delete a log export
createCheckInTrigger CheckInTrigger Create a check-in trigger
updateCheckInTrigger CheckInTrigger Update a check-in trigger
deleteCheckInTrigger CheckInTrigger Delete a check-in trigger
deleteCheckIn CheckIn Delete a check-in run
createCheckInTriggerNote CheckInTrigger Create a note on a check-in trigger
createCsvExport CreateCsvExportPayload Start a CSV export
createCsvExportUrl CreateCsvExportUrlPayload Generate a download URL for a completed CSV export
createHostedCollector HostedCollector Create a hosted collector for an organization
updateHostedCollector HostedCollector Update a hosted collector for an organization
updateQuest [Quest!] Update the state of a Discover AppSignal quest. Use OPEN to unskip.

Namespace (object)

Namespace for an app, contains deploy markers

Field Type Description
id String! Unique identifier for the namespace
name String! Namespace name
deployMarkers [DeployMarker] List of deploy markers for this namespace

Note (object)

A user-created note in the logbook

Field Type Description
id String! Note ID.
content String! Content of the note.
createdAt DateTime! Time at which the note was created.
updatedAt DateTime! Time at which the note was updated last.
viewerCanDelete Boolean! Returns true if user can delete this note.
viewerCanEdit Boolean! Returns true if user can edit this note.
author User User that created the note. If empty, the user was deleted.
via String The integration that was used to make the change

NotificationFrequencyChange (object)

A record of a notification frequency change

Field Type Description
previousFrequency IncidentNotificationFrequencyEnum Previous frequency
currentFrequency IncidentNotificationFrequencyEnum! Current frequency
via String The integration that was used to make the change
id String! Change ID.
createdAt DateTime! Time at which the change was created.
updatedAt DateTime! Time at which the change was updated last.
author User User that created the change. If empty, the user was deleted.

NotificationMarker (object)

Marker with important AppSignal information

Field Type Description
message String! Message with AppSignal information
id String! Marker ID
createdAt DateTime! UTC ISO8601 Datetime of deploy

NotificationThresholdChange (object)

A record of a notification threshold change

Field Type Description
previousThreshold Int Previous threshold
currentThreshold Int! Current threshold
via String The integration that was used to make the change
id String! Change ID.
createdAt DateTime! Time at which the change was created.
updatedAt DateTime! Time at which the change was updated last.
author User User that created the change. If empty, the user was deleted.

Notifier (object)

Destination for alerts, such as Slack, Discord or Email

Field Type Description
id String! Notifier ID
name String! User configured notifier name
icon String! Notifier icon

NotifierResult (object)

Results from notifier deliveries

Field Type Description
results [Result!]! Notifier results
id String! Change ID.
createdAt DateTime! Time at which the change was created.
updatedAt DateTime! Time at which the change was updated last.
author User User that created the change. If empty, the user was deleted.

Organization (object)

An AppSignal organization

Field Type Description
id String! Organization ID
name String! Organization name
slug String! Organization slug
ttl Int! Organization retention in seconds
heroku Boolean! True if the organization is made by our Heroku add-on,
throughputLast30Days Int! Throughput in last 30 days
pushApiKey String! Organization Push API key
inTrial Boolean! Is true when account is in trial period
daysLeftInTrial Int Days left in trial, is `null` when plan is paid
onFreePlan Boolean! Is true when account is on free plan
apiAccessRestricted Boolean! Is true when API access is restricted
upgradeScheduled Boolean! Is true when an upgrade is scheduled for this organization
currentUserIsOwner Boolean! Is true when the current user is an owner of this organization
apps [App] Apps for this organization
users [User] Users belonging to an organization
billingCycleUsage BillingCycleUsage Usage information for this organization
search [Sample] Filter samples across apps on 'overview' data
statusPages [StatusPage] Status pages for organization
statusPage StatusPage Status page for given ID
statusPageUpdate StatusPageUpdate Status page update for given ID
links [Link] Linked apps through distributed tracing
csvExports [CsvExport] List of CSV exports
hostedCollectors [HostedCollector] Hosted collectors for this organization
hostedCollector HostedCollector Get a specific hosted collector by ID
quests [Quest!]! Quests for the Discover AppSignal page

PaginatedAnomalyIncidents (object)

Anomaly incidents with pagination information

Field Type Description
total Int Incident total
rows [AnomalyIncident!]! Anomaly incidents

PaginatedExceptionIncidents (object)

Exception incidents with pagination information

Field Type Description
total Int Incident total
rows [ExceptionIncident!]! Exception incidents

PaginatedLogIncidents (object)

Log incidents with pagination information

Field Type Description
total Int Incident total
rows [LogIncident!]! Log incidents

PaginatedPerformanceIncidents (object)

Performance incidents with pagination information

Field Type Description
total Int Incident total
rows [PerformanceIncident!]! Performance incidents

PerformanceIncident (object)

Performance incident in which a problem or exception was reported

Field Type Description
totalDuration Float! Total duration of all recorded requests/jobs for this incident
mean Float! Mean duration of all recorded requests/jobs for this incident
perMarkerMean Float Mean duration of all recorded requests/jobs for this incident and given revision/marker
perMarkerTotalDuration Float Total duration of all recorded requests/jobs for this incident and given revision/marker
perMarkerHasNPlusOne Boolean Value is true when we encountered a sample with a N+1 query for this incident and given revision/marker
deployMarkers [PerformanceMarker]! Deploy markers for incident
hasNPlusOne Boolean Value to indicate that any of the last 5 deploys had an N+1 query
notificationThreshold Int Notification threshold (in ms) for incident
sample PerformanceSample Sample for incident, returns first sample that matches the arguments
samples [PerformanceSample] Samples for incident
namespace String Namespace the incident occurred in.
perMarkerCount Int Total duration of all recorded requests/jobs for this incident and revision/marker
scopedCount Int Count of applied scope (e.g. selected revisions, or timeframe), defaults to total count
lastSampleOccurredAt DateTime Time of last recorded sample
hasSamplesInRetention Boolean! Indicates wether this incidents has any samples in the retention of an account
actionNames [String!] All action names where incident occurred, only exception incidents can have more than one action name
id String! Incident ID
number Int! Incident number
state IncidentStateEnum State of incident (open/closed)
severity IncidentSeverityEnum Severity of incident (critical/high/low/etc.)
notificationFrequency IncidentNotificationFrequencyEnum Notification frequency for incident
description String Incident description, or steps to solve the issue
count Int! Total count of all recorded requests/jobs for this incident
lastOccurredAt DateTime Time incident last occurred at
digests [String!] All incident digests
createdAt DateTime Create time of incident
updatedAt DateTime Last update time of incident
logbook Logbook! Logbook for incident
assignees [User] Users assigned to investigate or resolve this incident
app App App in which the incident occurred
integrations [Integration] List of available integration types

PerformanceMarker (object)

An AppSignal incident

Field Type Description
id String! Id of deploy marker
marker DeployMarker! Deploy marker
count Int! Incident number
mean Int! Incident number

PerformanceSample (object)

Performance sample containing relevant sample data

Field Type Description
hasNPlusOne Boolean! Indicates if sample contains a N+1 query when true
timelineTruncatedEvents Int! Amount of truncated events, if the event tree limit was reached
duration Float! Duration of performance sample
timeline [TimelineEvent]! Event timeline of performance sample
groupDurations [KeyFloatValue!]! Grouped durations of performance sample
groupAllocations [KeyFloatValue!]! Grouped allocations of performance sample
id String! Internal id of the sample
appId String! Internal app id of the sample
incidentId String! Internal id of the incident this sample is linked to
namespace String Namespace the sample occurred in
action String The action name on which a sample was reported
createdAt DateTime Time at which the sample was reported
time DateTime Time when sample occurred
revision String Revision of sample
version Int Sample type version
queueDuration Int Time spent in a queue before processing
originalId String Original ID of sample, if replaced by better sample
overview [KeyStringValue!] Overview of sample, contains request id, hostname and tags
originallyRequested SampleOriginalRequestEnum ID/timerange of original request, is present when sample differs from requested sample
params String Sample params
sessionData String Session data
attributes [KeyStringValue] Root span attributes
customData String Custom data
environment [KeyStringValue] Environment data
incident Incident Incident of sample
app App! App of sample

Point (object)

Group of datapoints in timeseries

Field Type Description
timestamp Int! Timestamp of bucket
values [KeyFloatValue!] Points returned for bucket

PreciseDateTime (scalar)

UTC DateTime in rfc3339 format with a 3-digit precision

Query (object)

The query root of this schema

Field Type Description
viewer Viewer Current logged in user
organization Organization Organization the current user belongs to
app App AppSignal App
timezones [Timezone!]! List of supported timezones

Quest (object)

A quest on the Discover AppSignal page

Field Type Description
key String! Unique quest key
type String! Quest type: main or side
category String Quest category (side quests only)
title String! Quest title
instructions String Instructions for completing the quest (supports Markdown links)
ctaText String Primary call-to-action button label
ctaUrl String Primary call-to-action URL (may contain :organizationSlug template)
state QuestStateEnum! Current state of the quest
supportsInProgress Boolean! Whether a quest can be in progress
paidPlanFeature Boolean! Whether this quest requires a paid plan
manualCompletion Boolean Whether this quest can only be completed manually (no automatic checker)

QuestStateEnum (enum)

Value Description
OPEN
IN_PROGRESS
DONE
SKIPPED

ResolutionEnum (enum)

Resolution values to be used with metrics.

Value Description
MINUTELY Resolution of: minutely
HOURLY Resolution of: hourly
DAILY Resolution of: daily

Result (object)

Field Type Description
successCount Int! Success count
errorCount Int! Error count
successLast DateTime Timestamp of last succesfull notifier
errorLast DateTime Timestamp of last notifier error
notifier Notifier Notifier

Sample (union)

Sample objects. Can be performance or exception sample

Possible types: ExceptionSample, PerformanceSample

SampleOriginalRequestEnum (enum)

The original requested item. We return this if we send an alternative

Value Description
NONE No alternative sample is being returned
ID Sample was requested by ID, but we are returning an alternative
TIMESTAMP Sample was requested by timestamp, but we are returning an alternative
TIMERANGE Sample was requested by timerange, but we are returning an alternative

SampleTypeEnum (enum)

Types of sample.

Value Description
EXCEPTION Exception sample
PERFORMANCE Performance sample

SavedVisual (object)

Saved visual

Field Type Description
id String! ID of saved visual
pngUrl String! URL to saved visual PNG
htmlUrl String! URL to page with SVG of saved visual
jsonUrl String! URL to saved visual PNG
csvUrl String! URL to page with SVG of saved visual
title String! Title of the saved visual

SerieInput (object)

Series (object)

Field Type Description
digest String! Digest of metric key.
name String! Metric name
tags [KeyStringValue]! Metric tags
type MetricTypeEnum! Metric type

SeverityChange (object)

A record of an incident severity change

Field Type Description
previousSeverity IncidentSeverityEnum Previous severity
currentSeverity IncidentSeverityEnum! Current severity
via String The integration that was used to make the change
id String! Change ID.
createdAt DateTime! Time at which the change was created.
updatedAt DateTime! Time at which the change was updated last.
author User User that created the change. If empty, the user was deleted.

SeverityEnum (enum)

Log severity levels

Value Description
UNKNOWN
TRACE
DEBUG
INFO
NOTICE
WARN
ERROR
CRITICAL
ALERT
FATAL

Shortcut (object)

Field Type Description
stories [ShortcutStory] Shortcut stories
formData ShortcutFormData Form data fields for Shortcut integration
name String! Integration title
needsMigration Boolean! Set to true if the integration needs a migration

ShortcutFormData (object)

Field Type Description
title String! Title
body String! Body

ShortcutStory (object)

Field Type Description
id String! Integration result ID
title String! Title provided by the AppSignal user
description String! Description provided by the AppSignal user
url String! Url to remote integration
remoteId String! Remote ID of integration (e.g. GitHub issue number or Asana ID

Source (object)

A log source

Field Type Description
id String! Source ID
name String! Name of this source
type String! Type of the source
key String! API key of the source
fmt SourceFormatEnum! Log format
canBeModified Boolean! Indicates if source can be removed. The default Application source cannot be removed
parseSeverity Boolean! If true, we'll attempt to parse any severity string from the log message
usageBytesLast24h Int! Usage in bytes for the last 24 hours
metrics BulkTimeseries DEPRECATED: Metrics for log source
export Export Log exports for this source

SourceFormatEnum (enum)

Log source format

Value Description
PLAINTEXT
LOGFMT
JSON
AUTODETECT

Spans (object)

Span data for an app

Field Type Description
metadataDistributions [MetadataDistributions]! Metadata distributions
metadataDistribution [KeyFloatValue]! Metadata distribution

StateChange (object)

A record of an incident state change

Field Type Description
previousState IncidentStateEnum Previous state
currentState IncidentStateEnum! Current state
via String The integration that was used to make the change
id String! Change ID.
createdAt DateTime! Time at which the change was created.
updatedAt DateTime! Time at which the change was updated last.
author User User that created the change. If empty, the user was deleted.

StatusPage (object)

A public status page for monitoring services

Field Type Description
id String! ID of the status page
title String! Title of the page
description String Description of the page
hasSsl Boolean! Boolean indicating if SSL Cert has been requested for status page
forceSsl Boolean! Boolean indicating if redirect from http to https has been enabled
hostname String! Domain of the page
threshold Int Minimum threshold for considering a service down
state StatusPageStateEnum! State of all monitored services on the status page.
uptimeMonitors [UptimeMonitor!] Uptime monitors associated with this page
uptimeMonitorIds [String!] Ids for uptime monitors
updates [StatusPageUpdate!] Updates from the last 7 days for this page

StatusPageStateEnum (enum)

Status page state

Value Description
UP up
DOWN down

StatusPageUpdate (object)

An update posted to a status page

Field Type Description
id String! ID of the status page update
createdAt DateTime! Time of status update
title String! Title of the update
description String! Description of the update
state StatusPageUpdateStateEnum! State of the update.

StatusPageUpdateInput (object)

Input for creating or updating a status page update

StatusPageUpdateStateEnum (enum)

Status page update state

Value Description
INVESTIGATING investigating
IDENTIFIED identified
RECOVERING recovering
RESOLVED resolved

TagInput (object)

A list of tags to narrow/group aggregation, example: "tags": [ {"key": "action", "value": "*"}, {"key": "namespace", "value": "b"} ]

ThresholdAlertSettingComparisonOperationEnum (enum)

Comparision operation to use to compare against a value.

Value Description
LESS_THAN Less than
GREATER_THAN Greater than
LESS_THAN_OR_EQUAL Less than or equal
GREATER_THAN_OR_EQUAL Greater than or equal
EQUAL Equal
NOT_EQUAL Not equal

ThresholdCondition (object)

Settings for the AlertConfiguration to compare against.

Field Type Description
id String! Threshold alert setting ID.
value Float! Threshold value. The comparison operator uses this value to compare against the real value.
comparisonOperator ThresholdAlertSettingComparisonOperationEnum! Comparision operator to use in this alert check.
humanComparisonOperator String! Human readable version of the comparision used in this check.

ThresholdConditionInput (object)

Settings for the AlertConfiguration to compare against.

TimeDetectiveDataPoint (object)

A data point in a time detective analysis

Field Type Description
mean Float Average duration of the samples in this incident for the selected timeframe.
p90 Float 90th percentile of the samples in this incident for the selected timeframe.
throughput Int Throughput of the samples in this incident for the selected timeframe.
namespace String Namespace of snapshot
actionName String Action of snapshot
exceptionName String Exception of snapshot
incident Incident Incident of snapshot

TimeframeEnum (enum)

Timeframes to be used with metrics.

Value Description
R1H Timeframe of: 1
R4H Timeframe of: 4
R8H Timeframe of: 8
R12H Timeframe of: 12
R24H Timeframe of: 24
R48H Timeframe of: 48
R7D Timeframe of: 7
R30D Timeframe of: 30

TimelineEvent (object)

Event belonging in a performance sample timeline

Field Type Description
digest String! Event digest, idempotent for action/payload combination
duration Float! Duration of event, in ms
childDuration Float! Duration of all children of event, in ms
time Float! Time event record was started
end Float! Time event record was ended
count Int! Number of times event has occurred. More than one time means N+1
level Int! Nesting level of event
action String! Event action (e.g. query)
group String Event group (e.g. sql)
name String Event name (e.g. User load)
payload TimelineEventPayload Event payload (e.g. a sanitized SQL query)
wrapping Boolean! True if this is a wrapping event
allocationCount Float Memory allocations during event
childAllocationCount Float Memory allocations of all children

TimelineEventPayload (object)

Payload belonging event in a performance sample timeline

Field Type Description
name String Name of payload (e.g. User Load)
body String Body of payload (e.g an `sql query)

Timeseries (object)

Timeseries data of metrics

Field Type Description
start DateTime! Start time of performed metric query
end DateTime! End time of performed metric query
resolution ResolutionEnum Resolution for returned series
keys [MetricKey!] Keys used to fetch metrics
points [Point!] Rows returned for aggregated list

Timezone (object)

Timezone information

Field Type Description
name String! Timezone friendly name
identifier String! Timezone abbreviation
offset String! Timezone UTC offset

Trello (object)

Field Type Description
cards [TrelloCard] Trello cards
formData TrelloFormData Form data fields for Trello integration
name String! Integration title
needsMigration Boolean! Set to true if the integration needs a migration

TrelloCard (object)

Field Type Description
listId String! ID of the destination list
id String! Integration result ID
title String! Title provided by the AppSignal user
description String! Description provided by the AppSignal user
url String! Url to remote integration
remoteId String! Remote ID of integration (e.g. GitHub issue number or Asana ID

TrelloFormData (object)

Field Type Description
lists [KeyStringValue!]! Available Trello lists
title String! Title
body String! Body

Trigger (object)

An alert trigger. Configuration used to decide if a metric value requires an alert.

Field Type Description
id String! Alert configuration ID.
field MetricFieldEnum! Field which will be compared against for this alert.
user User The user who created this Trigger.
kind String! Trigger kind (exception rate/ throughput etc).
description String Description provided by the user about the trigger
name String! Name provided by the user about the trigger
thresholdCondition ThresholdCondition!
warmupDuration Int! Time in minutes AppSignal waits before opening an alert and sending a notification about it.
cooldownDuration Int! Time in minutes AppSignal waits before closing an alert and sending a notification about it.
tags [KeyStringValue!] Map of tags that will filter which metrics to include. Values may include wildcards: *value*
notifiers [Notifier!]
metricName String! The metric this trigger is about.
previousTrigger Trigger
noMatchIsZero Boolean! If true, when no data is received it treats the value as 0.
dashboardId String ID of linked dashboard to trigger.
format String The data format of the metric the trigger is configured. For more information, see our docs: https://docs.appsignal.com/metrics/custom.html#metric-values
formatInput String The data format input size for the "size" format. For more information, see our docs: https://docs.appsignal.com/metrics/custom.html#metric-values

UpdateStatusPageInput (object)

Input for updating a status page

UptimeMonitor (object)

An uptime monitor that checks endpoint availability

Field Type Description
id String! Uptime Monitor ID.
name String! Name of endpoint.
url String! Url for endpoint.
description String Description for monitor
warmupDuration Int! Warmup duration in minutes
notifierIds [String]! Notifier IDs for monitor
notifiers [Notifier]! List of notifiers for this monitor
headers [KeyStringValue] Headers to send with monitor request
checkBodyContent String {description: "If present, uptime monitor will check response body content for this string.", null: true}
monitorSslExpiration Boolean {description: "Whether to monitor SSL certificate expiration for this endpoint.", null: false}
regions [UptimeMonitorRegionEnum!] {description: "List of regions where the monitor is pinging from", null: false}
statusPages [StatusPage]! List of status pages this monitor is used on
alerts [Alert]! List of alerts for this monitor

UptimeMonitorInput (object)

Input for creating or updating an uptime monitor

UptimeMonitorRegion (object)

A region where uptime monitoring is available

Field Type Description
id UptimeMonitorRegionEnum! Uptime Monitor Region id.
name String! Name of region.

UptimeMonitorRegionEnum (enum)

Available regions for Uptime monitoring.

Value Description
EUROPE Uptime monitor region: europe
NORTH_AMERICA Uptime monitor region: north-america
ASIA_PACIFIC Uptime monitor region: asia-pacific
SOUTH_AMERICA Uptime monitor region: south-america

UrlTemplate (object)

Url template, used to generate links from log/trace/sample attributes

Field Type Description
label String! Label for the generated URL
tags [String] Tag(s) needed to build the URL
line String! Url template

User (object)

An AppSignal user

Field Type Description
id String! User ID
name String! User's name
email String! User primary Email
emailHash String! User email hash as SHA256
gravatarEnabled Boolean! User has gravatar enabled
initials String! User initials
organizations [Organization]! All organizations this user has access to

Values (object)

Field Type Description
values [KeyFloatValue!]! Time of log occurrence

VercelProject (object)

A Vercel project, used in Log Source

Field Type Description
projectId String! Vercel Project ID
integrationId String! Vercel Integration ID
name String! Name of project

View (object)

A log view

Field Type Description
id String! View ID
name String! Name of this view
query String! Query of this view
sourceIds [String!]! Sources of this view
severities [String!]! Severities of this view
columns [String!] Columns of this view
lineHeight String! Line height of this view

Viewer (object)

A logged-in AppSignal user

Field Type Description
usedFeatures [String!]! List of features used by user
seenTooltips [String!]! List of tooltips seen by the user
chartShowHorizontalLines Boolean! Show horizontal chart lines when true
chartShowVerticalLines Boolean! Show vertical chart lines when true
chartShowMarkers Boolean Show chart markers when true
chartLineThickness Float! Chart line thickness
chartColorPalette String! Chart color palette
token String! Authentication token
organizations [Organization]! List of organizations user belongs to
incidents [Incident]! List of all incidents within the projects the user has access to
assignedIncidents [Incident]! List of all incidents assigned to viewer
isExternallyControlled Boolean! Is user controlled by SAML Single Sign-On
id String! User ID
name String! User's name
email String! User primary Email
emailHash String! User email hash as SHA256
gravatarEnabled Boolean! User has gravatar enabled
initials String! User initials

Visual (union)

Visual object, used in dashboards. Can be timeseries or number.

Possible types: VisualNumber, VisualTimeseries

VisualDisplayEnum (enum)

Some data is better understood if the graph is rendered in a different way. The following different types of different visuals are supported on dashboards. - LINE: Line graphs. - AREA: Area graphs. - AREA_RELATIVE: Relative area graphs. For more information see: https://docs.appsignal.com/metrics/dashboards.html

Value Description
LINE
AREA
AREA_RELATIVE

VisualLayout (object)

Grid layout positioning for a visual

Field Type Description
x Int! X position in grid layout
y Int! Y position in grid layout
w Int! Width in grid layout units
h Int! Height in grid layout units

VisualLayoutInput (object)

Grid layout positioning for a visual

VisualLayoutUpdateInput (object)

Input for updating a single visual's layout

VisualNumber (object)

Number visual, used on dashboard to show a single big number.

Field Type Description
metric VisualNumberMetric The metric to display
id String! Unique identifier for the visual
title String! Visual title
description String Visual description
format String Format string for the visual display
formatInput String Format input string for the visual
layout VisualLayout Grid layout positioning

VisualNumberInput (object)

Input for creating or updating a number visual

VisualNumberMetric (object)

A metric displayed in a number visual

Field Type Description
name String! Metric name
field MetricFieldEnum Metric field name
aggregate MetricAggregateEnum Aggregation type
tags [KeyStringValue!] List of tags of the metric

VisualNumberMetricInput (object)

Input for a metric within a number visual

VisualTimeseries (object)

Timeseries visual, used on dashboard to show a timeseries graph.

Field Type Description
lineLabel String Customizable name for the line. Support replacements for the metric names, fields and tags with %name%, %field% and %tag% (where tag is the tag name you've specified). Defaults to %name%
display VisualDisplayEnum Display type for the visual (line, area, or relative area)
drawNullAsZero Boolean Whether to draw null values as zero instead of gaps in the graph
minYAxis Float Minimum value for the Y axis
metrics [VisualTimeseriesMetric!]! List of metrics to display in the timeseries
id String! Unique identifier for the visual
title String! Visual title
description String Visual description
format String Format string for the visual display
formatInput String Format input string for the visual
layout VisualLayout Grid layout positioning

VisualTimeseriesInput (object)

Input for creating or updating a timeseries visual

VisualTimeseriesMetric (object)

A metric displayed in a timeseries visual

Field Type Description
name String! Metric name
fields [VisualTimeseriesMetricField!] Metric fields
tags [KeyStringValue!] List of tags of the graph

VisualTimeseriesMetricField (object)

A field configuration for a timeseries metric

Field Type Description
field MetricFieldEnum Metric field name

VisualTimeseriesMetricFieldInput (object)

Input for a field within a timeseries metric

VisualTimeseriesMetricInput (object)

Input for a metric within a timeseries visual