# Nebula Logger Console

> Use this skill when the user wants to browse, filter, or investigate Nebula Logger data in the Salesforce UI. Covers the Logger Console app, list views on `Log__c` / `LogEntry__c` / `LogEntryTag__c` / `LoggerScenario__c` / `LoggerTag__c`, related-list navigation, the Log record page and its LWCs, and how admins and support engineers use the console day-to-day.

- Skill: `jongpie/nebula-logger-console` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jongpie/nebula-logger-console`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jongpie/nebula-logger-console/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jongpie (https://skillmd.com/u/jongpie)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jongpie/nebula-logger-console

---


# 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

- [nebula-logger-instrumentation](../nebula-logger-instrumentation/SKILL.md) - Writing the log entries that show up here.
- [nebula-logger-purging-and-retention](../nebula-logger-purging-and-retention/SKILL.md) - How long records stay visible in these views.

