Alerts are part of Tenderly Monitor, available on the paid plan. To enable it for your account, contact our sales team.
- Quickstart guide
- How to set up webhooks for alerting
- Using Alerting API.
- Alert triggers and targets
- Alert destinations
Anatomy of an Alert
Each Alert requires three elements to be configured before it can be enabled:- Alert Type: On-chain event that triggers Tenderly to send you a notification. There are 12 alert trigger types to choose from.
- Alert Target: Addresses you want Tenderly to monitor, as well as other settings such as the network, project, and tags.
- Alert Destination: Service for receiving notifications about a specific event. One Alert can send notifications to multiple destinations. There are 8 destination types where you can send and receive notifications.
Alert trigger types overview
Below is a list of all 12 alert trigger types and a brief description of each. Click the link to explore configuration details.| Trigger Type | Description | Common Use Case |
|---|---|---|
| Successful Transaction | Fires when a transaction is successfully mined. | Monitor contract calls or wallet activity. |
| Failed Transaction | Fires when a transaction fails to be mined. | Early detection of usage or code issues. |
| Function Call | Fires when a specific external or public function is called on a contract. | Track specific contract interactions. |
| Event Emitted | Fires when a specific event is emitted from a contract. | Monitor ERC-20 approvals, transfers, etc. |
| Event Parameter | Fires when an event argument matches a condition you define. | Alert when a transfer amount exceeds a threshold. |
| ERC20 Token Transfer | Fires when an ERC-20 Transfer event is emitted. | Track token movements to/from an address. |
| Allowlisted Callers | Fires when an address NOT on your allowlist calls a contract. | Detect unauthorized callers. |
| Blocklisted Callers | Fires when an address on your blocklist calls a contract. | Monitor known bad actors or unauthorized wallets. |
| Balance Change | Fires when a native token balance matches a condition after a transaction. | Know when to top up a keeper or bot wallet. |
| Transaction Value | Fires when the value of a transaction matches a condition in wei. | Track high-value transactions. |
| State Change | Fires when a numeric state variable in a contract changes. | Monitor multisig confirmation count or config variables. |
| View Function | Fires when the return value of a view function changes after a transaction. | Track ERC-20 balances via balanceOf. |
Alert Destinations overview
All these alert triggers can be configured to send real-time notifications to a place where it’s convenient for your team. Receive notifications in your favorite messaging app: Send alert data to other Tenderly systems: Send alert data to third-party incident and error monitoring platforms like: Learn how to set up each Alert Destination here.What can you do with Tenderly Alerting?
Tenderly Alerting offers value in a variety of circumstances. Whenever you require a dependable alerting system for on-chain activities that can notify you of potential risks or threats, you can rely on Tenderly Alerting.- Monitor on-chain activity: Alerts can be used as a monitoring tool to track user activity on smart contracts, such as failed or successful transactions or state changes. This is useful in scenarios when you need to keep track of specific events or changes in the blockchain environment.
- Detect suspicious behavior: Alerts can inform you about suspicious behavior on your smart contracts or wallets, such as security breaches or fraudulent activity. This helps you to take appropriate action to protect your assets and prevent losses.
- Respond faster in emergency situations: Alerts also help you detect errors, security issues, or failed transactions. This is useful in situations when you need to take action to resolve a problem immediately after it happens.
- Ensure greater visibility for your team: You can configure each Alert to your specifications, including setting the location for notifications convenient for your team.
- Enable automated processes: Use Alerts as triggers for Web3 Actions to build custom automated processes that allow you to react automatically to on-chain events with custom code.