Panorama 项目使用教程

1. 项目介绍

Panorama 是一个用于捕捉和增强系统现场可观测性的开源项目，旨在帮助开发者更好地检测系统故障。该项目使用 Go 语言编写，基于 gRPC 和 Protocol Buffers 构建其 RPC 层。Panorama 的主要功能包括系统观测数据的收集、处理和分析，以及故障检测和报告。

2. 项目快速启动

2.1 环境准备

在开始之前，请确保您的系统已安装以下软件：

• Go 编译器（建议版本 1.8 及以上）
• Protocol Buffers 编译器（建议版本 3.5.1 及以上）
• Go 插件 protoc-gen-go（建议版本 1.2.0 及以上）

2.2 下载与安装

您可以通过以下命令快速下载并安装 Panorama：

go get -u github.com/ryanphuang/panorama

或者手动克隆仓库并进行构建：

git clone https://github.com/ryanphuang/panorama.git
cd panorama
make

如果您没有安装 protoc-gen-go，可以使用以下命令安装：

make tool-deps

2.3 生成配置文件

使用以下命令生成 Panorama 服务配置文件：

hview-mkrc -fix_port 6688 -nserver 10 -addressp razor%d -namep pano%d -id pano0 -filter -subjects nn1,dn1,dn2,dn3

2.4 启动 Panorama 实例

启动单个 Panorama 服务器：

hview-server -addr razor0:6688 pano0

启动多个参与者的 Panorama 服务：

hview-server -config hs.cfg

3. 应用案例和最佳实践

3.1 日志监控工具

Panorama 可以与日志监控工具结合使用，例如 ZooKeeper 插件：

hview-logtail -stale=-1 -server razor0:6688 -log ~/software/zookeeper/zookeeper.out zookeeper --ensemble ~/software/zookeeper/conf/zoo.cfg --filter conf/zoo_filter.json

3.2 查询与报告

使用 Panorama 客户端提交观测报告：

hview-client -server razor0:6688

查询特定主题的健康报告：

hview-client list subject peer@1

获取特定主题的 Panorama 视图：

hview-client get panorama peer@9

4. 典型生态项目

Panorama 可以与其他系统观测和故障检测工具集成，例如：

• Prometheus: 用于监控和报警的开源系统。
• Grafana: 用于可视化和分析监控数据的开源平台。
• ELK Stack: 用于日志收集、分析和可视化的开源解决方案。

通过这些工具的集成，Panorama 可以提供更全面的系统观测和故障检测能力。