Skip to main content

快速入门

Grafana 是一个开源的度量分析与可视化套件。经常被用作基础设施的时间序列数据和应用程序分析的可视化,它在其他领域也被广泛的使用包括工业传感器、家庭自动化、天气和过程控制等。

部署 Websoft9 提供的 Grafana 之后,请参考下面的步骤快速入门。

准备

  1. 在云控制台获取您的 服务器公网 IP 地址
  2. 在云控制台安全组中,检查 Inbound(入)规则 下的 TCP:80 端口是否开启
  3. 在服务器中查看 Grafana 的 默认账号和密码
  4. 若想用域名访问 Grafana,务必先完成域名五步设置 过程

Grafana 初始化向导

详细步骤

  1. 使用本地电脑的浏览器访问网址: http://域名 或  http://服务器公网IP, 就进入登录页面 Grafana 登录

  2. 输入默认的用户名和密码(不知道账号密码?

  3. 登录到 Grafana 控制台页面
    Grafana 控制台

  4. 通过【Configuration】>【Plugins】添加插件
    Grafana 添加插件

  5. 通过【Configuration】>【Data Sources】添加数据源(分析对象)
    Grafana 添加数据源

  6. 通过【Configuration】>【Users】增加用户
    Grafana 添加用户

需要了解更多 Grafana 的使用,请参考官方文档:Grafana Documentation

出现问题?

若碰到问题,请第一时刻联系 技术支持。也可以先参考下面列出的问题定位或 FAQ 尝试快速解决问题。

Grafana 使用入门

下面以 xxx 配置数据监控作为范例。

Grafana 常用操作

配置 SMTP

  1. 在邮箱管理控制台获取 SMTP 相关参数

  2. 修改Grafana 配置文件,增加如下的 SMTP 配置段

    #################################### SMTP / Emailing #####################
    [smtp]
    enabled = false
    host = localhost:25
    user =
    # If the password contains # or ; you have to wrap it with triple quotes. Ex """#password;"""
    password =
    cert_file =
    key_file =
    skip_verify = false
    from_address = admin@grafana.localhost
    from_name = Grafana
    ehlo_identity =

    [emails]
    welcome_email_on_sign_up = false
    templates_pattern = emails/*.html
  3. 重启服务

    sudo systemctl restart grafana-server
  4. 登录 Grafana 控制台,打开:【Alerting】>【Alert Rules】,新建一个【Email】通知渠道 Grafana SMTP

  5. 点击【Send Test】

重置密码

SSH 登录服务器,运行下面的命令即可

# 修改管理员密码
docker exec -it grafana grafana-cli admin reset-admin-password admin123

Grafana 参数

Grafana 应用中包含 Nginx, MySQL 等组件,可通过 通用参数表 查看路径、服务、端口等参数。

CONTAINER ID   IMAGE                    COMMAND                  CREATED          STATUS          PORTS                                       NAMES
0e8348b13542 phpmyadmin:latest "/docker-entrypoint.…" 12 minutes ago Up 12 minutes 0.0.0.0:9090->80/tcp, :::9090->80/tcp phpmyadmin
12bb28a1571e grafana/grafana:latest "/run.sh" 13 minutes ago Up 13 minutes 0.0.0.0:9001->3000/tcp, :::9001->3000/tcp grafana
5eaf5c965651 grafana/promtail:main "/usr/bin/promtail -…" 13 minutes ago Up 13 minutes grafana-promtail
610a9ad5edfe mysql:5.7 "docker-entrypoint.s…" 13 minutes ago Up 13 minutes 3306/tcp, 33060/tcp grafana-db
49b08cdf0e3d grafana/loki:main "/usr/bin/loki -conf…" 13 minutes ago Up 13 minutes 3100/tcp grafana-loki

路径

Grafana 安装目录:/data/apps/grafana
Grafana 配置文件:/data/apps/grafana/data/grafana_config/grafana.ini
Grafana 日志目录:/data/apps/grafana/data/grafana_logs
Grafana 数据目录:/data/apps/grafana/data/grafana_data

端口

无特殊端口

版本

# Grafana Version
sudo docker exec -it grafana grafana-cli -v

服务

sudo docker l start | stop | restart | stats grafana
sudo docker l start | stop | restart | stats grafana-db
sudo docker l start | stop | restart | stats grafana-promtail
sudo docker l start | stop | restart | stats grafana-loki

命令行

Grafana 提供命令行工具grafana-cli用于全面管理和配置 Grafana

$ docker exec -it grafana grafana-cli -h
NAME:
Grafana CLI - A new cli application

USAGE:
grafana-cli [global options] command [command options] [arguments...]

VERSION:
8.4.4

AUTHOR:
Grafana Project <hello@grafana.com>

COMMANDS:
plugins Manage plugins for grafana
admin Grafana admin commands
cue Cue validation commands
help, h Shows a list of commands or help for one command

GLOBAL OPTIONS:
--pluginsDir value Path to the Grafana plugin directory (default: "/var/lib/grafana/plugins") [$GF_PLUGIN_DIR]
--repo value URL to the plugin repository (default: "https://grafana.com/api/plugins") [$GF_PLUGIN_REPO]
--pluginUrl value Full url to the plugin zip file instead of downloading the plugin from grafana.com/api [$GF_PLUGIN_URL]
--insecure Skip TLS verification (insecure) (default: false)
--debug Enable debug logging (default: false)
--configOverrides value Configuration options to override defaults as a string. e.g. cfg:default.paths.log=/dev/null
--homepath value Path to Grafana install/home path, defaults to working directory
--config value Path to config file
--help, -h show help (default: false)
--version, -v print the version (default: false)

API

Grafana API 采用 REST API 2.0 规范。