moniteur

moniteur

Monitor your asset size over time, in your browser, or using the provided HTTP API.

Demo: collecting data every 12 hours.

This is my first Node app, I know it is messy and it still lacks tests.

More features to come: see roadmap.

Installation

npm install -g moniteur

Usage:

Usage: moniteur [options] [command]

Commands:

  record   grab a snapshot of all asset metrics
  serve    see assets sensor graphs in the browser

Options:

  -h, --help           output usage information
  -V, --version        output the version number
  -c, --config [path]  specify a configuration file

Create a moniteur.json file in the directory where asset sizes should be stored (typically: the root directory of your project):

{
  "assets": {
    "My main CSS": "public/stylesheets/main.css",
    "My bundle of CSS files": [
      "core.css",
      "head.css",
      "index.css",
      "global.css"
    ],
    "Remote stylesheet": "http://path/to/styles.css",
    "Remote JavaScript": "http://path/to/styles.js",
    "Single JavaScript file": "public/javascripts/app.js",
    "Bundle of JavaScript files": [
      "module-a.js",
      "module-b.js",
      "module-c.js",
      "dependency.js"
    ]
  }
}

Note: moniteur will load moniteur.json file in your home directory or the current directory.

Database configuration

Moniteur relies on the NODE_ENV environment variable to select a database:

{
  "assets": {
    // Stylesheets, scripts…
  },
  "db": {
    "development": {
      "engine": "filesystem",
      "directory": ".moniteur"
    },
    "production": {
      "engine": "redis",
      "url": "redis://localhost:6379"
    }
  }
}

For now, two types of storage are supported: Redis and local filesystem.

Confidential Redis URL

A confidential Redis URL can be passed through an environment variable, instead of having it stored in the configuration file:

DB_URL=redis://rediscloud:[e-mail]:13714

Run your application like this:

DB_URL=redis://url moniteur [options]

Development

Clone the repository and run:

npm run dev

Asset monitor API

Record data

Takes a snapshot of asset metrics and stores them in the .moniteur/ directory.

moniteur record --config ../test/fixtures/test-config.json

HTTP API

View current configuration

/config

JSON data object for HighCharts (providing the asset name's hash)

Since forever: /metrics/stylesheets/adf6e9c154cb57a818f7fb407085bff6

Between two dates: /metrics/stylesheets/adf6e9c154cb57a818f7fb407085bff6/1015711104475..1415711104475

License

MIT

Acknowledgments: "merci" to https://github.com/t32k/stylestats, which has been a great source of inspiration.

Roadmap

• Make moniteur a working node module
• Run as some sort of daemon that monitors asset metrics every X seconds
• Monitor JavaScript files
• Unit / Integration tests
• Option to filter graphs by time ranges (last 7 days, last 30 days, last year)
• [-] Providing a page's URL, scrape all assets out of it and analyse them
• [-] Parse all assets in a particular directory

Ideas

• moniteur init, a moniteur.json configuration file generator, with interactive menus
• Asset size budget limits
• Email alert when budget is almost reached or exceeded
• Weekly email recaps
• UA switch to fetch remote assets for mobile/tablet/desktop