Logan
概述
Logan是一个具备收集、存储、上传和分析前端日志能力的日志平台。我们提供五个组件,包括 iOS SDK、Android SDK、Web SDK、分析服务Server SDK和LoganSite。此外,我们还提供了Flutter插件Flutter Plugin。
架构
LoganSite概述
搜索日志
日志详情
快速开始
iOS SDK
如何在您的项目中使用SDK
首先创建一个名为Podfile的文件,然后将以下代码复制到该文件中。
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
target 'TargetName' do
pod 'Logan', '~> 1.2.5'
end
最后,在项目根目录中运行以下命令。
pod install
iOS SDK 文档
更多内容请查看:iOS SDK
Android SDK
Android Studio: Not required, version 3.4 or higher is recomand.
NDK: r16b
CMake: >= 3.4.1
Jdk: 1.7 or 1.8(recomand)
Android SDK 文档
更多内容请查看:Android SDK
Web SDK
Web SDK支持在H5和浏览器环境中进行日志记录。
安装
使用 npm
安装 logan-web
npm install --save logan-web
或 yarn
yarn add logan-web
Web SDK 文档
更多信息请参阅:Web SDK
服务器
服务器文档
LoganSite
LoganSite 提供了开发人员扫描和搜索从 App 和 Web 上传的日志的可视化方式。
环境
Node: ^10.15.3
yarn: ^1.15.2 或 npm ^6.12.0
安装
首先,将仓库克隆到本地。
在 LoganSite 目录中创建 .env.development
,并设置像下面的 API_BASE_URL
API_BASE_URL=http://location/to/your/server:port
然后执行以下命令:
$ cd $LOGAN_SITE
$ npm install
$ npm run start
或者:
$ cd $LOGAN_SITE
$ yarn
$ yarn start
构建
首先,将仓库克隆到本地。
将 LoganSite/src/common/api.js 的第四行替换为以下内容
const BASE_URL = "http://location/to/your/server:port"
然后执行以下命令:
$ cd $LOGAN_SITE
$ npm install
$ npm run build
或者:
$ cd $LOGAN_SITE
$ yarn
$ yarn build
LoganSite 文档
更多内容请参阅:LoganSite
最佳实践
在 Logan 可用之前,日志报告系统相对分散。
简单来说,传统想法是把每个系统日志中出现的各种问题拼凑起来,但新想法是汇总和分析用户生成的所有日志,以找出有问题的场景。
Logan 核心系统由四个模块组成
- 输入
- 存储
- 后端
- 前端
新的案例分析过程如下
功能
未来,我们将提供一个基于 Logan 大数据的平台,包括机器学习、故障排除日志解决方案和大数据特性分析等高级功能。
最后,我们希望提供一个更完整的一体化案例分析生态系统。
模块 | 开源 | 处理 | 规划 |
---|---|---|---|
iOS & macOS | √ | ||
Android | √ | ||
Web | √ | ||
小程序 | √ | ||
后端 | √ | ||
前端 | √ |
贡献
有关提交 PR 和问题的更多信息,请参阅我们的贡献指南。
作者
-
白磊 - 核心开发者 - baitian0521
-
曹理强 - 核心开发者 - Richard-Cao
-
江腾 - 核心开发者 - jiangteng
-
杨向东 - 核心开发者 - yangxiangnan
-
小军 - 核心开发者 - Mr-xiaojun
参与此项目的贡献者请参阅贡献者列表。
联系方式
微信ID
MTDPtech, MTDPtech01, MTDPtech03
许可证
Logan采用MIT许可证 - 详细内容请参阅LICENSE文件。