Grafana Statusmap 插件使用教程

1. 项目的目录结构及介绍

Grafana Statusmap 插件的目录结构如下：

grafana-statusmap/
├── Dockerfile
├── README.md
├── docker-compose.yml
├── package.json
├── public/
│   ├── img/
│   ├── modules/
│   ├── partials/
│   ├── plugin.json
│   └── src/
├── src/
│   ├── components/
│   ├── module.ts
│   ├── plugin.ts
│   └── types.ts
└── tsconfig.json

目录结构介绍

• Dockerfile：用于构建 Docker 镜像的文件。
• README.md：项目说明文档。
• docker-compose.yml：用于启动 Docker 容器的配置文件。
• package.json：Node.js 项目的配置文件，包含依赖项和脚本。
• public/：插件的静态资源目录，包含图像、模块、部分视图和插件配置文件。
  • img/：图像文件。
  • modules/：模块文件。
  • partials/：部分视图文件。
  • plugin.json：插件的配置文件。
  • src/：源代码文件。
• src/：TypeScript 源代码目录。
  • components/：React 组件文件。
  • module.ts：模块入口文件。
  • plugin.ts：插件入口文件。
  • types.ts：类型定义文件。
• tsconfig.json：TypeScript 编译配置文件。

2. 项目的启动文件介绍

项目的启动文件主要是 docker-compose.yml 和 package.json 中的脚本。

docker-compose.yml

version: '3.7'
services:
  grafana:
    image: grafana/grafana:latest
    ports:
      - "3000:3000"
    volumes:
      - ./public:/var/lib/grafana/plugins/grafana-statusmap

package.json

{
  "name": "grafana-statusmap",
  "version": "0.5.1",
  "scripts": {
    "build": "grafana-toolkit plugin:build",
    "test": "grafana-toolkit plugin:test",
    "dev": "grafana-toolkit plugin:dev",
    "watch": "grafana-toolkit plugin:dev --watch"
  },
  "dependencies": {
    "@grafana/data": "latest",
    "@grafana/ui": "latest",
    "react": "16.13.1",
    "react-dom": "16.13.1"
  },
  "devDependencies": {
    "@grafana/toolkit": "latest",
    "@types/react": "16.9.35",
    "@types/react-dom": "16.9.8",
    "typescript": "3.8.3"
  }
}

启动步骤

1. 克隆项目到本地：

   git clone https://github.com/flant/grafana-statusmap.git
   

2. 进入项目目录：

   cd grafana-statusmap
   

3. 启动 Docker 容器：

   docker-compose up
   

4. 打开浏览器，访问 http://localhost:3000，即可看到 Grafana 界面，并加载 Statusmap 插件。

3. 项目的配置文件介绍

plugin.json

plugin.json 是 Grafana 插件的配置文件，位于 public/ 目录下。

{
  "type": "panel",
  "name": "Statusmap",
  "id": "flant-statusmap-panel",
  "info": {
    "description": "Statusmap panel for Grafana",
    "author": {
      "name": "Flant",
      "url": "https://flant.com"
    },
    "keywords": ["statusmap", "grafana", "panel"],
    "