Logo of AppSignal

Menu
Docs navigation

Webhooks

AppSignal can send notifications of new incidents to several services, see our full list on the integrations. We also offer webhooks for these notifications so you handle new incidents in your own system.

To receive a webhook, go to the "Notifications" tab the site's sidebar, click the "Add integration" and fill out the URL where you'd like to receive your webhook data.

Webhook

Table of Contents

There are multiple webhooks available. Which payloads the webhook receives can be configured in the configuration form for the webhook as seen in the screenshot above.

Deploy markers

1
2
3
4
5
6
7
8
9
10
11
12
{
  "marker": {
    "time": "2019-01-10 10:45:41 +0100",
    "marker_id": "5c3714455ac13f7df09437f0",
    "site": "My test app",
    "environment": "development",
    "revision": "abc123",
    "user": "tom",
    "repository": "https://github.com/my_org/my_repo",
    "url": "https://appsignal.com/test/sites/5bd867fa2213937f3666ae7b/dashboard"
  }
}

Fields

Field Type Description
marker Hash<String, Any> The webhook payload concerns a marker incident.

Deploy marker sub-fields

Field Type Description
time String Timestamp at which the deploy marker was created.
marker_id String Internal AppSignal marker id for the deploy marker.
site String App name as seen on AppSignal.com. Using the site field instead of app for legacy reasons.
environment String App environment of the app as seen on AppSignal.com.
revision String The deploy marker revision name.
user String The user that created the marker.
repository String Url to the repository as configured for the app on AppSignal.com.
url String Url to the app on AppSignal.com that triggered the webhook.

Exception incidents

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
{
  "exception": {
    "time": "2019-01-09 09:03:57 UTC",
    "incident_id": "5bdb1fb079681b4c5e19d9f7",
    "number": 3,
    "site": "My test app",
    "environment": "development",
    "app_url": "https://appsignal.com/test/sites/5bd867fa2213937f3666ae7b",
    "url": "https://appsignal.com/test/sites/5bd867fa2213937f3666ae7b/incidents/3?timestamp=2019-01-09T09%3A03%3A57Z",
    "revision": "abc123",
    "user": "tom",
    "namespace": "web",
    "exception": "Appsignal::Demo::TestError",
    "message": "Hello world! This is an error used for demonstration purposes.",
    "app_backtrace": [
      "/Users/tombruijn/.gem/ruby/2.5.3/gems/appsignal-2.8.1/lib/appsignal/demo.rb:49:in `create_example_error_request'",
      "/Users/tombruijn/.gem/ruby/2.5.3/gems/appsignal-2.8.1/lib/appsignal/demo.rb:35:in `transmit'",
      "/Users/tombruijn/.gem/ruby/2.5.3/gems/appsignal-2.8.1/lib/appsignal/cli/demo.rb:53:in `run'",
      "/Users/tombruijn/.gem/ruby/2.5.3/gems/appsignal-2.8.1/lib/appsignal/cli.rb:31:in `run'",
      "/Users/tombruijn/.gem/ruby/2.5.3/gems/appsignal-2.8.1/bin/appsignal:7:in `<top (required)>'",
      "/Users/tombruijn/.gem/ruby/2.5.3/bin/appsignal:23:in `load'",
      "/Users/tombruijn/.gem/ruby/2.5.3/bin/appsignal:23:in `<top (required)>'",
      "/Users/tombruijn/.gem/ruby/2.5.3/bin/bundle:23:in `<main>'"
    ],
    "first_backtrace_line": "/Users/tombruijn/.gem/ruby/2.5.3/gems/appsignal-2.8.1/lib/appsignal/demo.rb:49:in `create_example_error_request'",
    "action": "DemoController#hello",
    "path": "/hello",
    "hostname": "Toms-MacBook-Pro.local",
    "action_label": "request",
    "metadata": {
      "demo_sample": "true",
      "method": "GET",
      "path": "/hello"
    }
  }
}

Fields

Field Type Description
exception Hash<String, Any> The webhook payload concerns a exception incident.

Exception sub-fields

Field Type Description
time String Timestamp at which the exception occurred.
incident_id String Internal AppSignal incident id for the incident.
number Integer Incident id as shown on AppSignal.com.
site String App name as seen on AppSignal.com. Using the site field instead of app for legacy reasons.
environment String App environment of the app as seen on AppSignal.com.
app_url String Url to the app on AppSignal.com that triggered the webhook.
url String Url to the specific sample for the incident on AppSignal.com that triggered this webhook.
revision String The deploy marker revision name.
user String The user that created the marker. The user value can also be null if not set for a deploy marker revision.
namespace String The namespace in which this exception occurred.
exception String The exception type that was recorded by AppSignal.
message String The exception message with more details about the exception.
app_backtrace Array<String> The lines of the backtrace concerning the app from which they originated. This excludes any backtrace lines from libraries that are included in the app.
first_backtrace_line String The first backtrace line from the app_backtrace field.
action String The action in which this exception occurred. Either a controller action, background worker or a manually set action.
path String The request path on which the exception occurred. This is only set for web requests. This is metadata set by the AppSignal integration by default and is also included in the metadata field.
hostname String The hostname of the host that this exception occurred on.
action_label String A human friendly label for the type of action this exception occurred on. Uses request for the web namespace and job for the background namespace. All other namespaces use action.
metadata Hash<String, String> This includes user set metadata (see for Ruby / Elixir).

Metadata fields

You can add your own metadata by tagging samples (for Ruby / Elixir).

Field Type Description
demo_sample String Set by the AppSignal integration for demo samples send using our demo command line tool (Ruby / Elixir). Not set for all other samples.
method String The request method used to perform a request. Only available for (web) requests.
path String The request path on which the exception occurred. This is only set for web requests. Contains the same value as the path field.

Performance incidents

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "performance": {
    "time": "2019-01-10 09:38:08 UTC",
    "incident_id": "5bdb1fb301925b0c4b6c7017",
    "number": 1,
    "site": "My test app",
    "environment": "development",
    "app_url": "https://appsignal.com/test/sites/5bd867fa2213937f3666ae7b",
    "url": "https://appsignal.com/test/sites/5bd867fa2213937f3666ae7b/incidents/1?timestamp=2019-01-10T09%3A38%3A08Z",
    "revision": "abc123",
    "user": "tom",
    "namespace": "web",
    "duration": 2004.904052734375,
    "action": "DemoController#hello",
    "path": "/hello",
    "hostname": "Toms-MacBook-Pro.local",
    "action_label": "request",
    "metadata": {
      "demo_sample": "true",
      "method": "GET",
      "path": "/hello"
    }
  }
}

Fields

Field Type Description
performance Hash<String, Any> The webhook payload concerns a performance incident.

Performance sub-fields

Field Type Description
time String Timestamp at which the performance incident occurred.
incident_id String Internal AppSignal incident id for the incident.
number Integer Incident id as shown on AppSignal.com.
site String App name as seen on AppSignal.com. Using the site field instead of app for legacy reasons.
environment String App environment of the app as seen on AppSignal.com.
app_url String Url to the app on AppSignal.com that triggered the webhook.
url String Url to the specific sample for the incident on AppSignal.com that triggered this webhook.
revision String The deploy marker revision name.
user String The user that created the marker. The user value can also be null if not set for a deploy marker revision.
namespace String The namespace in which this performance incident occurred.
duration Float The time in milliseconds measured which the request/job/action took to complete.
action String The action in which this performance incident occurred. Either a controller action, background worker or a manually set action.
path String The request path on which the performance incident occurred. This is only set for web requests. This is metadata set by the AppSignal integration by default and is also included in the metadata field.
hostname String The hostname of the host that this performance incident occurred on.
action_label String A human friendly label for the type of action this performance incident occurred on. Uses request for the web namespace and job for the background namespace. All other namespaces use action.
metadata Hash<String, String> This includes user set metadata (see for Ruby / Elixir).

Metadata fields

You can add your own metadata by tagging samples (for Ruby / Elixir).

Field Type Description
demo_sample String Set by the AppSignal integration for demo samples send using our demo command line tool (Ruby / Elixir). Not set for all other samples.
method String The request method used to perform a request. Only available for (web) requests.
path String The request path on which the performance incident occurred. This is only set for web requests. Contains the same value as the path field.

We'd like to set cookies, read why.