Setting debug strings

You can specify debug strings when you run an application, as explained below, to display specific log output to the console. You can also redirect the output to a file, if desired. These techniques are often helpful in debugging applications.

Using debug strings

LoopBack has a number of built-in debug strings to help with debugging. Specify a string on the command-line via an environment variable as follows:

MacOS and Linux

$ DEBUG=<pattern>[,<pattern>...] npm start

Windows

C:\> set DEBUG=<pattern>[,<pattern>...]
C:\> npm start

where <pattern> is a string-matching pattern specifying debug strings to match. You can specify as many matching patterns as you wish.

For example (MacOS and Linux):

$ DEBUG=loopback:datasource npm start

Or, on Windows:

C:\> set DEBUG=loopback:datasource
C:\> npm start

You’ll see output such as (truncated for brevity):

loopback:datasource Settings: {"name":"db","debug":true} -0ms
loopback:datasource Settings: {"name":"geo","connector":"rest",...

You can use an asterisk  (*) in the pattern to match any string. For example the following would match any debug string containing “oracle”:

$ DEBUG=*oracle npm start

You can also exclude specific debuggers by prefixing them with a “-“ character. For example, DEBUG=*,-rest-crud:* would include all debuggers except those starting with “rest-crud:”.

Debug string format

These strings have the format

module[:area]:string

Where:

• module is the name of the module, for example loopback or loopback-connector-mongodb.
• area is an optional identifier such as cli or repository to identify the purpose of the module
• string is the debug string specified in the target TypeScript/JavaScript source file, such as application.ts.

For example:

loopback:cli:model-generator

The debug string model-generator is specified in the source file generators/model/index.js of the @loopback/cli module.

Debug strings reference