Gitter Base Environment Module


0.47.0a year ago5 years agoMinified + gzip package size for @gitterhq/env in KB



Deploying your node app? Use this to:

  1. stop your app from crashing when redis fails over
  2. keep servers alive by rotating logs
  3. publish errors that wake people up in the night
  4. publish stats that help make decisions
  5. use different env configs so that you app can travel to new environments

Using gitter-env

Firstly you need to create a singleton instance inside your application. Call the module something like env. It will need to reference the location of the configuration files, like this:

var gitterEnv = require('gitter-env');
var path = require('path');

/* Create a singleton environment */
module.exports = gitterEnv.create(path.join(__dirname, '..', '..', 'config'));

Once you've got your env instance, here are some things you can do with it


env.logger looks a lot like winston. Use it for logging:

  • logger.verbose(message, meta)
  • logger.info(message, meta)
  • logger.warn(message, meta)
  • logger.error(message, meta)


env.conf looks a lot like nconf. Use it for configuration:

  • conf.get('some:variable')

Error Reporter

env.errorReporter will send your errors to sentry. Use it for logging serious problems:

  • errorReporter(err, { some: 'meta', information: 1 })

Redis Client

env.redis will provide you with a singleton instance of a redis client or a new instance. It will use Redis Sentinel it it's configured.

Example configuration:

  "redisDb": 1,
  "sentinel": {
    "master-name": "test-master",
    "hosts": ["localhost:46379"]
  clientOpts: {
    "return_buffers": true
  • env.redis.getClient() - returns the main singleton Redis client.
  • env.redis.createClient([options]) - returns a new Redis client. Uses redis config by default.
  • env.redis.quitClient() - closes a Redis client (don't do this with the main singleton client)


env.stats will send statistics to Datadog, Cube, and other places.

  • env.stats.event('name') - increment a counter
  • env.stats.eventHF('name', [count], [frequency]) - increment a high frequency counter
  • env.stats.gaugeHF('name', [value], [frequency]) - update a high frequency gauge
  • env.stats.responseTime('name', duration) - track a response time

Error Handling

  • env.installUncaughtExceptionHandler - will install a graceful shutdown handler on uncaught exceptions
  • env.domainWrap(function() { /* server */ }); - will do the same inside the function


  • env.middlewares.errorHandler - a basic error handling middleware
  • env.middlewares.accessLogger - access logging with response time stats

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.