Introduction¶

Installation¶

Install the package:
```
pip install django-logging-endpoint
```
Install the application by adding it to the INSTALLED_APPS setting:
```
INSTALLED_APPS += ('logging_endpoint',)
```
Set the logger name, if you want to send the messages to a specific one:
```
LOGGING_ENDPOINT_LOGGER = 'LoggingEndpoint'
```
Set the log message handler function, if you want to customize the parsing of your log messages:
```
LOGGING_ENDPOINT_MESSAGE_HANDLER = 'logging_endpoint.message_handler.default_handler'
```

Add the url to your urls.py:

from django.conf.urls import include

urlpatterns += url(r'^logs', include('logging_endpoint.urls'))

Endpoints¶

root¶

The root endpoint of django-logging-endpoint receives a json message with the logs to be sent to the configured logger:

{
    'message':   'my log message',
    'logger':    'user interaction',
    'loglevel':  'error',
    'timestamp': '2020-01-01T12:00Z'
}

By default, a list of logs can be received and will be expanded to the Django logger. See the documentation’s settings chapter for more information on that.