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.
POST /graphql
Content-Type: application/json
{
"query": "{ viewer { email } }",
"variables": {}
}
Organization the current user belongs to
| Name | Type | Required | Description |
|---|---|---|---|
slug |
String! | Yes | Slug of the organization |
Create a new app
| Name | Type | Required | Description |
|---|---|---|---|
organizationSlug |
String! | Yes | Parent organization of the app |
name |
String! | Yes | App name |
environment |
String! | Yes | App environment |
Create a hosted collector for an organization
| 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. |
Delete an app and all its data
| Name | Type | Required | Description |
|---|---|---|---|
appId |
String! | Yes |
Pin an app to the current user's pinned apps
| Name | Type | Required | Description |
|---|---|---|---|
appId |
String! | Yes |
Unpin an app from the current user's pinned apps
| Name | Type | Required | Description |
|---|---|---|---|
appId |
String! | Yes |
Update a hosted collector for an organization
| 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. |
Update the state of a Discover AppSignal quest. Use OPEN to unskip.
| 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. |
Update multiple incidents at once
| 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 |
Create a note on an incident
| Name | Type | Required | Description |
|---|---|---|---|
incidentNumber |
Int! | Yes | Incident number |
content |
String! | Yes | Content of the note |
appId |
String! | Yes |
Delete a note from a logbook
| 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 |
Pin a comment in a logbook
| Name | Type | Required | Description |
|---|---|---|---|
logbookableId |
String! | Yes | Logbookable ID |
logbookableType |
LogbookableTypeEnum! | Yes | Logbookable type |
commentId |
String! | Yes | Comment ID |
appId |
String! | Yes |
Unpin a comment in a logbook
| Name | Type | Required | Description |
|---|---|---|---|
logbookableId |
String! | Yes | Logbookable ID |
logbookableType |
LogbookableTypeEnum! | Yes | Logbookable type |
appId |
String! | Yes |
Update an incident's state, severity, or assignees
| 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 |
Update a note in a logbook
| Name | Type | Required | Description |
|---|---|---|---|
logbookableId |
String! | Yes | |
logbookableType |
LogbookableTypeEnum! | Yes | |
id |
String! | Yes | |
content |
String! | Yes | |
appId |
String! | Yes |
Create a new dashboard
| 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 |
Create a saved visual
| 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 |
Add a number visual to a dashboard
| Name | Type | Required | Description |
|---|---|---|---|
dashboardId |
String! | Yes | Dashboard ID. |
visual |
VisualNumberInput! | Yes | Big Number Visual to create. |
appId |
String! | Yes |
Add a timeseries visual to a dashboard
| Name | Type | Required | Description |
|---|---|---|---|
dashboardId |
String! | Yes | Dashboard ID. |
visual |
VisualTimeseriesInput! | Yes | Visual to create. |
appId |
String! | Yes |
Delete a dashboard
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Dashboard ID. |
appId |
String! | Yes |
Delete a visual from a dashboard
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Id of the visual to delete. |
appId |
String! | Yes |
Dismiss the update prompt for an auto-generated dashboard. The prompt will reappear once the upstream template changes again.
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Dashboard ID |
appId |
String! | Yes |
Import a dashboard from JSON
| Name | Type | Required | Description |
|---|---|---|---|
json |
String! | Yes | JSON encoded string containing dashboard definition |
appId |
String! | Yes |
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.
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | ID of the existing auto dashboard to replace |
appId |
String! | Yes |
Update a dashboard
| 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 |
Apply the latest upstream template to an auto-generated dashboard, overwriting any user customizations.
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Dashboard ID |
appId |
String! | Yes |
Update layouts of visuals on a dashboard
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Dashboard ID |
layouts |
[VisualLayoutUpdateInput!]! | Yes | List of visual layouts to update. |
appId |
String! | Yes |
Update a number visual
| 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 |
Update a timeseries visual
| Name | Type | Required | Description |
|---|---|---|---|
visualId |
String! | Yes | Id of the visual to update. |
visual |
VisualTimeseriesInput! | Yes | Visual to update. |
appId |
String! | Yes |
Archive an alert
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | ID of alert to be archived |
appId |
String! | Yes |
Boolean
Archive a trigger
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Id of record to remove. |
appId |
String! | Yes |
Create a trigger for metric-based alerts
| 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 |
Close the last open alert for an anomaly incident
| 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 |
Create a log export
| 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 |
| 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 |
Create a log source
| 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 |
Create a log trigger
| 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 |
Create a log view
| 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 |
Delete a log export
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Export ID. |
appId |
String! | Yes |
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Log line action ID. |
appId |
String! | Yes |
Delete a log source
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Source ID. |
appId |
String! | Yes |
Delete a log trigger
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Log Trigger ID. |
appId |
String! | Yes |
Delete a log view
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Log View ID. |
appId |
String! | Yes |
| Name | Type | Required | Description |
|---|---|---|---|
actionIds |
[String]! | Yes | Ordered list of log line action IDs. |
appId |
String! | Yes |
Update a log export
| 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 |
| 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 |
Update a log source
| 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 |
Update a log trigger
| 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 |
Update a log view
| 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 |
Create or update a custom marker
| 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 |
Delete a custom marker
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Id of custom marker to remove. |
appId |
String! | Yes |
Create an uptime monitor
| Name | Type | Required | Description |
|---|---|---|---|
uptimeMonitor |
UptimeMonitorInput! | Yes | Uptime monitor to create. |
appId |
String! | Yes |
Delete an uptime monitor
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | ID of the uptime monitor to remove. |
appId |
String! | Yes |
Update an uptime monitor
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | ID of the uptime monitor to update. |
uptimeMonitor |
UptimeMonitorInput! | Yes | Uptime monitor to update. |
appId |
String! | Yes |
Create a check-in trigger
| 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 |
Create a note on a check-in trigger
| Name | Type | Required | Description |
|---|---|---|---|
checkInTriggerId |
String! | Yes | Check-in trigger ID |
content |
String! | Yes | Content of the note |
appId |
String! | Yes |
Delete a check-in run
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Check-in ID. |
appId |
String! | Yes |
Delete a check-in trigger
| Name | Type | Required | Description |
|---|---|---|---|
id |
String! | Yes | Check-in Trigger ID. |
appId |
String! | Yes |
Update a check-in trigger
| 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 |
Start a CSV export
| Name | Type | Required | Description |
|---|---|---|---|
type |
String! | Yes | Type of data to export |
filters |
JSON | No | Filters to apply to the export |
appId |
String! | Yes |
Generate a download URL for a completed CSV export
| Name | Type | Required | Description |
|---|---|---|---|
exportId |
String! | Yes | ID of the export |
organizationSlug |
String! | Yes | Parent organization of the app |
Create a status page
| Name | Type | Required | Description |
|---|---|---|---|
organizationSlug |
String! | Yes | Organization slug where the status pages belongs. |
statusPage |
CreateStatusPageInput! | Yes | Status page to create |
Create a status page update
| 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 |
Delete a status page
| Name | Type | Required | Description |
|---|---|---|---|
organizationSlug |
String! | Yes | Organization slug where the status page belongs. |
id |
String! | Yes | ID of the status page to remove. |
Delete a status page update
| 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. |
Update a status page
| 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 |
Update a status page update
| 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 |
Create an Asana task from an incident
| Name | Type | Required | Description |
|---|---|---|---|
incidentNumber |
Int! | Yes | Incident number. |
title |
String! | Yes | Asana task title. |
description |
String! | Yes | Asana task description. |
appId |
String! | Yes |
Create a GitHub issue from an incident
| Name | Type | Required | Description |
|---|---|---|---|
incidentNumber |
Int! | Yes | Incident number. |
title |
String! | Yes | GitHub issue title. |
description |
String! | Yes | GitHub issue description. |
appId |
String! | Yes |
Create a GitLab issue from an incident
| Name | Type | Required | Description |
|---|---|---|---|
incidentNumber |
Int! | Yes | Incident number. |
title |
String! | Yes | GitLab issue title. |
description |
String! | Yes | GitLab issue description. |
appId |
String! | Yes |
Create a Jira issue from an incident
| Name | Type | Required | Description |
|---|---|---|---|
incidentNumber |
Int! | Yes | Incident number. |
title |
String! | Yes | Jira issue title. |
description |
String! | Yes | Jira issue description. |
appId |
String! | Yes |
Create a Linear issue from an incident
| Name | Type | Required | Description |
|---|---|---|---|
incidentNumber |
Int! | Yes | Incident number. |
title |
String! | Yes | Linear issue title. |
description |
String! | Yes | Linear issue description. |
appId |
String! | Yes |
Create a Shortcut story from an incident
| Name | Type | Required | Description |
|---|---|---|---|
incidentNumber |
Int! | Yes | Incident number. |
title |
String! | Yes | Shortcut story title. |
description |
String! | Yes | Shortcut story description. |
appId |
String! | Yes |
Create a Trello card from an incident
| 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 |
Remove a linked integration from an incident
| Name | Type | Required | Description |
|---|---|---|---|
incidentNumber |
Int! | Yes | Incident number |
id |
String! | Yes | Integration id |
appId |
String! | Yes |
Mark a tooltip as seen for the current user
| Name | Type | Required | Description |
|---|---|---|---|
tooltip |
String! | Yes | Name of the tooltip |
Update the current user's preferences
| 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 |
Record that a user has used a feature
| Name | Type | Required | Description |
|---|---|---|---|
feature |
String! | Yes | Feature user has used. |
A link between two actions across apps via distributed tracing
| Field | Type | Description |
|---|---|---|
sourceApp |
App! | Source app of the link |
targetApp |
App! | Target app of the link |
sourceAction |
ActionLinkAction! | Source action of the link |
targetAction |
ActionLinkAction! | Target action of the link |
An action endpoint in a distributed trace link
| Field | Type | Description |
|---|---|---|
id |
String! | Action identifier |
name |
String! | Action name |
namespace |
String! | Action namespace |
A list of fields to return. Example: "fields": [ {"field": COUNT, "aggregate": SUM}, {"field": P90, "aggregate", AVG} ]
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 |
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 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 |
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 |
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 |
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 |
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 |
| 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 |
| Field | Type | Description |
|---|---|---|
title |
String! | Title |
body |
String! | Body |
| 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 |
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. |
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 |
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 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. |
| Field | Type | Description |
|---|---|---|
series |
[Series!]! | List if series used for metrics |
values |
[Values!]! | List of values to plot |
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 |
Kind of check-in update
| Value | Description |
|---|---|
START |
|
FINISH |
Possible states of a check-in
| Value | Description |
|---|---|
NEW |
|
STARTED |
|
FINISHED |
|
MISSED |
|
LATE |
|
UNEXPECTED |
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 |
Kind of check-in trigger
| Value | Description |
|---|---|
CRON |
|
HEARTBEAT |
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 |
Check-in management for an app
| Field | Type | Description |
|---|---|---|
triggers |
[CheckInTrigger!] | List of check-in triggers |
trigger |
CheckInTrigger | Check-in trigger by id |
| Field | Type | Description |
|---|---|---|
line |
String | Code line number |
source |
String | Code source |
Autogenerated return type of CreateCsvExport.
| Field | Type | Description |
|---|---|---|
success |
Boolean! |
Autogenerated return type of CreateCsvExportUrl.
| Field | Type | Description |
|---|---|---|
url |
String | |
filename |
String | |
success |
Boolean! | |
error |
String |
Input for creating a status page
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. |
| Value | Description |
|---|---|
PENDING |
|
PROCESSING |
|
COMPLETED |
|
FAILED |
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 |
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 |
Display style for a dashboard graph
| Value | Description |
|---|---|
LINE |
|
AREA |
|
AREA_RELATIVE |
Input for creating or updating a dashboard graph
Input for a metric within a dashboard graph
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. |
UTC DateTime in ISO8601 format
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 |
| Field | Type | Description |
|---|---|---|
editor |
String | |
localPath |
String | |
urlTemplate |
String |
| Field | Type | Description |
|---|---|---|
class |
String! | Error class |
message |
String | Error message |
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 |
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 |
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 |
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 |
| Value | Description |
|---|---|
MOST_RECENT |
|
RECEIVING_DATA |
|
SPECIFIC_DEPLOY |
|
TIMEFRAME |
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 |
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 |
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 |
Possible states of a log export job
| Value | Description |
|---|---|
REQUESTED |
|
STARTED |
|
COMPLETED |
|
FAILED |
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 |
Possible states of a log export
| Value | Description |
|---|---|
RUNNING |
|
RETRYING |
|
FAILED |
A list of fields to return. Example: "fields": [ {"field": COUNT}, {"field": P90} ]
| 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 |
| Field | Type | Description |
|---|---|---|
title |
String! | Title |
body |
String! | Body |
| 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 |
| 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 |
| Field | Type | Description |
|---|---|---|
title |
String! | Title |
body |
String! | Body |
| 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 |
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 |
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 objects. Can be performance, exception or log incident
Possible types: AnomalyIncident, ExceptionIncident, LogIncident, PerformanceIncident
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. |
| Value | Description |
|---|---|
ALWAYS |
|
NEVER |
|
FIRST_IN_DEPLOY |
|
FIRST_AFTER_CLOSE |
|
NTH_IN_HOUR |
|
NTH_IN_DAY |
| Value | Description |
|---|---|
ID |
|
LAST |
|
TOTAL |
|
IN_SELECTION |
Severity levels for an incident
| Value | Description |
|---|---|
UNTRIAGED |
|
CRITICAL |
|
HIGH |
|
LOW |
|
NONE |
|
INFORMATIONAL |
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 |
Possible states of an incident
| Value | Description |
|---|---|
OPEN |
Incident is active |
CLOSED |
Incident is resolved |
WIP |
Incident is being investigated |
Integration objects such as GitHub, GitLab, Trello etc.
Possible types: Asana, GitHub, GitLab, Jira, Linear, Shortcut, Trello
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. |
Represents untyped JSON
| 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 |
| Field | Type | Description |
|---|---|---|
title |
String! | Title |
body |
String! | Body |
| 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 |
Holds a key and a float value, used for metrics
| Field | Type | Description |
|---|---|---|
key |
String! | Key of keyvalue |
value |
Float | Float value of keyvalue |
Holds a key and a value, used for metrics
| Field | Type | Description |
|---|---|---|
key |
String! | Key of key value |
value |
String | Value of key value |
Key value hash GraphQL datastructure. Hash<String, String>
| 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 |
| Field | Type | Description |
|---|---|---|
title |
String! | Title |
body |
String! | Body |
| 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 |
A link between two apps via distributed tracing
| Field | Type | Description |
|---|---|---|
sourceApp |
App! | Source app of the link |
targetApp |
App! | Target app of the link |
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 |
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 |
A log line action. Can be a trigger, filter, or metrics action.
Possible types: LogLineActionFilter, LogLineActionMetrics, LogLineActionTrigger
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. |
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. |
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. |
| Value | Description |
|---|---|
TRIGGER |
|
FILTER |
|
METRICS |
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. |
| Value | Description |
|---|---|
COUNTER |
|
GAUGE |
|
DISTRIBUTION |
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 |
Logbook item objects.
Possible types: AssigneeChange, IntegrationCreate, ManualAlertStateChange, Note, NotificationFrequencyChange, NotificationThresholdChange, NotifierResult, SeverityChange, StateChange
Types that can have a logbook
| Value | Description |
|---|---|
INCIDENT |
|
HEARTBEAT |
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 |
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. |
Marker objects. Can be Deploy, Notification or Custom
Possible types: CustomMarker, DeployMarker, NotificationMarker
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 |
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 |
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}] }
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 |
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. |
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 } ] }
Type of metric
| Value | Description |
|---|---|
GAUGE |
A point-in-time value |
MEASUREMENT |
A distribution of values |
COUNTER |
An incrementing value |
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 |
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 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 |
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 |
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. |
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 |
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. |
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 |
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. |
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 |
Anomaly incidents with pagination information
| Field | Type | Description |
|---|---|---|
total |
Int | Incident total |
rows |
[AnomalyIncident!]! | Anomaly incidents |
Exception incidents with pagination information
| Field | Type | Description |
|---|---|---|
total |
Int | Incident total |
rows |
[ExceptionIncident!]! | Exception incidents |
Log incidents with pagination information
| Field | Type | Description |
|---|---|---|
total |
Int | Incident total |
rows |
[LogIncident!]! | Log incidents |
Performance incidents with pagination information
| Field | Type | Description |
|---|---|---|
total |
Int | Incident total |
rows |
[PerformanceIncident!]! | Performance incidents |
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 |
An AppSignal incident
| Field | Type | Description |
|---|---|---|
id |
String! | Id of deploy marker |
marker |
DeployMarker! | Deploy marker |
count |
Int! | Incident number |
mean |
Int! | Incident number |
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 |
Group of datapoints in timeseries
| Field | Type | Description |
|---|---|---|
timestamp |
Int! | Timestamp of bucket |
values |
[KeyFloatValue!] | Points returned for bucket |
UTC DateTime in rfc3339 format with a 3-digit precision
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 |
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) |
| Value | Description |
|---|---|
OPEN |
|
IN_PROGRESS |
|
DONE |
|
SKIPPED |
Resolution values to be used with metrics.
| Value | Description |
|---|---|
MINUTELY |
Resolution of: minutely |
HOURLY |
Resolution of: hourly |
DAILY |
Resolution of: daily |
| 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 objects. Can be performance or exception sample
Possible types: ExceptionSample, PerformanceSample
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 |
Types of sample.
| Value | Description |
|---|---|
EXCEPTION |
Exception sample |
PERFORMANCE |
Performance sample |
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 |
| Field | Type | Description |
|---|---|---|
digest |
String! | Digest of metric key. |
name |
String! | Metric name |
tags |
[KeyStringValue]! | Metric tags |
type |
MetricTypeEnum! | Metric type |
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. |
Log severity levels
| Value | Description |
|---|---|
UNKNOWN |
|
TRACE |
|
DEBUG |
|
INFO |
|
NOTICE |
|
WARN |
|
ERROR |
|
CRITICAL |
|
ALERT |
|
FATAL |
| 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 |
| Field | Type | Description |
|---|---|---|
title |
String! | Title |
body |
String! | Body |
| 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 |
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 |
Log source format
| Value | Description |
|---|---|
PLAINTEXT |
|
LOGFMT |
|
JSON |
|
AUTODETECT |
Span data for an app
| Field | Type | Description |
|---|---|---|
metadataDistributions |
[MetadataDistributions]! | Metadata distributions |
metadataDistribution |
[KeyFloatValue]! | Metadata distribution |
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. |
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 |
Status page state
| Value | Description |
|---|---|
UP |
up |
DOWN |
down |
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. |
Input for creating or updating a status page update
Status page update state
| Value | Description |
|---|---|
INVESTIGATING |
investigating |
IDENTIFIED |
identified |
RECOVERING |
recovering |
RESOLVED |
resolved |
A list of tags to narrow/group aggregation, example: "tags": [ {"key": "action", "value": "*"}, {"key": "namespace", "value": "b"} ]
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 |
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. |
Settings for the AlertConfiguration to compare against.
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 |
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 |
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 |
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 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 information
| Field | Type | Description |
|---|---|---|
name |
String! | Timezone friendly name |
identifier |
String! | Timezone abbreviation |
offset |
String! | Timezone UTC offset |
| 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 |
| 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 |
| Field | Type | Description |
|---|---|---|
lists |
[KeyStringValue!]! | Available Trello lists |
title |
String! | Title |
body |
String! | Body |
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 |
Input for updating a status page
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 |
Input for creating or updating an uptime monitor
A region where uptime monitoring is available
| Field | Type | Description |
|---|---|---|
id |
UptimeMonitorRegionEnum! | Uptime Monitor Region id. |
name |
String! | Name of region. |
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 |
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 |
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 |
| Field | Type | Description |
|---|---|---|
values |
[KeyFloatValue!]! | Time of log occurrence |
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 |
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 |
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 object, used in dashboards. Can be timeseries or number.
Possible types: VisualNumber, VisualTimeseries
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 |
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 |
Grid layout positioning for a visual
Input for updating a single visual's layout
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 |
Input for creating or updating a number visual
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 |
Input for a metric within a number visual
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 |
Input for creating or updating a timeseries visual
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 |
A field configuration for a timeseries metric
| Field | Type | Description |
|---|---|---|
field |
MetricFieldEnum | Metric field name |
Input for a field within a timeseries metric
Input for a metric within a timeseries visual