as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
“日志记录控制CLI” (LoggingCtl) 是一个命令行界面 (CLI) 工具,用于管理、查看和测试Vega设备上的日志记录数据。**它还提供对存储在设备上的崩溃报告(ACR文件)的访问权限。要访问该loggingctl命令,必须使用该vega exec vda shell命令进入 Vega 设备外壳。 此工具可以帮助您进行以下操作:
  • 通过实时日志监控调试应用问题。
  • 为不同的进程配置日志记录级别和速率。
  • 访问和分析存储的日志和崩溃报告。
  • 管理日志存储和保留。
  • 通过诊断数据调查系统问题。

安装新应用后,启动或重新启动LoggingCtl

LoggingCtl可根据会话启动时安装的应用来确定日志权限。在LoggingCtl开始之后安装的应用不会显示日志,直到您重新启动LoggingCtl会话。

基本用法

配置命令

使loggingctl config用配置命令控制应用的日志记录行为。

配置特定标签

默认情况下,config操作适用于整个过程。要将流程中的单个日志标签作为目标,请添加-t。由于预算是根据标签和级别的组合来跟踪的,因此您可以在不影响其余流程的情况下提高或降低一个标签。 对于集合操作,将标签传递为TAG=VALUE。对于 get 操作,只传递标签名称:

重置配置

要将日志配置重置为默认值,请执行以下操作:
  1. 对于速率限制: 使用恢复默认费率--reset。使用--reset而不是手动设置该值,因为显式值会在--reset清除时保留替代:
    默认速率为每个进程每秒 300 行。有效费率为 ** 1 至 60000(含税**)。loggingctl拒绝0和以上60000任何值。
  1. 对于日志级别: 将关卡设置回默认值(info在发布版本中,debug在调试版本中):

记录预算和抑制

每个流程都有日志预算。当您的应用程序发出日志行的速度超过预算允许的速度时,日志库会抑制多余的内容: 这些行会被丢弃在你的进程中,永远不会到达日志后端。抑制对你的代码不起作用。无论线路被录制还是丢弃,日志调用都会正常返回,因此带间隙的日志看起来与什么都没有发生的日志一样。这种行为在调试版本中最为明显,调试版本会记录更多并更快地达到预算。 默认预算为每个流程每秒 300 行。最低级别是info发布版本和debug调试版本。 日志标签和严重性级别的每种组合的预算是独立的。聊天debug记录器不会消耗info记录器的预算,反之亦然。干净的error直播并不意味着没有丢失任何东西info。 反复的过度发射会使抑制窗口升级(例如,1、2、4、16,最多 256 秒),并且该窗口在每个静默期向后放松一步。256 秒的窗口表示标签和关卡处于暗状态的时间已超过四分钟,因此在从该日志中得出结论之前,请减少日志量或增加预算。

检测抑制

当应用程序开始抑制时,日志库会以应用程序自己的身份写入一条warning级别消息,在停止时写入另一条级别消息。该消息以两种形式出现。 在整个流程范围内,报告级别:
每个标签,不报告等级:
搜索这两个措辞,并在不区分大小写的情况下进行匹配suppress,因为不同版本的确切大小写可能有所不同。数量因设计而异: 第一个计数贯穿整个过程中的每个关卡,第二个对所有关卡的每个标签进行计数。 要查找这些消息,请筛选应用程序的warning直播并扫描是否有抑制消息:
当你阅读计数时:
  • 该计数仅出现在报告抑制已结束的邮件上。当抑制处于活动状态时,不报告任何计数。
  • 每集后计数器都会重置。三集 40 行报告了三个独立的剧[40]集,不是[120]。
  • 如果您的进程在抑制处于活动状态时退出,则结束消息永远不会到达,计数也会丢失。
  • 这些警告本身并不受费率限制,因此预算无法压制它们。

减少掉线次数

如果您被抑制,请先减小音量: 每次状态更改而不是每次迭代记录一行,并将计数器聚合为定期摘要。如果您仍然需要更高的吞吐量,请提高该过程的速率:
要提高单个噪音标签而不是整个过程的限制,请将该标签设为以下目标:-t
完成后重置为默认值:

日志命令

使用loggingctl log命令实时查看systemd-journald内存或存储数据中的日志。 默认情况下,loggingctl logloggingctl log命令仅显示当前会话的日志。要查看较早前的日志,请使用Vega虚拟设备上的--boot—boot选项。对于 Fire TV Stick,使用loggingctl vault命令查看之前的日志。

查看日志时的推荐筛选

对于React Native和JavaScript开发者,请使用程序包ID筛选 (-v-v) 查看来自您的特定应用的日志:
要停止跟随日志,请按Ctrl+CCtrl+C。 如果您应用的日志未显示: LoggingCtl仅检测在会话开始之前安装的应用。如果您在启动LoggingCtl后安装了应用,请重新安装该应用并重新启动会话:
  1. 手动安装应用:
  2. 启动LoggingCtl:
  3. 通过vmsgr启动 使用vmsgr send以下命令启动应用程序:

JavaScript日志注意事项

在Vega应用中使用JavaScript日志时: 推荐的方法: 使用console.*console.*方法进行正确的日志级别筛选:

支持的参数关键字

--priority、、--facility``--since``--until、和--output-format命令接受特定的关键字:
  1. 优先级别 - 使用--priority—priority通过设置优先级别来控制日志可见性。这样会筛选日志输出以仅显示指定的优先级别,从而帮助您专注于来自组件或其他进程的日志。
    • emerg - 系统不可用,映射到:
      • APMF_LOG(…, FATAL)
    • alert - 必须立即采取行动
    • crit - 危急状态,映射到:
      • LOG_F(FATAL)
      • LOG_S(FATAL)
    • err - 错误状态,映射到:
      • APMF_LOG(…, ERROR)
      • LOG_F(ERROR)
      • LOG_S(ERROR)
      • console.error()”javascript”,
    • warning - 警告状态,映射到:
      • APMF_LOG(…, WARNING)
      • LOG_F(WARNING)
      • LOG_S(WARNING)
      • console.warn()”javascript”,
    • notice - 正常但重要的状况
    • info - 信息性消息,映射到:
      • APMF_LOG(…, INFO)
      • LOG_F(INFO)
      • LOG_S(INFO)
      • console.log()”javascript”,
    • debug - 调试级别消息,映射到:
      • APMF_LOG(…, DEBUG)
      • LOG_F(DEBUG)
      • LOG_S(DEBUG)
  2. 时间规范 - 使用--since—since或--until—until按时间筛选日志:
    • Keywords 关键字:now、yesterday、today和tomorrow
    • 时间格式:
  3. 输出格式使用--output-format: a. short_concise(默认)
    示例:
    b. short_precise
    示例:
对于 Vega 软件包,LoggingCTL 使用_CMDLINE而不显示软件包的网SYSLOG_IDENTIFIER址来源。使用-v-v(程序包ID)筛选对应用的日志进行筛选,这是最可靠的方法。 示例:

vault命令

使用loggingctl vault命令管理和访问smartboxd保管库系统。

访问崩溃报告(ACR文件)

使用vault命令列出和检索存储在设备上的崩溃报告文件 (ACR)。有关ACR文件的背景以及如何对其进行符号化,请参阅应用崩溃报告符号化。

列出可用的ACR文件

要查看设备上的所有ACR文件:
输出以以下格式显示文件名:
##前面的数字是用于检索文件的索引。文件名编码:

获取ACR元数据

要以JSON格式获取所有ACR文件的详细元数据:

获取最新的崩溃指数

检查ACR文件大小

检索ACR文件

--cat与构件类型SYSTEM_TOMBSTONE和索引号一起使用:
这会将原始ACR文件内容输出到stdout。

保存ACR文件

要将ACR文件保存到设备文件系统,请重定向--cat—cat的输出:

例如: 检索崩溃报告

ACR访问命令参考

权限结构

LoggingCtl通过默认权限和组件shell权限实现基于角色的访问控制。在默认模式或组件shell模式下运行时,您可以访问一下信息:
  • 索引操作 - 跟踪和管理日志索引:
    • --last-index—last-index - 查看最新的日志条目索引
    • --get-index-stats-获取有关当前日志索引的统计信息
  • 内容访问 - 对以下项使用--cat—cat查看日志:
    • 您的特定于组件的日志
    • 侧载的程序包日志
    • 系统进程: stemd、lcm_service、inputd 和相关服务
  • 信息列举操作 - 使用以下命令查看工件信息:
    • --ls—ls - 列出可用日志
    • --json-dump-导出元数据
    • --size—size - 检查工件文件大小
    • --storage—storage - 检查保管库总存储空间或特定工件存储空间
所有列举操作均适用于main、system、SYSTEM_TOMBSTONE和ACR_REPORT。

访问被拒绝

当您尝试未经授权的操作或尝试访问特权数据时,您会看到拒绝响应:

日志访问限制

LoggingCtl限制对以下日志类型的访问:
  • 侧载的组件日志
  • 守护程序设施日志
  • 系统组件包括stemd、acr_core_dump、lcm_service、servicergrd、pkgmgrd和inputd。

相关主题


最后修改于 2026年9月14日