HELP.md · 胶布小子/Plumelog

### plumelog日志查询使用指南

#### 一、日志查询
     
   * 字段说明
     
     ![avatar](/pic/zdsm.png)
     
   * 内容语法
     
     1.中文需要用双引号包含 例如:"异常",默认会被按照单字体分割检索
     
     ![avatar](/pic/nr1.png)
     
     2.多个检索条件可以用  AND OR NOT 来组合查询 例如 "异常" AND "内容"

3.单个不可分割单词可以用*开头或者结尾进行模糊匹配 例如 *NullPointerException;查询到了java.lang.NullPointerException；

![avatar](/pic/nr2.png)

4.注意：英文符号的 . :  等不是默认的分隔符；需要用上面的方式去匹配

* 表格区域说明
      
     1.点击列内容帮旁边的放大镜按钮可以完成快速筛选

2.左下角可以开启关闭显示字段，不关闭浏览器设置不会消失

3.右下角可以自定义每页日志显示条数，方便不通人的阅读习惯

![avatar](/pic/gr.png)

#### 二、链路追踪

* 如果配置了链路追踪，点击表格里的追踪码即可链接到链路追踪内容，如何配置链路追踪 =》[链路追踪使用点我](/plumelog-trace/README.md)

![avatar](/pic/LL.png)

![avatar](/pic/LL2.png)

#### 三、扩展字段

* 选择应用名称，点击添加，填入扩展字段 字段，和显示名；字段名用来代码里面设置值，显示名代表表格里的显示名

![avatar](/pic/kzzd.png)

![avatar](/pic/kzzdxc.png)

* 通过扩展字段查询的时候在扩展字段查询里面输入内容后点击填加，及可以通过扩展字段筛选日志内容
 
   1.应用场景，比如想通过订单号来串联日志，就可以设置一个订单号的扩展字段然后在代码开始的地方加上
  
```java
            MDC.put("orderid", "312312312312");
            logger.info("扩展字段");
``` 
![avatar](/pic/kzzdddh.png)

#### 四、报警管理

* 报警管理配置

![avatar](/pic/bjgl.png)

* 报警记录

![avatar](/pic/5.png)

#### 五、管理

* 用于查看日志条数磁盘占用大小等，也可以手动删除某个分片的日志

* day模式按照天展示，hour模式按照小时展示

#### 六、常见问题

* redis在项目中充当什么角色？

redis在项目中两个角色，第一是在redis模式下充当消息队列，第二是项目本身的元数据存储和报警管理

* 为什么我查看redis中有数据，但是后台却查不到呢？

这种情况大概率是server中 plumelog.queue.redis.redisHost 没有配置正确，redis只是充当队列的作用，如果里面能看到数据说明没有server没有消费，正常情况应该是redis是不会积压的

* 为什么我配置了，之后后台无法查到日志？

排查方法：第一步：停止server,启动日志采集项目，观察redis中有没有数据，如果有说明从项目进入队列是通的，如果没有检查项目端redis配置是否正确；第二步：如果在redis有数据情况，启动server，如果server日志里有ElasticSearch commit! success；表示链路成功

* 为什么我链路追踪里看不到数据？

链路追踪模块产生的日志量比较大，考虑到低需求玩家，默认不集成，需要单独配置，详细查看文档：[链路追踪配置](/plumelog-trace/README.md)

* plumelog客户端配置能结合配置文件中心使用吗？

肯定是可以的，plumelog配置是配置在三大日志框架的配置文件里面的，可以使用springProperty进行管理配置，具体怎么操作看每个项目自己的情况

* plumelog目前生产环境已知的已经有多大体量

根据用户反馈，目前搜集到最大的用户每日日志量已经到达3TB，并稳定运行

* 为什么我的项目继承了plumelog就启动就报错？

如果提示redis连接失败，那么说明redis配置错误，如果是其他错误，比如提示类找不到什么情况，应该数据日志配置文件错了，建议先熟练掌握log4j,logback配制文件里面的标签含义

胶布小子/Plumelog

简介

发行版

贡献者

近期动态

胶布小子/Plumelog .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

胶布小子/Plumelog