SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsnebula-logger-console

nebula-logger-console

Deployment & operations

View repository

Updated 10-16 09:11

About this skill

Using the Nebula Logger Console

What the Console Is

The Logger Console is a Salesforce Lightning App shipped with Nebula Logger. It gives admins, support engineers, and developers a purpose-built place to browse logs without hand-writing SOQL against the log-management custom objects (Log__c, LogEntry__c, LogEntryTag__c, LoggerScenario__c, LoggerTag__c) every time something happens in production.

  • App API name: LoggerConsole.
  • Navigation entries include Log__c, LogEntry__c, LoggerScenario__c, LoggerTag__c, and LogEntryTag__c.
  • A utility bar (LoggerConsoleUtilityBar FlexiPage) surfaces a Logger Settings panel for editing the effective hierarchy record without leaving the console.

Standard List Views

Nebula Logger ships a broad set of list views across all five log-management custom objects so most day-one investigations don't require a custom view:

  • Log__c: AllLogs, AllOpenLogs, AllClosedLogs, AllResolvedLogs, AllLogsWithERROREntries, AllLogsWithERRORorWARNEntries, AllAsynchronousLogs, AllBatchLogs, AllChildLogs, AllImpersonatedLogs, AllRESTLogs, LogsToPurgeSoon, MyAssignedLogs, MyAssignedOpenLogs, MyGeneratedLogs.
  • LogEntry__c: All, AllERRORLogEntries, AllERRORandWARNLogEntries, AllApexLogEntries, AllComponentLogEntries, AllFlowLogEntries, AllHttpRequestLogEntries, AllHttpResponseLogEntries, AllRestRequestLogEntries, AllRestResponseLogEntries, AllExceptionLogEntries, AllImpersonatedLogEntries, AllOmniStudioLogEntries, MyGeneratedLogEntries.
  • LogEntryTag__c: All, AllImpersonatedLogEntryTags.
  • LoggerScenario__c: All, MyAssignedLoggerScenarios.
  • LoggerTag__c: All.

When investigating an incident, start with the pre-built views and narrow with column filters before creating a new custom list view.

Record Pages

Nebula Logger ships a dedicated FlexiPage for each user-facing log-management object. The LogEntryTag__c junction is browsed through its record page but doesn't have its own FlexiPage in the log-management folder - it's rendered with the standard record page layout.

Log Record Page

The Log__c record page (LogRecordPage FlexiPage) surfaces:

  • Standard Log__c fields (transaction ID, save method, user, scenario, tags, totals).
  • The related LogEntry__c list, chronological within the log.
  • Roll-up counts (TotalERRORLogEntries__c, TotalWARNLogEntries__c, etc.) to spot severity at a glance.
  • Related child logs when a parent log transaction ID has been set (see the parent/child log association pattern documented in the Apex logging skill).

Log Entry Record Page

The LogEntry__c record page (LogEntryRecordPage FlexiPage) shows:

  • Message, logging level, origin type / API name, and timestamp.
  • Related record ID and record JSON snapshot when the entry was created with .setRecord(...).
  • Stack trace and exception fields when the entry came from an exception.
  • Tags applied to the entry (via the LogEntryTag__c junction).

Log Entry Tag Record Page

The LogEntryTag__c record page (LogEntryTagRecordPage FlexiPage) surfaces one row of the tag junction: the LogEntry__c it applies to and the LoggerTag__c being applied. Rarely opened directly - most tag investigation goes through the related lists on LogEntry__c or LoggerTag__c - but useful when auditing an impersonated user's tagging activity via AllImpersonatedLogEntryTags.

Logger Scenario Record Page

The LoggerScenario__c record page (LoggerScenarioRecordPage FlexiPage) shows the scenario's persisted state after any transaction called Logger.setScenario(...), along with related Log__c records that used it. Use this to answer "which transactions ran under scenario X, and who was assigned to follow up."

Logger Tag Record Page

The LoggerTag__c record page (LoggerTagRecordPage FlexiPage) shows the tag catalog entry and its related LogEntryTag__c junctions, i.e. every log entry currently carrying this tag. Use this when auditing tag taxonomy usage or spotting typos / duplicates in the tag catalog.

Home Page and Live Streaming

The console's home page (LoggerHomePage FlexiPage) is where the console's most operational tools live:

  • logEntryEventStream - subscribes to the LogEntryEvent__e platform event and shows log entries in real time as they are published. This is the fastest way to confirm logging is firing during a test scenario without waiting for the async save path to persist records.
  • logBatchPurge - triggers the log purge batch on demand and reports counts.
  • loggerSettings - the same settings editor exposed in the utility bar, on a full-page canvas.
  • loggerHomeHeader - navigation header with quick links to release notes, GitHub, and the docs.
  • Embedded reports and dashboards showing recent activity across Log__c, LogEntry__c, LogEntryTag__c, LoggerScenario__c, and LoggerTag__c.

Together these give an admin one page to answer "is logging healthy right now, and what does it look like?".

Typical Workflows

Investigating a specific error

  1. Open the AllERRORLogEntries list view.
  2. Filter to the time window of interest.
  3. Open a LogEntry__c record - the linked Log__c shows the full transaction; the related list on the Log__c shows every entry in that transaction, in order.
  4. If the transaction is part of an async chain, follow ParentLog__c upward to the parent transaction.

Investigating a user's session

  1. Open the AllLogs list view.
  2. Filter by LoggedBy__c and time window.
  3. Sort by StartTime__c to see the user's transactions in order.

Confirming logging is firing during a repro

  1. Open the Logger Console home page (LoggerHomePage).
  2. Locate the Log Entry Event Stream component.
  3. Reproduce the scenario in another tab.
  4. Watch entries appear as LogEntryEvent__e platform events publish. When entries stop appearing, the async save has completed and the persisted records across Log__c, LogEntry__c, LogEntryTag__c, LoggerScenario__c, and LoggerTag__c are queryable.

Related Skills