用途
Nebula Logger Console 是 Nebula Logger 随附的 Salesforce Lightning 应用(API 名称:LoggerConsole)。它面向管理员、支持工程师和开发者,提供专门浏览日志的场所,避免针对日志管理自定义对象(Log__c、LogEntry__c、LogEntryTag__c、LoggerScenario__c、LoggerTag__c)反复手写 SOQL。
主要能力
导航与设置
导航条包含 Log__c、LogEntry__c、LoggerScenario__c、LoggerTag__c 和 LogEntryTag__c。实用工具栏(LoggerConsoleUtilityBar FlexiPage)提供 Logger Settings 面板,可在不离开控制台的情况下编辑生效的层级记录。
标准列表视图
Nebula Logger 为全部五个日志管理自定义对象提供大量内置列表视图,多数首日调查无需自定义视图。
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。
调查事件时,建议先使用预建视图,用列筛选缩小范围,再考虑创建自定义列表视图。
记录页
Nebula Logger 为每个面向用户的日志管理对象提供专用 FlexiPage。LogEntryTag__c 连接对象可通过其记录页浏览,但在日志管理目录中没有自己的 FlexiPage,使用标准记录页布局渲染。
- Log 记录页(LogRecordPage FlexiPage):展示标准 Log__c 字段(事务 ID、保存方法、用户、场景、标签、总计)、按日志内时间顺序排列的相关 LogEntry__c 列表、汇总计数(TotalERRORLogEntries__c、TotalWARNLogEntries__c 等)以快速识别严重性,以及设置父日志事务 ID 时的相关子日志。
- Log Entry 记录页(LogEntryRecordPage FlexiPage):展示消息、日志级别、来源类型/API 名称、时间戳;使用 .setRecord(...) 创建时的相关记录 ID 和记录 JSON 快照;来自异常的堆栈跟踪和异常字段;通过 LogEntryTag__c 连接应用到该条目的标签。
- Log Entry Tag 记录页(LogEntryTagRecordPage FlexiPage):展示标签连接的一行——它适用的 LogEntry__c 与所应用的 LoggerTag__c。很少被直接打开,多数标签调查通过 LogEntry__c 或 LoggerTag__c 上的相关列表进行;在通过 AllImpersonatedLogEntryTags 审计模拟用户的标签活动时有用。
- Logger Scenario 记录页(LoggerScenarioRecordPage FlexiPage):展示任意事务调用 Logger.setScenario(...) 后场景的持久状态,以及使用它的相关 Log__c 记录。可用于回答“哪些事务在场景 X 下运行,谁被指派跟进”。
- Logger Tag 记录页(LoggerTagRecordPage FlexiPage):展示标签目录条目及其相关 LogEntryTag__c 连接,即当前携带此标签的每条日志条目。用于审计标签分类使用情况或发现标签目录中的拼写错误/重复。
主页与实时流
控制台主页(LoggerHomePage FlexiPage)承载最具操作性的工具:
- logEntryEventStream:订阅 LogEntryEvent__e 平台事件,在日志条目发布时实时显示。这是在测试场景中确认日志是否触发的最快方式,无需等待异步保存路径持久化记录。
- logBatchPurge:按需触发日志清理批处理并报告计数。
- loggerSettings:与实用工具栏相同的设置编辑器,在整页画布上展示。
- loggerHomeHeader:导航头部,含发行说明、GitHub 和文档的快速链接。
- 嵌入式报表和仪表板,展示 Log__c、LogEntry__c、LogEntryTag__c、LoggerScenario__c 和 LoggerTag__c 的近期活动。
使用方式
典型工作流包括:
- 调查特定错误:打开 AllERRORLogEntries 列表视图;按关注的时间窗口筛选;打开 LogEntry__c 记录——链接的 Log__c 显示完整事务,Log__c 上的相关列表按顺序显示该事务中的每条条目;若事务属于异步链,沿 ParentLog__c 向上追溯父事务。
- 调查用户会话:打开 AllLogs 列表视图;按 LoggedBy__c 和时间窗口筛选;按 StartTime__c 排序查看用户事务顺序。
- 确认复现期间日志是否触发:打开 Logger Console 主页(LoggerHomePage);找到 Log Entry Event Stream 组件;在另一标签页复现场景;观察条目随 LogEntryEvent__e 平台事件发布出现。条目停止出现时异步保存已完成,持久化的记录可查询。
适用场景
适用于在 Salesforce UI 中浏览、筛选和调查 Nebula Logger 数据(如生产环境故障排查、会话审计、标签分类审计、日志触发确认)。
限制
资料未提供该工具的价格、收费、平台支持范围等具体限制信息。相关技能参见 nebula-logger-instrumentation(编写此处显示的日志条目)和 nebula-logger-purging-and-retention(记录在这些视图中的保留时长)。