SuperAPI AI 工具集

nebula-logger-console

部署与运维

查看项目

更新于 10-16 09:11

技能介绍

用途

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(记录在这些视图中的保留时长)。