These docs are for v1.0. Click to read the latest docs for v2.0.

Generate an Alert

Whether you're a developer or a fleet operator, you're likely to run into unexpected problems. Generating an alert captures the time, data, and description of the issue so you and your team can figure out how to fix it.

Choose an alert level

Choosing appropriate alert levels is important to help your team prioritize issues and avoid being overwhelmed with unnecessary notifications. Here are some rules of thumb:

LevelUsage
FATALSomething unrecoverable has happened, requiring immediate attention of the team.
ERRORSomething unrecoverable has happened, but does not require escalation to the full team.
WARNInformation that the user may find alarming, and may affect the output of the application.
INFOInteresting information to track, but does not require immediate operator intervention.

Bottom line: Use FATAL and ERROR sparingly to avoid generating unnecessary alerts that are forwarded to email, Slack, and other integrated services.

Report an incident

Let's manually generate an alert for your robot. Navigate to your device and click + Incident in the left sidebar.

For this example, we'll report a BATTERY ISSUE with a title of BATTERY FAILURE. Write a brief description, then choose a severity level of FATAL to indicate that the robot is not functional.

280

Click REPORT. That's it! You've now generated your first alert.

By default, we enable email notifications to the address associated with your account for alerts of level INFO and higher. You'll receive a message in your inbox shortly describing the alert!

In the Integrations section of this guide, we'll walk through how to customize these settings and connect other services.


What’s Next