heroku-dyno-metadata

Access Heroku Dyno metadata in Node.js and expose them as HTTP headers.

Install

# Using npm
npm install heroku-dyno-metadata

# Using yarn
yarn add heroku-dyno-metadata

Dyno Metadata is an Heroku Labs feature at the moment and have to be enabled this way:

heroku labs:enable runtime-dyno-metadata -a <app name>

Usage with Express 4.x

import express from 'express';
import { middleware as herokuDynoMetadata } from 'heroku-dyno-metadata';

const app = express().use(herokuDynoMetadata());

// Responses will have the following example headers:
//
// X-Heroku-App-Id: 2d9a4aaf-1023-4520-8ed1-d6fda6fd86d6
// X-Heroku-App-Name: heroku-dyno-metadata
// X-Heroku-Dyno-Id: d1576980-3f3e-4593-b7b9-6c2fbf874e07
// X-Heroku-Dyno-Name: web.1
// X-Heroku-Slug-Commit: cbdae5a0cd1f5a0f0a67b3d82844ceb33d0caed7
// X-Heroku-Slug-Description: Deploy cbdae5a
// X-Heroku-Release-Created-at: 2016-04-08T06:39:53Z
// X-Heroku-Release-Version: v832

API

metadata

metadata

• This function is exposed as the default export.

• Use import metadata from 'heroku-dyno-metadata' or require('heroku-dyno-metadata').

• Returns an object containing Heroku Dyno metadata, keys are camel-cased.

• Example:

  console.log(metadata.dynoName);
  // "web.1"

middleware

middleware([keys])

• Use import { middleware } from 'heroku-dyno-metadata' or require('heroku-dyno-metadata').middleware.

• Returns an Express middleware.

• The optional keys argument allows picking headers exposed. Default is all headers available (listed below).

• Example:

  middleware(['x-heroku-app-id', 'x-heroku-dyno-id']);

Available headers

| Header | Description | Example | | --------------------------- | ------------------------------------------ | ------------------------------------------ | | x-heroku-app-id | The unique identifier for the application | 9daa2797-e49b-4624-932f-ec3f9688e3da | | x-heroku-app-name | The application name | example-app | | x-heroku-dyno-id | The dyno identifier | 1vac4117-c29f-4312-521e-ba4d8638c1ac | | x-heroku-dyno-name | The dyno name | web.1 | | x-heroku-slug-commit | The commit hash for current release | 2c3a0b24069af49b3de35b8e8c26765c1dba9ff0 | | x-heroku-slug-description | The commit description for current release | Deploy 2c3a0b2 | | x-heroku-release-created-at | The time and date the release was created | 2015/04/02 18:00:42 | | x-heroku-release-version | The version of current release | v42 |

More information: Heroku Labs: Dyno Metadata

License

MIT © Gowento