开源项目rare使用教程

开源项目rare使用教程

rare Realtime regex-extraction and aggregation into common CLI formats such as histograms, bar graphs, numerical summaries, tables, and more! 项目地址: https://gitcode.com/gh_mirrors/ra/rare

1、项目介绍

rare是一个快速文本扫描器和实时汇总工具，能够通过正则表达式和表达式提取文本文件中的信息，并实时生成各种图表和摘要。它支持多种CLI图形和度量格式，如过滤器（类似grep）、直方图、表格、热图等。rare的设计灵感来自于"more"和"less"，但它也可以代表"实时聚合正则表达式"。

2、项目快速启动

安装

使用Bash脚本安装

curl -sfL https://rare.zdyn.net/install.sh | bash

手动安装（预构建二进制文件）

从Releases页面下载适合你操作系统的二进制文件或包。

使用Homebrew安装

brew tap zix99/rare
brew install rare

快速使用

以下是一个简单的示例，展示如何使用rare从文本文件中生成直方图：

# 创建一个示例文件
echo -e "1\n2\n1\n3\n1\n0" > input.txt

# 使用rare生成直方图
rare histo input.txt

输出结果：

1 3
0 1
2 1
3 1

3、应用案例和最佳实践

案例1：从Nginx日志中提取状态码和大小

假设你有一个Nginx访问日志文件access.log，你可以使用rare提取状态码和响应大小：

rare filter -n 4 -m "(\d{3}) (\d+)" -e "[1] [2]" access.log

输出结果：

404 169
404 169
404 571
404 571

案例2：从Nginx日志中提取状态码并生成直方图

你可以使用rare从Nginx日志中提取状态码并生成直方图：

rare histo -m '"(\w{3,4}) ([A-Za-z0-9/]+) *" (\d{3})' -e '[3] [1]' access.log

输出结果：

200 GET 160663
404 GET 857
304 GET 53
200 HEAD 18
403 GET 14

4、典型生态项目

1. Nginx

rare可以与Nginx日志结合使用，提取和分析日志中的关键信息，如状态码、响应时间等。

2. Apache

类似于Nginx，rare也可以用于Apache日志的分析，帮助管理员快速了解服务器的运行状态。

3. Logstash

虽然Logstash是一个强大的日志收集和处理工具，但rare可以作为一个轻量级的替代方案，特别是在需要实时分析和可视化日志数据时。

4. Grafana

Grafana是一个流行的可视化工具，rare可以生成数据供Grafana使用，从而实现更复杂的监控和分析。

通过以上模块的介绍，你可以快速上手并深入了解rare项目，并将其应用于实际的日志分析和数据可视化任务中。

rare Realtime regex-extraction and aggregation into common CLI formats such as histograms, bar graphs, numerical summaries, tables, and more! 项目地址: https://gitcode.com/gh_mirrors/ra/rare