@gitterhq/env
Gitter Base Environment Module
Last updated 5 months ago by viktomas .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @gitterhq/env 
SYNC missed versions from official npm registry.

gitter-env

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

Logging

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)

Configuration

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)

Statistics

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

Middlewares

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

Current Tags

  • 0.43.0                                ...           latest (5 months ago)

20 Versions

  • 0.43.0                                ...           5 months ago
  • 0.42.0                                ...           6 months ago
  • 0.41.0                                ...           10 months ago
  • 0.40.1                                ...           a year ago
  • 0.40.0                                ...           a year ago
  • 0.39.0                                ...           2 years ago
  • 0.38.0                                ...           2 years ago
  • 0.37.0                                ...           2 years ago
  • 0.36.0                                ...           2 years ago
  • 0.35.0                                ...           2 years ago
  • 0.34.0                                ...           2 years ago
  • 0.33.0                                ...           3 years ago
  • 0.32.0                                ...           3 years ago
  • 0.31.1                                ...           3 years ago
  • 0.31.0                                ...           3 years ago
  • 0.30.0                                ...           3 years ago
  • 0.29.4                                ...           3 years ago
  • 0.29.3                                ...           3 years ago
  • 0.29.2                                ...           3 years ago
  • 0.29.1                                ...           3 years ago
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 22
Dependencies (25)
Dev Dependencies (9)
Dependents (1)

Copyright 2014 - 2016 © taobao.org |