# Global

##

### Type Definitions

#### logger

A logger backed by bunyan

The default log level is `info`, but you can change it by setting the `LOG_LEVEL` environment variable to `trace`, `debug`, `info`, `warn`, `error`, or `fatal`.

By default, logs are formatted for readability in development. If you intend to drain logs to a logging service, set `LOG_FORMAT=json`.

Note: All execptions reported with `logger.error` will be forwarded to sentry if the `SENTRY_DSN` environment variable is set.

Source:
  - logger.js, line 1

##### Example

    robot.log("This is an info message");
    robot.log.debug("…so is this");
    robot.log.trace("Now we're talking");
    robot.log.info("I thought you should know…");
    robot.log.warn("Woah there");
    robot.log.error("ETOOMANYLOGS");
    robot.log.fatal("Goodbye, cruel world!");

#### payload

A GitHub webhook event payload

Source:
  - robot.js, line 182