Alerting status updates in Telegram

​

Overview of steps

1. Set Bot with BotFather for Telegram
2. Get the chat_id of your Telegram Group
3. Update Mage project settings

​

Configure alerts in the Mage Pro UI

1. For project defaults, go to Settings > Account > Alerts.
2. For one pipeline, open the pipeline and go to Alerts. Pipeline-level settings override the project-level alert config for that pipeline.
3. Choose the alert outcomes, enable Telegram, enter the webhook URL, and use Send test notification to send a test alert before saving.

​

Set Bot with BotFather for Telegram

​

Get the chat_id of your Telegram Group

1. Open https://web.telegram.org/ and Follow the instructions
2. Click your Telegram Group and your Group chat_id is on your url like https://web.telegram.org/a/#-7222xxxxxx

​

Update Mage project settings

https://api.telegram.org/bot{your_token:from_botfather}/sendMessage?chat_id=-7222xxxxxx

1. Open the Mage tool in your browser (e.g. http://localhost:6789/).
2. Open a pipeline and start editing it (e.g. http://localhost:6789/pipelines/example_pipeline/edit).
3. In your left sidebar in the file browser, scroll all the way down and click on a file named metadata.yaml.
4. In the metadata.yaml file, add a section with the following configuration or update the existing notification_config section:
   notification_config:
     alert_on:
       - trigger_failure
       - trigger_passed_sla
   
   If you omit the alert_on section it will default to trigger_failure and trigger_passed_sla. Options:
   • trigger_failure: alert when a run of a trigger fails
   • trigger_success: alert when a run of a trigger succeeds
   • trigger_passed_sla: alert when a SLA is missed.
     • In this context, SLA (Service Level Agreement) is an expected amount of time for the pipeline to complete.
     • If the pipeline runs longer than the SLA, an alert will be sent.
5. In the metadata.yaml file, add the following values:
   notification_config:
     alert_on:
       ...
     telegram_config:
       webhook_url: ...
   
   Change the webhook_url value to be the webhook URL like mentioned above.

​

Customize message templates

notification_config:
  alert_on:
    ...
  telegram_config:
    ...
  message_templates:
    failure:
      title: 'Failed to execute pipeline {pipeline_uuid} at {execution_time}'
      summary: >
        Failed to execute pipeline {pipeline_run_url}.
        Pipeline uuid: {pipeline_uuid}. Trigger name: {pipeline_schedule_name}.
        Test custom message.
    success:
      title: ...
      summary: ...
    passed_sla:
      title: ...
      summary: ...

1. execution_time
2. pipeline_run_url
3. pipeline_schedule_id
4. pipeline_schedule_name
5. pipeline_schedule_description
6. pipeline_uuid
7. error
   • available only for the failure message template
8. stacktrace
   • available only for the failure message template

Note: For pipeline_run_url, the default host is http://localhost:6789. You can specify MAGE_PUBLIC_HOST to be the host url you want to use in the notification messages.

​

🚀 Pro Only: Interpolate Mage Variables in Message Templates

notification_config:
  message_templates:
    failure:
      title: 'Failed to execute pipeline {pipeline_uuid} at {{ env_var('ENVIRONMENT') }} environment'
      summary: >
        Failed to execute pipeline {pipeline_run_url}.
        Pipeline uuid: {pipeline_uuid}. Trigger name: {pipeline_schedule_name}.
        Test custom message.

1. start_time
2. end_time
3. duration (in seconds)
4. env (this gets the value stored in the ENV environment variable)

​

What next?