# aliyun-oss-log-analysis

**Repository Path**: wtto00/aliyun-oss-log-analysis

## Basic Information

- **Project Name**: aliyun-oss-log-analysis
- **Description**: 用来分析阿里云对象储存OSS日志的一款软件
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2020-03-14
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: logging

**Tags**: None

## README

<p align="center">
  <img src="./docs/logo128.png" width="100">
</p>

<h1 align="center">aliyun-oss-log-analysis</h1>

<p align="center">
  <a href="https://gitee.com/wtto00/aliyun-oss-log-analysis/releases"><img src="https://badgen.net/badge/release/v0.1.0/blue" alt="Current Release"></a>
  <a href="https://gitee.com/wtto00/aliyun-oss-log-analysis/blob/master/LICENSE"><img src="https://badgen.net/badge/license/MIT/green" alt="License"></a>
</p>

---

#### 介绍

**aliyun-oss-log-analysis** 是用来分析阿里云对象储存 OSS 日志的一款软件

#### 背景

老板让我搭建一个公司内部文件管理分享平台，我使用阿里云对象储存 OSS 创建了个类似于 FTP 的平台，正好阿里云有个 `oss-browser` 客户端，可供公司内部员工使用。首先给公司内部员工每人申请个阿里云的子用户，然后 OSS 设置里面设置 `bucket` 的权限。

老板让我每周统计员工的上传下载信息，于是我写了这款软件。

#### 软件架构

使用 `Electron` 打包，界面采用 `React` + `antd`。

#### 安装教程

首先需要 `nodejs` 环境，并且已安装 `yarn` 命令

- 安装依赖

  ```bash
  yarn
  # 需要翻墙下载

  cnpm install
  # 使用阿里云镜像下载
  ```

- 开发环境运行

  使用一个活动终端一步运行:

  ```bash
  yarn es
  ```

  或者使用两个活动的终端，分别执行:

  ```bash
  yarn start

  yarn estart
  ```

- 打包

  ```bash
  yarn ebuild
  ```

  > 打包后的文件在 `dist` 目录
  >
  > 安装包在 `dist/aliyun-oss-log-analysis Setup 0.1.0.exe`
  >
  > 绿色软件包，解压即可运行 `dist/aliyun-oss-log-analysis-0.1.0-win.zip`

  > 暂时只测试了 `win` 平台，其他平台没有测试支持

#### 使用说明

1.  打包后，可以直接执行 `dist/win-unpacked/aliyun-oss-log-analysis.exe` 打开软件
    ![主界面](docs/main_page.png)
2.  登录到阿里云 OSS，把转存的日志文件下载到本地
3.  在软件中，首先选择所下载的日志文件所在文件位置
4.  设置日志文件前缀，就是日志文件日期前面的部分。[阿里云官方文档](https://help.aliyun.com/document_detail/31868.html)
5.  选择统计分析日志的时间段，实际处理过程中，是按照日志文件名来筛选的，与日志文件内容中的日期时间无关。
6.  最后点击 `统计处理` 按钮，即可在下方表格中显示分析统计的结果
    ![显示结果](docs/result.png)

> 结果的用户字段，可以在设置中设置用户的备注
> ![设置用户备注](docs/users.png)