Have ideas to improve npm?Join in the discussion! »


0.3.0 • Public • Published

Failure injection for Google Cloud Functions - failure-cloudfunctions


failure-cloudfunctions is a small Node module for injecting failure into Google Cloud Functions (https://cloud.google.com/functions/). It offers a simple failure injection wrapper for your Cloud Functions handler where you then can choose to inject failure by setting the failureMode to latency, exception, denylist, diskspace or statuscode. You control your failure injection using a secret in Secret Manager.

How to install

  1. Install failure-cloudfunctions module using NPM.
npm install failure-cloudfunctions
  1. Add the module to your Cloud Functions function code.
const failureCloudFunctions = require('failure-cloudfunctions')
  1. Wrap your handler.
exports.handler = failureCloudFunctions(async (req, res) => {
  1. Create a secret in Secret Manager.
{"isEnabled": false, "failureMode": "latency", "rate": 1, "minLatency": 100, "maxLatency": 400, "exceptionMsg": "Exception message!", "statusCode": 404, "diskSpace": 100, "denylist": ["storage.googleapis.com"]}
gcloud beta secrets create <your-secret-name> --replication-policy="automatic"
echo -n "{\"isEnabled\": false, \"failureMode\"\"latency\"\"rate\": 1, \"minLatency\": 100, \"maxLatency\": 400, \"exceptionMsg\"\"Exception message!\"\"statusCode\": 404, \"diskSpace\": 100, \"denylist\": [\"storage.googleapis.com\"]}" | gcloud beta secrets versions add <your-secret-name> --data-file=-
  1. Add environment variables to your Cloud Function with values from above.
  1. Give your Cloud Function access to your secret in Secret Manager.
gcloud beta secrets add-iam-policy-binding <your-secret-name> --role roles/secretmanager.secretAccessor --member serviceAccount:<your-gcp-project-id>@appspot.gserviceaccount.com
  1. Try it out!


Edit the values of your parameter in Secret Manager to use the failure injection module.

  • isEnabled: true means that failure is injected into your Cloud Function.
  • isEnabled: false means that the failure injection module is disabled and no failure is injected.
  • failureMode selects which failure you want to inject. The options are latency, exception, denylist, diskspace or statuscode as explained below.
  • rate controls the rate of failure. 1 means that failure is injected on all invocations and 0.5 that failure is injected on about half of all invocations.
  • minLatency and maxLatency is the span of latency in milliseconds injected into your function when failureMode is set to latency.
  • exceptionMsg is the message thrown with the exception created when failureMode is set to exception.
  • statusCode is the status code returned by your function when failureMode is set to statuscode.
  • diskSpace is size in MB of the file created in tmp when failureMode is set to diskspace.
  • denylist is an array of regular expressions, if a connection is made to a host matching one of the regular expressions it will be blocked.


In the subfolder example is a simple function which can be installed in Google Cloud and used for test.


Inspired by Yan Cui's articles on latency injection for Google Cloud Functions (https://hackernoon.com/chaos-engineering-and-aws-lambda-latency-injection-ddeb4ff8d983) and Adrian Hornsby's chaos injection library for Python (https://github.com/adhorn/aws-lambda-chaos-injection/).


2020-08-24 v0.3.0

  • Changed mitm mode from connect to connection for quicker enable/disable of failure injection.
  • Renamed block list failure injection to denylist (breaking change for that failure mode).
  • Updated dependencies.

2020-03-01 v0.2.1

  • Added permission info to documentation.
  • Fixed tmp path in library and example.

2020-03-01 v0.2.0

  • Fixed Secret Manager integration.
  • Added simple example.
  • Updated documentation.

2020-02-28 v0.0.1

  • Initial release


Gunnar Grosch - GitHub | Twitter | LinkedIn

Jason Barto - GitHub | Twitter | LinkedIn


npm i failure-cloudfunctions

DownloadsWeekly Downloads






Unpacked Size

8.55 kB

Total Files


Last publish


  • avatar