跳到主要内容

快速入门

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 规范。