The Signals report helps you evaluate inbound signals to your xMatters instance and the workflows that processed them. The report displays the timestamp, status codes, authentication details, and payload for all signals handled by HTTP, App, and Email triggers (as well as legacy inbound integrations). Processed signals include outputs from the trigger and a link to the associated workflow so developers can further evaluate each request using Flow Designer's Activity panel.
The Signals report includes the following information:
|Trigger||The name of the trigger that received the signal. Click the link to go directly the canvas in Flow Designer where the trigger is used. Direct canvas access lets you quickly find flows that fail and debug them.|
|Received||When xMatters received the signal.|
|HTTP Status Code||The code indicating whether the signal was accepted or rejected by xMatters.|
|Authenticated User||The user whose credentials were used to authenticate the request.|
|Outputs||A table of name and value pairs that are available for downstream flow steps to use as input values. (Outputs are not applicable for legacy inbound integrations.)|
|Payload||A text file of the trigger payload. The payload window contains a Copy option so you can quickly copy the entire payload to review it, or use it to run tests in a third-party system such as Postman or Insomnia.|
|Related Incident||A link to the incident the signal is related to. Clicking the link takes the you to the Incident Console.|
To more easily view data in the table, do one or more of the following:
- To sort the content of a column in alphabetical or chronological order, click the column header. (Click the header again to reverse the sort order.)
- To change the width of a column, move the pointer over the edge of the column and when the re-size icon appears, click and drag the column to the desired size.
- To rearrange the columns, click and drag a column header to a new location on the table.
- If the list contains more entries or columns than can be displayed on your screen, scroll horizontally or vertically. The system automatically loads more data as scroll down the page.
Search and filter
Use the search bar and filter to easily find the signal you're looking for. To search, enter at least two letters into the search bar. The search looks at the trigger name, workflow name, response, authenticated user, payload, and outputs, and highlights where your search term appears in the returned results.
You can narrow your results further using the HTTP status code filter or date range filter. To filter by HTTP Status code, expand the drop-down and select whether you want to see Successes, Failures, or Non-HTTP requests, click Apply and the report returns all signals that match.
Once you've set the search parameters, the Signals report maintains the initial results without refreshing. To refresh the page, while preserving your search criteria, click the Refresh icon.
Time frame searches
The Signals report can display signals that came into your system within a specific time frame. You can search by a pre-set number (Past 15 Minutes, Past 1 Hour, Past 6 Hours, or Past 12 Hours), or specify a date and time range using the calendar and time pickers, and click Apply. The search results update to match your date range. As you add search and filter criteria, the Signals report automatically updates the results to display only the signals that match.
If a trigger or workflow is deleted and there's a signal associated with it, the signal is grayed out in the report and does not contain any linked information.