loggingctl命令,必须使用该vega exec vda shell命令进入 Vega 设备外壳。
此工具可以帮助您进行以下操作:
- 通过实时日志监控调试应用问题。
- 为不同的进程配置日志记录级别和速率。
- 访问和分析存储的日志和崩溃报告。
- 管理日志存储和保留。
- 通过诊断数据调查系统问题。
安装新应用后,启动或重新启动LoggingCtl
LoggingCtl可根据会话启动时安装的应用来确定日志权限。在LoggingCtl开始之后安装的应用不会显示日志,直到您重新启动LoggingCtl会话。基本用法
配置命令
使loggingctl config用配置命令控制应用的日志记录行为。
配置特定标签
默认情况下,config操作适用于整个过程。要将流程中的单个日志标签作为目标,请添加-t。由于预算是根据标签和级别的组合来跟踪的,因此您可以在不影响其余流程的情况下提高或降低一个标签。
对于集合操作,将标签传递为TAG=VALUE。对于 get 操作,只传递标签名称:
重置配置
要将日志配置重置为默认值,请执行以下操作:-
对于速率限制: 使用恢复默认费率
--reset。使用--reset而不是手动设置该值,因为显式值会在--reset清除时保留替代:默认速率为每个进程每秒 300 行。有效费率为 ** 1 至 60000(含税**)。loggingctl拒绝0和以上60000任何值。
-
对于日志级别: 将关卡设置回默认值(
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后安装了应用,请重新安装该应用并重新启动会话:
-
手动安装应用:
-
启动LoggingCtl:
-
通过vmsgr启动
使用
vmsgr send以下命令启动应用程序:
JavaScript日志注意事项
在Vega应用中使用JavaScript日志时: 推荐的方法: 使用console.*console.*方法进行正确的日志级别筛选:
支持的参数关键字
--priority、、--facility``--since``--until、和--output-format命令接受特定的关键字:
-
优先级别 - 使用
--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)
- emerg - 系统不可用,映射到:
-
时间规范 - 使用
--since—since或--until—until按时间筛选日志:- Keywords 关键字:now、yesterday、today和tomorrow
-
时间格式:
-
输出格式使用
--output-format: a. short_concise(默认)示例:b. short_precise示例:
_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文件
要将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 - 检查保管库总存储空间或特定工件存储空间
访问被拒绝
当您尝试未经授权的操作或尝试访问特权数据时,您会看到拒绝响应:日志访问限制
LoggingCtl限制对以下日志类型的访问:- 侧载的组件日志
- 守护程序设施日志
- 系统组件包括stemd、acr_core_dump、lcm_service、servicergrd、pkgmgrd和inputd。

