docs/user_docs/source/web.rst

@@ -20,7 +20,8 @@ Latest events and superevents
 =============================
 
 The "LATEST" page shows the most recent events or superevents (by submission time).
-You can also do searches from this page.
+Users can also do searches from this page, however only a limited number (currently 25) of the most
+recent events will be displayed. 
 
 Understanding the event detail page
 ===================================
@@ -44,26 +45,12 @@ The existing tags are also shown in the same column as the message itself, as is
 Users are free to create new tags for their own purposes (e.g., searching through annotations at some
 later date), but only a pre-determined list of tags is used to create title pane sections.
 
-For more on the GraceDB event page, see `this <https://www.youtube.com/watch?v=oIJE4dTISs4>`_ helpful video by Roy Williams, which is geared toward LV-EM users.
-There also is a `companion video <https://www.youtube.com/watch?v=ydXUD9KIN98>`__ on the SkymapViewer.
+.. For more on the GraceDB event page, see `this <https://www.youtube.com/watch?v=oIJE4dTISs4>`_ helpful video by Roy Williams, which is geared toward LV-EM users.
+.. There also is a `companion video <https://www.youtube.com/watch?v=ydXUD9KIN98>`__ on the SkymapViewer.
 
 Understanding the superevent detail page
 ========================================
 
 The detail page for a superevent can be accessed similarly to an event page.
 The content is analogous to that shown on the event page, although it contains information about the superevent in general, as well as a table summarizing the information about the superevent's preferred event.
-
-Signing up for email or phone alerts (LVC only)
-=======================================================
-
-LVC users may set up email or phone notifications for events that come from specific pipelines and have specific labels.
-This feature is available to LVC users only because the events are not vetted before the alert is sent out.
-For non-LVC users, GCN will provide the equivalent functionality.
-See the LV-EM `techinfo page <https://gw-astronomy.org/wiki/LV_EM/TechInfo>`__.) 
-
-In order to sign up for an alert, you must first create a contact by clicking on "OPTIONS" in the navigation menu, and then "Create New Contact."
-Follow the instructions on that page to add your contact information.
-Next, return to the options page and click "Create New Notification".
-This page allows you to set the criteria for alerts to be sent to the contact that you created in the previous step.
-
-These are currently only available for events, but may be extended to superevents in the future.
+Additional tables show preferred events by pipeline and a summary of the superevent's constituent event uploads. 

gracedb/alerts/constants.py

+from pyparsing import oneOf, Literal
+
+
+# List of characters which are equivalent to the corresponding
+# logical operator
+AND = ['&', ',']
+OR = ['|']
+NOT = ['~', '-']
+
+
+# Pyparsing parsers
+OPERATORS = {
+    'NOT': oneOf(NOT),
+    'AND': oneOf(AND),
+    'OR': Literal(OR),
+}

gracedb/alerts/egad.py

+"""
+Interface to the External GraceDB Alert Dispatcher (EGAD).
+"""
+import logging
+import time
+
+import requests
+
+from django.conf import settings
+
+
+# Set up logger
+logger = logging.getLogger(__name__)
+
+# Set up unchanging request details
+url = f"{settings.EGAD_URL}/{settings.TIER}"
+headers = {
+    "X-Api-Key": settings.EGAD_API_KEY,
+}
+
+
+def send_alert(alert_type, payload):
+    logger.debug(f"Sending {alert_type} alert through EGAD at {url}")
+    time_start = time.perf_counter()
+    r = requests.post(f"{url}/{alert_type}", json=payload, headers=headers)
+    time_elapsed = time.perf_counter() - time_start
+
+    if r.status_code == requests.codes.ok:
+        logger.debug(f"Sent {alert_type} alert through EGAD in {time_elapsed} sec")
+    else:
+        logger.warning(f"Failed to send {alert_type} alert through EGAD: {r}")