在运维与数据分析场景中，将阿里云日志服务的采集数据接入Grafana，可实现日志指标的可视化展示、实时监控与智能分析，大幅降低排查故障的成本。本文基于官方实操规范，以Nginx日志分析场景为例，梳理出一套严谨可落地的完整对接流程。可观测可视化 Grafana 版官网：https://www.aliyun.com/product/aliware/grafana
一、前置准备工作
在启动对接前，需完成两项基础配置：
- 提前通过日志服务的Nginx配置模式完成文本日志采集，将业务侧的Nginx访问日志全量同步至日志服务对应的Project中。
- 在日志服务控制台开启并配置索引规则，确保后续可对日志中的状态码、访问耗时、请求路径等字段进行检索与统计分析。
- 提前部署Grafana服务，本次实操以11.4.0版本为例，若在本地部署需提前开放浏览器访问3000端口。如果需要使用饼图做占比统计，可提前执行命令安装Pie Chart插件：
- text
grafana-cli plugins install grafana-piechart-panel
二、日志服务Grafana数据源插件安装
阿里云日志服务官网：https://www.aliyun.com/product/sls 首先下载官方提供的数据源插件压缩包，下载命令为：
text
wget https://github.com/aliyun/aliyun-log-grafana-datasource-plugin/archive/refs/heads/master.zip
解压插件时需根据Grafana的安装方式选择对应路径：
- 若通过YUM或RPM安装Grafana，执行命令将插件解压至系统插件目录：
- text
unzip aliyun-log-grafana-datasource-plugin-master.zip -d /var/lib/grafana/plugins- 若通过.tar.gz包手动安装Grafana，需将插件解压至安装路径下的plugins目录，替换路径变量后执行：
- text
unzip aliyun-log-grafana-datasource-plugin-master.zip -d {PATH_TO}/grafana-11.4.0/data/plugins
完成解压后修改Grafana配置文件：
- YUM/RPM安装的Grafana，打开
/etc/grafana/grafana.ini - 手动解压安装的Grafana，打开
{PATH_TO}/grafana-11.4.0/conf/defaults.ini
在配置文件的[plugins]节点中添加配置，允许加载未签名的日志服务数据源插件：
text
allow_loading_unsigned_plugins = aliyun-log-service-datasource
最后重启Grafana服务即可完成插件部署：
- YUM/RPM安装场景执行：
systemctl restart grafana-server - 手动解压场景执行：
./bin/grafana-server web
三、数据源配置与权限规范
登录Grafana控制台后，依次进入左侧菜单栏的Connections > Data Sources，点击添加数据源，搜索并选中log-service-datasource，按规范填写核心配置项：
- Endpoint：填写日志服务Project对应的地域服务入口，例如青岛地域的入口为
http://cn-qingdao.log.aliyuncs.com，需根据实际部署地域替换。 - Project：填写提前创建好的、已完成Nginx日志采集的日志服务Project名称。
- 若需要配置STS免登跳转，需严格遵循权限规范：
- 用于配置数据源AccessKey的RAM用户，必须同时拥有
AliyunRAMReadOnlyAccess、AliyunSTSAssumeRoleAccess、日志服务相关权限以及调用CreateTicket接口的权限。 - 配置的角色ARN对应的RAM角色，仅需绑定
AliyunLogReadOnlyAccess只读权限，避免权限溢出带来的安全风险。
需注意，若开启Grafana仪表盘公开分享，可能会带来额外的日志读取流量成本，同时存在日志内容泄露的隐患，生产环境需谨慎开启该功能。
四、版本兼容性说明
不同版本的Grafana需匹配对应版本的日志服务数据源插件，避免出现功能异常：
- 当Grafana版本≥8.0.0时，需使用2.x版本的日志服务插件，本次实操的11.4.0版本完全适配该版本插件。
- 当Grafana版本<8.0.0时，需使用1.0版本的日志服务插件，不支持后续新增的多维度统计、STS跳转等高级功能。
完成全部配置后，即可在Grafana中新建仪表盘，通过SQL查询语句对Nginx日志的访问量、错误码占比、请求耗时分布等指标进行可视化配置，实现全链路的日志监控与分析。
