Skip to content

Commit

Permalink
📄 Update README docs file
Browse files Browse the repository at this point in the history
  • Loading branch information
Cairry committed Dec 27, 2024
1 parent d8e0545 commit 2492903
Showing 1 changed file with 38 additions and 9 deletions.
47 changes: 38 additions & 9 deletions deploy/README.md → README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,27 @@
# 运行 WatchLog
## 确定参数配置
WatchLog
========
## 🎉 项目介绍
`WatchLog`是一个云原生容器日志采集工具。你可以使用它来收集`Docker``Containerd`的容器日志并发送到集中式日志管理系统中,例如`elasticsearch` `kafka` `redis`等。

## ♻️ 版本兼容

**Input**

| Service | Version |
|------------|------------|
| Docker | 推荐 20.x ➕ |
| Containerd | 推荐 1.2.x ➕ |

**Output**

| Service | Version |
|---------------|--------------|
| Elasticsearch | 推荐 7.10.x ➕ |
| Kafka | 推荐 2.x ➕ |
| Redis | 推荐 6.x ➕ |

## 🚀 快速开始
### 确定参数配置
- LOG_PREFIX:日志前缀标识, 默认是watchlog, 支持自定义
- LOG_BASE_DIR:日志存储目录(挂载到WatchLog容器内的路径),默认 `/host/var/log/pods`
- RUNTIME_TYPE:运行时类型,支持`docker` `containerd`
Expand Down Expand Up @@ -61,20 +83,27 @@
- name: FILE_NAME
value: "filebeat"
```
## 启动服务
### 启动服务
```bash
kubectl apply -f ./kubernetes/watchlog.yaml
kubectl apply -f ./deploy/kubernetes/watchlog.yaml
```

# 运行测试用例
## 前提条件
### 运行测试用例
#### 前提条件
需要为每个被收集的`Controller`/`Pod`中, 注入日志采集前缀标志`watchlog_{xxx}`的环境变量, 前缀标识取决于 WatchLog 服务的环境变量 LOG_PREFIX, 默认情况下是 watchlog.
```yaml
- env:
- name: watchlog_default-nginx
value: stdout
```
## 启动服务
#### 启动服务
```bash
kubectl apply -f ./kubernetes/nginx.yaml
```
kubectl apply -f ./deploy/kubernetes/nginx.yaml
```

## 🎸 支持
- 如果你觉得 WatchLog 还不错,可以通过 Star 来表示你的喜欢
- 在公司或个人项目中使用 WatchLog,并帮忙推广给伙伴使用

## 🧑‍💻 交流渠道
- [点击我](https://cairry.github.io/docs/#%E4%BA%A4%E6%B5%81%E7%BE%A4-%E8%81%94%E7%B3%BB%E6%88%91)

0 comments on commit 2492903

Please sign in to comment.