# lmp

**Repository Path**: tymmh/lmp

## Basic Information

- **Project Name**: lmp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-06-21
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Linux microscope

LMP是一个基于bcc(BPF Compiler Collection)的Linux系统性能数据实时展示的web工具，它使用BPF(Berkeley Packet Filters)，也叫eBPF，目前LMP在ubuntu18.04上测试通过，内核版本4.15.0。

## startup

TODO...

## 项目架构

![](./docs/LMP-arch.png)

## 界面截图

<details>
<summary>展开查看</summary>
<pre><code>
<img src="./static/imgs/homepage.png" width="2880" height="450" /><br/><br/>
</code></pre>
</details>


## 项目结构概览

<details>
<summary>展开查看</summary>
<pre><code>.
├── README.md
├── api   协议文件、前端交互的接口文件等, 本项目的路由设置与路由函数
├── cmd   main函数文件目录
├── config   配置文件
├── deployments   后端下发的一些配置文件与模板
├── docs   本项目设计文档，项目经历记录文档等
├── go.mod
├── go.sum
├── internal   本项目封装的代码，其中包括BPF代码等
├── pkg   通用的可以被其他项目所使用的一些代码
├── static   项目用到的一些静态页面，包括前端静态展示页、图片等
├── test   测试目录，包括功能测试，性能测试等
└── vendor   本项目依赖的其它第三方库
</code></pre>
</details>

##  安装lmp

###  Ubuntu-source

#### 从源码构建lmp，需要的基本环境：

- golang
- docker

###  安装依赖docker镜像

```
# For prometheus 
 docker pull prom/prometheus
# For grafana
 docker pull grafana/grafana
```

### 编译并安装

```
 git clone https://github.com/linuxkerneltravel/lmp
 cd lmp
 make
 make install
```

## 本地运行

```
# 修改配置文件
 将/opt/prometheus/prometheus.yml中xxx替换为本机的IP地址
#run prometheus
 docker run  -d \
   -p 9090:9090 \
   -v /opt/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml  \
   prom/prometheus

#run grafana
 docker run -d \
   -p 3000:3000 \
   --name=grafana \
   -v /opt/grafana-storage:/var/lib/grafana \
   grafana/grafana

#run lmp
 ./cmd/main
```

### 进行观测

http://localhost:8080/ 登录grafana之后，导入/opt/grafana下的json文件即可查看。

### 卸载

```
make clean
```

## 感谢以下开源项目的支持

- [Gin] - [https://gin-gonic.com/](https://gin-gonic.com/)
- [bcc] - [https://github.com/iovisor/bcc](https://github.com/iovisor/bcc)