mirror of
https://github.com/strapi/strapi.git
synced 2025-07-23 17:10:08 +00:00
96 lines
2.1 KiB
Markdown
Executable File
96 lines
2.1 KiB
Markdown
Executable File
# Logging
|
|
|
|
Strapi comes with a simple and useful built-in logger.
|
|
Its usage is purposely very similar to `console.log()`, but with a handful of
|
|
extra features; namely support for multiple log levels with colorized,
|
|
prefixed console output.
|
|
|
|
The logger is accessible through the `strapi` object directly with `strapi.log`.
|
|
|
|
You can work with this logger in the same way that you work with the default logger:
|
|
|
|
```js
|
|
strapi.log.info('Logs work!');
|
|
```
|
|
|
|
## Logging with Metadata
|
|
|
|
In addition to logging string messages, the logger will also optionally log additional
|
|
JSON metadata objects. Adding metadata is simple:
|
|
|
|
```js
|
|
strapi.log.info('Test log message', {
|
|
anything: 'This is metadata'
|
|
});
|
|
```
|
|
|
|
## String interpolation
|
|
|
|
The log method provides the same string interpolation methods like `util.format`.
|
|
|
|
This allows for the following log messages.
|
|
|
|
```js
|
|
strapi.log.info('test message %s', 'my string');
|
|
// => info: test message my string
|
|
```
|
|
|
|
```js
|
|
strapi.log.info('test message %d', 123);
|
|
// => info: test message 123
|
|
```
|
|
|
|
```js
|
|
strapi.log.info('test message %j', {
|
|
number: 123
|
|
}, {});
|
|
// => info: test message {"number":123}
|
|
// => meta = {}
|
|
```
|
|
|
|
```js
|
|
strapi.log.info('test message %s, %s', 'first', 'second', {
|
|
number: 123
|
|
});
|
|
// => info: test message first, second
|
|
// => meta = {number: 123}
|
|
```
|
|
|
|
```js
|
|
strapi.log.info('test message', 'first', 'second', {
|
|
number: 123
|
|
});
|
|
// => info: test message first second
|
|
// => meta = {number: 123}
|
|
```
|
|
|
|
```js
|
|
strapi.log.info('test message %s, %s', 'first', 'second', {
|
|
number: 123
|
|
}, function() {});
|
|
// => info: test message first, second
|
|
// => meta = {number: 123}
|
|
// => callback = function() {}
|
|
```
|
|
|
|
```js
|
|
strapi.log.info('test message', 'first', 'second', {
|
|
number: 123
|
|
}, function() {});
|
|
// => info: test message first second
|
|
// => meta = {number: 123}
|
|
// => callback = function() {}
|
|
```
|
|
|
|
## Logging levels
|
|
|
|
Setting the level for your logging message can be accomplished by using
|
|
the level specified methods defined.
|
|
|
|
```js
|
|
strapi.log.debug('This is a debug log');
|
|
strapi.log.info('This is an info log');
|
|
strapi.log.warn('This is a warning log');
|
|
strapi.log.error('This is an error log ');
|
|
```
|