Ops Center Logging Dashboard - j-fischer/rflib GitHub Wiki

Log Event Dashboard

The rflibLogEventMonitor page is the operator console for reviewing platform events emitted by the RFLIB logging framework. It combines live streaming, access to archived events, and a detailed viewer so that admins can investigate incidents without leaving Ops Center.

To enable the Ops Center application, assign the Ops Center Access permission set to users who should be able to monitor logs.

Connection Modes and Log Sources

• New Messages – Subscribes to /event/rflib_Log_Event__e with the standard replay ID of -1. Use this when you only care about events emitted after you open the dashboard.
• Historic and New Messages – Uses replay ID -2 so the component loads all retained events and keeps streaming in new ones. Pick this mode to view all log messages for the last 72 hours; the event list is cleared when you switch into it so you know everything is part of the replay.
• Not Connected – Unsubscribes from the event channel. The dashboard stays available for review, but you will not receive new log events until you choose another mode.
• Archive – Runs an Apex query against the long-term archive. This mode does not stream events; it populates the list with the archived results that match the optional start/end date filters. Switching to Archive or clicking Query Archive updates the list with the latest records. Note that only log events that were configured to be published to the Archive in the Logger Settings will be displayed in this view.

Performance Note: In large organizations, the "Historic and New Messages" mode can take a considerable amount of time to load all messages from the last 72 hours and might hit governor limits. This mode is best suited for non-production orgs or during development. For production environments, especially with high log volumes, using the Log Archive mode is recommended as it provides better performance and reliability. See the Archive Log Level Logger Setting for more details on how to store logs in the archive.

Archive Utilities

• Start Date / End Date inputs – Available only in Archive mode. Use these to narrow the archive query window before pressing Query Archive.
• Query Archive – Re-runs the archive search. If the configured query limit is reached the component raises a toast so you can refine your filter.
• Archive menu → Clear Archive – Permanently deletes up to the oldest 50,000 archived records via rflib_LogArchiveController.clearArchive. Use cautiously; the modal confirmation explains the impact before the deletion runs. Note that manual deletion is not necessary if you have configured the Log Event Archive Cleanup job in the Management Console, which automatically maintains your archive based on your retention settings.

See the Log Archive for more details.

Log Event List Filters

The search row above the log table lets you zero in on the events that matter before you open the viewer:

• Created by – Filters on the CreatedById stored with the event. Paste the 18-character User Id or a prefix to focus on a specific integration or automation user.
• Request ID – Accepts any portion of the Salesforce request identifier so you can align the event with Apex debug logs or platform trace sessions.
• Context – Matches the custom context string that your logging code supplies (for example, flow API names or integration job labels).
• Level – Narrows the list to a single log level (ERROR, WARN, INFO, etc.). Because the filter is case-sensitive, use the exact value emitted in your log statements.
• Log messages – Searches inside the serialized message payload so you can spot keywords or error codes embedded in the log line.

Type into one or more fields, then press Enter or click Search to apply the filters. Each search resets the paginator to the first page, and you can keep refining until you return an empty set. When you focus a field it expands for easier editing while the others collapse, helping you stay oriented when working through multiple filters.

Live View Controls

• Mode Selector – The button menu labelled with the current mode lets you switch among the connection options described above. A toast confirms the new status after each change.
• Clear Logs – Clears the in-memory event list without changing the active mode. Helpful if you want a clean slate while staying connected.
• Toggle Panel – The utility:toggle_panel_left icon hides the log list so you can dedicate the screen to the details panel. Clicking again restores the split view. The button is disabled until a log entry is selected.
• Field Visibility menu – The gear icon on the right toggles columns inside the detail viewer (date, log level, created by, request ID, context). Choices persist for the browser session thanks to sessionStorage.
• Paginator – Appears below the log list and supports first/previous/next/last navigation through the current result set.

Log Event Viewer Tabs and Actions

Selecting a row opens the rflibLogEventViewer on the right-hand side:

• Download menu – The download button exports the RFLIB log payload. When Apex debug logs are linked to the request ID they appear as additional entries in the menu; otherwise the viewer surfaces a disabled “No Debug Logs Available” option.
• Log Event tab – Shows created date, user context, and the formatted log messages. The field visibility settings mentioned above drive which metadata is shown inline.
• Platform Info tab – Displays key/value diagnostics gathered at emit time (for example, transaction context and org metadata) in a sortable-style table.
• Stacktrace tab – Surfaces the raw stacktrace captured with the event for quick root-cause review.
• Viewer actions – Within the card header you can also close the viewer (returning to the “No Log Event Selected” card) or toggle fullscreen via the same panel toggle button.

With these tools combined, the Log Event Dashboard provides both real-time and historical insight into your Salesforce transactions, allowing operators to pivot quickly between live incidents, archival research, and detailed debugging.