Monitor

Monitor middleware for Fiber that reports server metrics, inspired by express-status-monitor

caution

Monitor is still in beta, API might change in the future!

Signatures

func New() fiber.Handler

Examples

Import the middleware package and assign it to a route.

package main

import (
    "log"

    "github.com/gofiber/fiber/v2"
    "github.com/gofiber/fiber/v2/middleware/monitor"
)

func main() {
    app := fiber.New()

    app.Get("/metrics", monitor.New(monitor.Config{Title: "MyService Metrics Page"}))

    log.Fatal(app.Listen(":3000"))
}

You can also access the API endpoint with curl -X GET -H "Accept: application/json" http://localhost:3000/metrics which returns:

{"pid":{ "cpu":0.4568381746582226, "ram":20516864,   "conns":3 },
 "os": { "cpu":8.759124087593099,  "ram":3997155328, "conns":44,
    "total_ram":8245489664, "load_avg":0.51 }}

Config

// Config defines the config for middleware.
type Config struct {
    // Metrics page title
    //
    // Optional. Default: "Fiber Monitor"
    Title string

    // Refresh period
    //
    // Optional. Default: 3 seconds
    Refresh time.Duration

    // Whether the service should expose only the monitoring API.
    //
    // Optional. Default: false
    APIOnly bool

    // Next defines a function to skip this middleware when returned true.
    //
    // Optional. Default: nil
    Next func(c *fiber.Ctx) bool

    // Custom HTML Code to Head Section(Before End)
    //
    // Optional. Default: empty
    CustomHead string

    // FontURL for specify font resource path or URL . also you can use relative path
    //
    // Optional. Default: https://fonts.googleapis.com/css2?family=Roboto:wght@400;900&display=swap

    FontURL string
    // ChartJsURL for specify ChartJS library  path or URL . also you can use relative path
    //
    // Optional. Default: https://cdn.jsdelivr.net/npm/chart.js@2.9/dist/Chart.bundle.min.js

    ChartJsURL string

}

Default Config

var ConfigDefault = Config{
    Title:   "Fiber Monitor",
    Refresh: 3 * time.Second,
    APIOnly: false,
    Next:    nil,
    CustomHead:"",
    FontURL:"https://fonts.googleapis.com/css2?family=Roboto:wght@400;900&display=swap",
    ChartJsURL:"https://cdn.jsdelivr.net/npm/chart.js@2.9/dist/Chart.bundle.min.js"

}