Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

MONITORING YOUR LRS

PM2 / KEYMETRICS

If you have installed Learning Locker using the recommended build script, then the application will come pre-installed onto an instance of the excellent pm2 Node Process Management tool.

Whilst this tool can be used to monitor the running processes from within each server running LL (refer to the documentation), it can also be setup to send performance metrics to the Key Metrics platform (costs may apply).

...

LOGS

LOCAL

By default logs are captured by pm2 and stored locally on each instance as defined in the pm2 process file (pm2/all.json.dist). Errors and standard output are separated and can be viewed by running pm2 logs from within your instance. By default they are stored in /var/log/learninglocker/ and are rotated using the pm2-logrotate module.

...

AWS CLOUDWATCH

Learning Locker comes with the ability to push your logs to AWS Cloudwatch. To enable this, configure the relevant part of the .env files:

...

Please note that the AWS credentials must have the required permissions to create and push to log streams/groups.

...

OTHER LOGGING

Learning Locker handles all logging via Winston. New “transports” can be added and configured in both the Learning Locker application and xAPI services.

NEW RELIC

The Learning Locker application is configured to send performance metrics to New Relic. Simply fill in the following in the .env of your application instance

Code Block
#############
# New Relic #
#############

# New Relic License key
NEW_RELIC_LICENSE_KEY=
# APM name for API
NEWRELIC_API_NAME=
# APM name for UI
NEWRELIC_UI_NAME=

XAPI

In the xAPI you can also add monitoring.

Code Block
# New Relic License key
NEW_RELIC_LICENSE_KEY=
# APM name
NEW_RELIC_APP_NAME=

...

OTHERS

Other Node monitoring solutions are available but would need to be added manually to the script or web server.