Gateway and Schedule Monitoring

Scheduling automated dataset updates is the best way to save time and effort while keeping your data up-to-date and accurate. Our Notifications & Alerts feature now enables you to monitor any scheduled updates configured with Socrata Gateway or Schedule from URL, as well as monitoring Socrata Gateway agent activity. These notification options are customizable so that you can decide which event types to be notified of, as well as where to receive the notifications themselves (via email, in the Socrata platform, or both).

The new notification options are:

  • Scheduled automation fails

  • Scheduled automation succeeds

  • Gateway agent goes offline

  • Gateway agent comes online

Some details to know:

  • Most scheduled automation failures can be attributed to a handful of common causes. We have identified many of these so that in the majority of cases you will see a descriptive error message along with your notification. If you receive a schedule failure notification without a descriptive error message, please contact Socrata Support at socrata-support@tylertech.com to learn more.

  • The Socrata Gateway service periodically pushes updates which require Gateway agents to briefly go offline (typically for less than two minutes). To eliminate any noise related to this quick and normal online/offline activity, we queue “Agent gone offline” notifications for two minutes before sending them to you. If the agent comes back online in two minutes or less, we cancel the notification.

Here’s how to configure your notifications:

  1. When logged in to your Socrata domain, click the bell icon at the top right to open the Notifications & Alerts feature.

  2. Click the “Settings” button at the bottom to open your options (users with the Administrator role may see additional options on this screen):

    2689d729-8dbc-4e35-bc57-e43b7afe1ee7.png

     

  3. Select the type of notifications you would like to receive. If you are enabling notifications for schedule failures, you will see an additional required field labeled “Only notify me when there are at least this many consecutive failures.” Schedule failures are often due to transient issues that go away on their own, with the first or second automatic retry succeeding normally. This field enables you to set a threshold for your alerts so that you only hear about schedules which have failed persistently. The value in this field will default to 5; we recommend setting this value no lower than 3 to avoid excess noise.

    1acfb7da-b91a-4124-9c83-55a6033fe6d2.png
  4. IMPORTANT: In order to receive timely notifications of these and other events, review the “Frequency” configuration and make sure you have unchecked the option to “Send notifications as a digest rather than individual emails.” If this option is selected, you will not receive notifications in real time.

  5. Any roled user can choose to subscribe to domain-wide notifications under the “All Assets” header. Please note that a permissions check is performed on individual notifications themselves prior to sending, so that notifications will be sent according to a user’s permissions on that given schedule or agent.

  6. When you have completed your selections, click “Save” and close the modal.

Any email notifications you have enabled will be sent to the email address associated with your user account. An email notification will look like this:

0bd1c755-ed61-4fe0-a31d-2ee376a7cdb1.png

In-app notifications will be indicated by a badge on the Notifications & Alerts bell icon. In-app notifications will look like this:

a7fca5f2-5fab-4377-8f77-656281615232.png

If you have any questions, please reach out to our Support Team at socrata-support@tylertech.com.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.