James Ritchie
fade22015f
* Adds new features table to top of v4 upgrade guide * Adds wait idempotency to wait-until, wait-for, and wait-for-token pages * Adds new priority docs page and updates the v4 upgrade guide * Adds new task lifecycle hooks * Removes the message about requiring tasks to be exported * Adds new global lifecycle hooks section * Moves sections from upgrade guide into the table * Adds hidden task page * Improves the global lifecycle hooks section * Updates middleware and locals section * Adds new useWaitToken page to the react hooks section * Adds a new ai.tool section * Moves Docker (legacy) page into self-hosting section * Removes known issues from v4 upgrade guide * Replace “toolTask” with “ai.tool” in the Streams page example * Renames guide to “Migrating from v3” and adds redirect * Remove references to v4 * Removes changelog from migration guide * The installation guide now references `@latest update` * Changes all references from `/sdk/v3` to `/sdk` * Updates @v4-beta to @latest * Fixed broken link * Fixes broken link * Adds an upgrade to v4 using AI section * Fixes 2 broken links * Adds an entry for targetting preview branches * Updates the run statuses * Adds boolean helpers section to the runs and realtime pages * Updates the concurrency page * Updates the test page to include the new options * Adds SDK and curl options for the preview branch targeting * Updates new bulk actions page * Remove the releasing concurrency section * Got rid of some more @v4-beta mentions * Improved rate limit docs * Improved migrating docs * Removed commented sections of the docs * useWaitToken hook * Fixed the description * Fix for missing test image --------- Co-authored-by: Matt Aitken <matt@mattaitken.com> Co-authored-by: Dan <8297864+D-K-P@users.noreply.github.com>
386 lines
9.9 KiB
Plaintext
386 lines
9.9 KiB
Plaintext
---
|
|
title: "Alerts"
|
|
description: "Get alerted when runs or deployments fail, or when deployments succeed."
|
|
---
|
|
|
|
We support receiving alerts for the following events:
|
|
- Run fails
|
|
- Deployment fails
|
|
- Deployment succeeds
|
|
|
|
## How to setup alerts
|
|
|
|
<Steps>
|
|
|
|
<Step title="Create a new alert">
|
|
Click on "Alerts" in the left hand side menu, then click on "New alert" to open the new alert modal.
|
|
|
|
</Step>
|
|
|
|
<Step title="Choose your alert method">
|
|
Choose to be notified by email, Slack notification or webhook whenever:
|
|
|
|
- a run fails
|
|
- a deployment fails
|
|
- a deployment succeeds
|
|
|
|
|
|
</Step>
|
|
|
|
<Step title="Delete or disable alerts">
|
|
Click on the triple dot menu on the right side of the table row and select "Disable" or "Delete".
|
|
|
|
|
|
</Step>
|
|
|
|
</Steps>
|
|
|
|
|
|
## Alert webhooks
|
|
|
|
For the alert webhooks you can use the SDK to parse them. Here is an example of how to parse the webhook payload in Remix:
|
|
|
|
```ts
|
|
import { ActionFunctionArgs, json } from "@remix-run/server-runtime";
|
|
import { webhooks, WebhookError } from "@trigger.dev/sdk";
|
|
|
|
export async function action({ request }: ActionFunctionArgs) {
|
|
// Make sure this is a POST request
|
|
if (request.method !== "POST") {
|
|
return json({ error: "Method not allowed" }, { status: 405 });
|
|
}
|
|
|
|
try {
|
|
// Construct and verify the webhook event
|
|
// This secret can be found on your Alerts page when you create a webhook alert
|
|
const event = await webhooks.constructEvent(request, process.env.ALERT_WEBHOOK_SECRET!);
|
|
|
|
// Process the event based on its type
|
|
switch (event.type) {
|
|
case "alert.run.failed": {
|
|
console.log("[Webhook Internal Test] Run failed alert webhook received", { event });
|
|
break;
|
|
}
|
|
case "alert.deployment.success": {
|
|
console.log("[Webhook Internal Test] Deployment success alert webhook received", { event });
|
|
break;
|
|
}
|
|
case "alert.deployment.failed": {
|
|
console.log("[Webhook Internal Test] Deployment failed alert webhook received", { event });
|
|
break;
|
|
}
|
|
default: {
|
|
console.log("[Webhook Internal Test] Unhandled webhook type", { event });
|
|
}
|
|
}
|
|
|
|
// Return a success response
|
|
return json({ received: true }, { status: 200 });
|
|
} catch (err) {
|
|
// Handle webhook errors
|
|
if (err instanceof WebhookError) {
|
|
console.error("Webhook error:", { message: err.message });
|
|
return json({ error: err.message }, { status: 400 });
|
|
}
|
|
|
|
if (err instanceof Error) {
|
|
console.error("Error processing webhook:", { message: err.message });
|
|
return json({ error: err.message }, { status: 400 });
|
|
}
|
|
|
|
// Handle other errors
|
|
console.error("Error processing webhook:", { err });
|
|
return json({ error: "Internal server error" }, { status: 500 });
|
|
}
|
|
}
|
|
```
|
|
|
|
### Common properties
|
|
|
|
When you create a webhook alert, you'll receive different payloads depending on the type of alert. All webhooks share some common properties:
|
|
|
|
<ParamField path="id" type="string">
|
|
A unique identifier for this webhook event
|
|
</ParamField>
|
|
|
|
<ParamField path="created" type="datetime">
|
|
When this webhook event was created
|
|
</ParamField>
|
|
|
|
<ParamField path="webhookVersion" type="string">
|
|
The version of the webhook payload format
|
|
</ParamField>
|
|
|
|
<ParamField path="type" type="string">
|
|
The type of alert webhook. One of: `alert.run.failed`, `alert.deployment.success`, or `alert.deployment.failed`
|
|
</ParamField>
|
|
|
|
### Run Failed Alert
|
|
|
|
This webhook is sent when a run fails. The payload is available on the `object` property:
|
|
|
|
<ParamField path="object.task.id" type="string">
|
|
Unique identifier for the task
|
|
</ParamField>
|
|
|
|
<ParamField path="object.task.filePath" type="string">
|
|
File path where the task is defined
|
|
</ParamField>
|
|
|
|
<ParamField path="object.task.exportName" type="string">
|
|
Name of the exported task function
|
|
</ParamField>
|
|
|
|
<ParamField path="object.task.version" type="string">
|
|
Version of the task
|
|
</ParamField>
|
|
|
|
<ParamField path="object.task.sdkVersion" type="string">
|
|
Version of the SDK used
|
|
</ParamField>
|
|
|
|
<ParamField path="object.task.cliVersion" type="string">
|
|
Version of the CLI used
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.id" type="string">
|
|
Unique identifier for the run
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.number" type="number">
|
|
Run number
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.status" type="string">
|
|
Current status of the run
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.createdAt" type="datetime">
|
|
When the run was created
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.startedAt" type="datetime">
|
|
When the run started executing
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.completedAt" type="datetime">
|
|
When the run finished executing
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.isTest" type="boolean">
|
|
Whether this is a test run
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.idempotencyKey" type="string">
|
|
Idempotency key for the run
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.tags" type="string[]">
|
|
Associated tags
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.error" type="object">
|
|
Error information
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.isOutOfMemoryError" type="boolean">
|
|
Whether the run was an out-of-memory error
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.machine" type="string">
|
|
Machine preset used for the run
|
|
</ParamField>
|
|
|
|
<ParamField path="object.run.dashboardUrl" type="string">
|
|
URL to view the run in the dashboard
|
|
</ParamField>
|
|
|
|
<ParamField path="object.environment.id" type="string">
|
|
Environment ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.environment.type" type="string">
|
|
Environment type (STAGING or PRODUCTION)
|
|
</ParamField>
|
|
|
|
<ParamField path="object.environment.slug" type="string">
|
|
Environment slug
|
|
</ParamField>
|
|
|
|
<ParamField path="object.organization.id" type="string">
|
|
Organization ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.organization.slug" type="string">
|
|
Organization slug
|
|
</ParamField>
|
|
|
|
<ParamField path="object.organization.name" type="string">
|
|
Organization name
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.id" type="string">
|
|
Project ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.ref" type="string">
|
|
Project reference
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.slug" type="string">
|
|
Project slug
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.name" type="string">
|
|
Project name
|
|
</ParamField>
|
|
|
|
### Deployment Success Alert
|
|
|
|
This webhook is sent when a deployment succeeds. The payload is available on the `object` property:
|
|
|
|
<ParamField path="object.deployment.id" type="string">
|
|
Deployment ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.deployment.status" type="string">
|
|
Deployment status
|
|
</ParamField>
|
|
|
|
<ParamField path="object.deployment.version" type="string">
|
|
Deployment version
|
|
</ParamField>
|
|
|
|
<ParamField path="object.deployment.shortCode" type="string">
|
|
Short code identifier
|
|
</ParamField>
|
|
|
|
<ParamField path="object.deployment.deployedAt" type="datetime">
|
|
When the deployment completed
|
|
</ParamField>
|
|
|
|
<ParamField path="object.tasks" type="array">
|
|
Array of deployed tasks with properties: id, filePath, exportName, and triggerSource
|
|
</ParamField>
|
|
|
|
<ParamField path="object.environment.id" type="string">
|
|
Environment ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.environment.type" type="string">
|
|
Environment type (STAGING or PRODUCTION)
|
|
</ParamField>
|
|
|
|
<ParamField path="object.environment.slug" type="string">
|
|
Environment slug
|
|
</ParamField>
|
|
|
|
<ParamField path="object.organization.id" type="string">
|
|
Organization ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.organization.slug" type="string">
|
|
Organization slug
|
|
</ParamField>
|
|
|
|
<ParamField path="object.organization.name" type="string">
|
|
Organization name
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.id" type="string">
|
|
Project ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.ref" type="string">
|
|
Project reference
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.slug" type="string">
|
|
Project slug
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.name" type="string">
|
|
Project name
|
|
</ParamField>
|
|
|
|
### Deployment Failed Alert
|
|
|
|
This webhook is sent when a deployment fails. The payload is available on the `object` property:
|
|
|
|
<ParamField path="object.deployment.id" type="string">
|
|
Deployment ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.deployment.status" type="string">
|
|
Deployment status
|
|
</ParamField>
|
|
|
|
<ParamField path="object.deployment.version" type="string">
|
|
Deployment version
|
|
</ParamField>
|
|
|
|
<ParamField path="object.deployment.shortCode" type="string">
|
|
Short code identifier
|
|
</ParamField>
|
|
|
|
<ParamField path="object.deployment.failedAt" type="datetime">
|
|
When the deployment failed
|
|
</ParamField>
|
|
|
|
<ParamField path="object.error.name" type="string">
|
|
Error name
|
|
</ParamField>
|
|
|
|
<ParamField path="object.error.message" type="string">
|
|
Error message
|
|
</ParamField>
|
|
|
|
<ParamField path="object.error.stack" type="string">
|
|
Error stack trace (optional)
|
|
</ParamField>
|
|
|
|
<ParamField path="object.error.stderr" type="string">
|
|
Standard error output (optional)
|
|
</ParamField>
|
|
|
|
<ParamField path="object.environment.id" type="string">
|
|
Environment ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.environment.type" type="string">
|
|
Environment type (STAGING or PRODUCTION)
|
|
</ParamField>
|
|
|
|
<ParamField path="object.environment.slug" type="string">
|
|
Environment slug
|
|
</ParamField>
|
|
|
|
<ParamField path="object.organization.id" type="string">
|
|
Organization ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.organization.slug" type="string">
|
|
Organization slug
|
|
</ParamField>
|
|
|
|
<ParamField path="object.organization.name" type="string">
|
|
Organization name
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.id" type="string">
|
|
Project ID
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.ref" type="string">
|
|
Project reference
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.slug" type="string">
|
|
Project slug
|
|
</ParamField>
|
|
|
|
<ParamField path="object.project.name" type="string">
|
|
Project name
|
|
</ParamField>
|
|
|