|
赶快注册并登录访问我们网站,呈现更多精彩内容!
您需要 登录 才可以下载或查看,没有帐号?注册加入
x
快速本地使用:
1 [$ y/ t" d8 v [) t1. 在Windows电脑上,我们推荐使用WM_COPYDATA消息进行日志传输,资源占用最少,速度最快。
( q- I+ `9 {0 e: T; O2. 如果您的应用程序已经具备UDP或TCP功能,可以直接通过原有的Socket将日志发送到本机的127...1。. J7 o: D6 m1 U6 L4 ]3 G
3. 对于嵌入式系统的本地调试,您可以通过串口、USB或网口来进行日志传输。
; V& p V: ~4 f$ D6 K- G. N$ M, W8 |! q) R; \3 K* K1 ^! t4 d
便捷远程及云端使用:4 R8 F* M7 L+ V- s% P4 M, U
1. 您可以在路由器中设置端口转发功能,将对应的端口转发到安装了CloudLog的电脑上。: a9 E3 U9 e- O) P m" F
2. 为了方便获取到电脑所在的IP地址,我们建议使用动态域名系统(DDNS)服务。
/ t7 i$ {/ @) n7 C, e9 W, }4 m1 r3. 使用云控域名账号,在服务器上保存日志,您可以随时打开CloudLog回读所有未读过的日志。
& Z) x5 p; a* [# V7 V4 s1 ], T$ c$ R, i1 o0 j" T) D
CloudLog的日志元素介绍:& U: W0 I; V9 q {1 a0 V8 {* V, a, S
1. 日志等级(Log Level,简写为LL)用于确认日志的重要性。
: u! k2 j2 ]4 | v8 z2. 日期时间Tick(Date Time tick,简写为DT)用于确定日志生成的时刻。
8 N) a- V' P. t0 N0 X' _3. 应用名(App Name,简写为AN)用于确认日志的来源项目或进程。4 `& H( Y: e; Z0 q. p
4. 标签(Tag,简写为TA)用于按模块化区分日志。& a" m0 S4 p' q, A: F7 C4 j. X
5. 线程标识符(Thread Identity,简写为TI)用于区分多线程。
* x: C* C/ t4 P. m$ T6. 文字内码(Text Code,简写为TC)用于实时调整当前的内码。
# _+ x# a( T6 f7. 日志文字(Log Text,简写为LT)可以使用任何内码进行记录。
- D( O- H; R2 C3 t# @8. 日志缓冲(Log Buffer,简写为LB)可以传送阵列缓冲。
' U2 p) r1 J3 X) m, h( A4 Q/ N9. 计时功能可以根据前一条日志的tick,计算出精确到1微秒的用时。; Q8 Y7 G: v9 R0 }5 K0 k" L* w
' E6 `5 j [! F+ q* E& f4 q
CloudLog的日志等级说明:
) D5 b4 C) B8 q, o+ p2 s1. Error级别表示严重的问题或软件执行功能错误,是最高等级的日志,无法屏蔽。
! Z" o8 {) F! K" F0 @& h2. Warn级别表示可能出现潜在错误的情况,当选择Error级别时,Warn级别的日志将不会显示。4 E" u0 `- K) M7 D
3. Info级别强调应用程序运行过程中的一些重要信息。8 q+ }. l" E& D6 v) j! W7 [2 q$ l
4. Debug级别仅在开发期间有用的调试消息,等级较低,在正式发布时一般不会出现。) R, H% ^) z8 }, E7 y: I
5. Buffer阵列数值直接显示等级与Debug相同。8 Z1 f: \ T; I
6. Fixer级别用于固定位置显示日志,这些日志不保存到log文件中。
+ F0 u$ u$ }; X& q- e0 o y2 T& Z* _ r# Q9 L1 o2 n
CloudLog的日志过滤器功能:
2 D6 {& K1 u, G! B1. 可以根据日志等级及各种组合来过滤日志记录。) I/ I _3 j5 B& ]( `1 c
2. 关键词可以高亮显示,以增强可读性,您可以自定义加大、加粗或指定专门的颜色进行高亮突出显示。9 d: o6 f& _6 f3 G
3. 您可以指定关键词,使含有指定关键词的日志不显示。
c$ _* u2 a/ A4. 您也可以指定关键词,使含有指定关键词的日志显示。, g# W$ e, s5 r9 r4 w
5. 您还可以根据应用名中的关键词进行显示过滤。
1 s' m/ q9 H$ |. k6. 同样地,您可以根据标签中的关键词进行显示过滤。
* S8 [1 J) h3 U( `0 {" |+ @7 A% @& `5 @
CloudLog支持的键值对风格文字:
" _' [& k! ^1 y6 ]1 h/ O& L1. 使用'&'分隔各个日志元素,每个元素由键值':'数值组成。/ D& K# C s5 G( z! P+ {
2. 日期时间Tick、日志文字及日志缓冲的数值使用Base64编码。- b. m: N: O5 j5 p
3. 应用名、标签及线程标识符一般只使用数字或字母。
# D- C9 T8 d6 {# k# I4. 日期时间可以选择是否传送,可以是2字节的毫秒(ms)、3字节的微秒(us)或8字节的全部时间。" P/ f u' _* k# Y5 f
5. 一个简单的示例:"hello"日志可以表示为:ll:D&/aGVsbG8=+ [4 X: u: ^8 @; K. B& b3 V4 D
3 _& v' X: x+ a5 h- ~" I" A$ B% v
CloudLog支持的简易风格文字:7 ]8 R9 r5 J: V) J
1. 使用空格分隔各个日志元素,请勿调换元素的顺序。
* S; T1 f: C: O( ~2. 最少包含日志等级(LL)空格及日志文字(LT)。# {) ?# b( e, y1 S
3. LL+LT+文字,LT表示4位数的毫秒tick,范围从000到9999,最大可以表示10秒的时间间隔。
/ i1 D1 y C$ ~- A# O, y4. LL+LT+TAG+文字,TAG标签用于按模块化区分日志,一般使用字母表示。6 C' p" V; C2 C* X- a# K
5. LL+LT+TAG+TI+文字,TI为-9的数字,表示线程标识符。
% X& s0 R6 F8 Q% ?4 N [5 D7 o6. LL+LT+TAG+TI+TC+文字,TC为G=GBK内码或U=UTF-8内码。1 D1 V T4 O+ {8 G. I9 F' N
3 R/ ~# d0 p' H6 b* F$ h) x" t8 j使用开源库CloudLog的方法:# E$ I- F2 G# v7 m! ~
1. 直接从 https://gitee.com/hsav20/CloudLog.git 克隆整个仓库。
) \4 b" t$ p8 a( w V" B0 J2. 将CloudLog.c和CloudLog.h文件添加到您的项目中。# I" N+ d+ V+ E
3. 在对应的平台目录(如PlatformWindows)中找到一个最接近的模板文件FwbConf.h,并将其复制到您的项目中。
/ |5 S! w( e$ O- ]4. 根据您的实际使用环境,修改FwbConf.h中的配置信息。' S$ p) A9 P2 f, r
5. 参考PlatformWindows目录下的main.c文件,您可以了解如何输出不同类型的日志。 |
|