安装命令行工具

安装 Grafana

在 Windows 系统上安装：

1. 访问 Grafana 官方下载页面。
2. 下载并安装 Grafana 的 Windows 版本。
3. 启动 Grafana，默认端口是 3003。

在 Linux 系统上安装：

1. 使用包管理器安装：
   • Ubuntu/Debian：

     sudo apt-get update && sudo apt-get install grafana

   • CentOS/RHEL：

     sudo yum install grafana

2. 启动服务并设置为自动启动：

   sudo systemctl start grafana-server
   sudo systemctl enable grafana-server

使用 Docker 安装：

1. 拉取 Grafana 镜像：

   docker pull grafana/grafana

2. 启动容器：

   docker run -d -p 3003:3003 grafana/grafana

配置数据源

Grafana 支持多种数据源，如 Prometheus、InfluxDB、MongoDB 等,以下是常见配置方法：

添加 Prometheus 数据源：

1. 进入 Grafana 的界面，登录账号（默认用户名密码为 admin）。
2. 点击数据源图标（通常为齿轮图标），选择 数据源 > 添加数据源。
3. 选择数据源类型为 Prometheus，输入 Prometheus 的地址、端口（默认为 909）和路径（默认为 /metrics）。
4. 点击 保存。

添加 InfluxDB 数据源：

1. 在数据源页面，选择 InfluxDB。
2. 输入 InfluxDB 的地址、端口（默认为 8086）和数据库名称。
3. 点击 保存。

添加 MongoDB 数据源：

1. 选择 MongoDB 数据源。
2. 输入 MongoDB 的地址、端口（默认为 27017）和数据库名称。
3. 点击 保存。

创建仪表盘

步骤 1：选择数据系列

1. 在仪表盘编辑器中，点击 添加数据系列（通常为 + 图标）。
2. 选择数据源和数据系列（如 Prometheus 中的时间序列数据）。

步骤 2：选择图表类型

1. 在数据系列中，点击 可视化 图标，选择图表类型（如柱状图、折线图、饼图等）。

步骤 3：调整图表和布局

1. 调整图表的颜色、标签和字体大小。
2. 添加描述和单位,确保数据清晰易懂。
3. 调整布局，添加标题、图例和时间轴。

步骤 4：保存仪表盘

1. 点击 保存 按钮，选择保存的位置（如默认的 Grafana 数据库或本地文件）。

导出和分享仪表盘

1. 在仪表盘页面，点击 导出 图标，选择 PDF、PNG 或 SVG 格式。
2. 使用分享链接（URL）将仪表盘分享给其他用户。

高级功能

时间范围选择

在 Grafana 的顶部，使用时间范围 controls（如时间范围、时间偏移）筛选数据。

标签和布局调整

1. 在仪表盘编辑器中，使用 （右上角）调整图表布局。
2. 使用 布局（左上角）调整图表大小和排列。

数据标注

在图表中,点击数据点并拖动到目标位置以添加标注。

数据预处理

1. 在数据源配置中，使用 查询 选项对数据进行预处理（如过滤、聚合）。

使用 Grafana 的命令行工具

Grafana 提供一个命令行工具 grafana-cli,用于批量操作：

# 创建一个新的仪表盘：
grafana-cli create --name "My Dashboard" --file "myfile.json"
# 导出仪表盘：
grafana-cli export --id=your-dashboard-id

常见问题

1. 数据源连接错误：

   • 检查数据源地址和端口是否正确。
   • 确保数据源服务正在运行。

2. 权限问题：

   • 默认用户名和密码是 admin。
   • 配置用户权限时,确保用户有适当的数据源访问权限。

3. 仪表盘显示为空：

   • 确保数据源中有数据。
   • 检查数据系列和查询是否正确。