How to Monitor Origin Events¶
This guide explains how to use the Origin Events page to monitor the health of your origin server and troubleshoot errors that occur when Peakhour tries to fetch content from it.
Accessing Origin Events¶
- Navigate to your Domain Dashboard.
- In the main navigation, under Analytics & Logs > Events, click on Origin Errors.
Understanding the Interface¶
The Origin Events page is designed to give you a clear view of your origin server's health and performance.
- Date Picker: A calendar on the left allows you to select a specific day to view events for.
- Summary Graph: A timeline graph showing the volume of origin errors over the selected day. This helps you quickly identify spikes in error activity.
- Events Table: A detailed list of all origin error events that occurred on the selected day.
Analyzing Origin Errors¶
Using the Summary Graph¶
The graph displays the number of origin errors per time interval. - Identify Spikes: Look for sudden increases in errors, which could indicate an origin server outage or a deployment issue. - Select a Time Window: Clicking on a specific point or bar in the graph will filter the Events Table to show errors from that specific time, allowing you to correlate errors with specific events.
Using the Events Table¶
The table provides detailed information for each error event. Key columns include:
- When: The exact timestamp of the error.
- Error code: The specific Peakhour error code (e.g.,
RCTX_ERROR_DOWNSTREAM_TIMEOUT
), which tells you the nature of the connection problem. - HTTP status code: The HTTP status code returned by your origin server (e.g.,
500
,503
), if a connection was successful. - Path: The URL path that was being requested when the error occurred.
This information helps you pinpoint exactly what went wrong and where. For example, a high number of 500
errors on a specific path might indicate a bug in that part of your application. A spike in RCTX_ERROR_DOWNSTREAM_CONNREFUSED
errors suggests your origin server may have been down or unreachable.
Downloading Event Data¶
For offline analysis or reporting, you can download the event data for the selected day.
- Click the Download icon button above the table.
- This will download a .jsonl
file containing the raw data for all events in the current view.
By regularly monitoring your Origin Events, you can proactively identify and resolve issues with your backend infrastructure, ensuring a stable and reliable experience for your users.