Please run down the following list and make sure you've tried the usual "quick

fixes":

- Search the issues on our "catch-all" repository: https://github.com/GoogleCloudPlatform/google-cloud-node

- Search StackOverflow: http://stackoverflow.com/questions/tagged/google-cloud-platform+node.js

Once your application is running (deployed, or elsewhere), you should be able to use the [Debug UI][debug-tab] in your Cloud [developer console][dev-console]. You can find the Debug UI in the 'STACKDRIVER -> Debug' section in the navigation panel, or by simply searching for 'Debug' in the cloud console.

If your source is hosted in a [cloud source repository](https://cloud.google.com/tools/cloud-repositories/docs/), Stackdriver Debugger will display the source code of your application automatically. Alternatively, you can also point the debugger to local files, a GitHub or Bitbucket repository, through a Source Capture, or you can simply type in a filename and line number. More details are on source options are [available here](https://cloud.google.com/debugger/docs/source-options).

If you have the source available, you can set a snapshot by clicking in the gutter (line number area). Once you set a snapshot, the debug agent will insert a momentary breakpoint at the code location in the running instances of the application.

As soon as that line of code is reached in any of the running instances of your application, the stack traces, local variables, and watch expressions are captured, and your application continues.

**Note:** The directory layout of the code that is being debugged does not have to exactly match the source code specified in the Debug UI. This is because the debug agent resolves a snapshot filename by searching for a file with the longest matching path suffix. If a unique match is found, that file will be used to set the snapshot.

[debugger-roles]: https://cloud.google.com/debugger/docs/iam#roles

[npm-image]: https://img.shields.io/npm/v/@google-cloud/debug-agent.svg

[npm-url]: https://npmjs.org/package/@google-cloud/debug-agent

[debugger-api]: https://console.cloud.google.com/apis/api/clouddebugger.googleapis.com/overview

"description": "Stackdriver Debug Agent for Node.js",

"main": "./build/src/index",

"types": "./build/src/index.d.ts",

"keywords": [

"google",

"debugger",

{

"license": "Apache-2.0",

"author": "Google LLC",

"engines": {

"node": ">=8"

},

"private": true,

"scripts": {

"test": "mocha system-test"

// FIXME(ofrobots): We need our own copy of options because Service may

// default to '{{projectId}}' when options doesn't contain the `projectId`.

// property. This breaks the SSOT principle. Remove this when

// is resolved.

this.options = options;

it('should not throw if vm is not an object', () => {

// test for

const inject = require('require-inject');

const state = inject('../src/agent/state/legacy-state', {vm: false});

assert.ok(state);