Monitoring your OpenProject installation
Show logs
In a package-based installation, the openproject
command line tool can be
used to see the log information. The most typically use case is to show/follow
all current log entries. This can be accomplished using the the –tail
flag.
See example below:
sudo openproject logs --tail
Note:
- On distributions that are based on systemd, all the logs are sent to journald, so you can also display them via
journalctl
. - On older distributions that use either sysvinit or upstart, all the logs are stored in
/var/log/openproject/
.
In a docker-based installation, all logs are redirected to STDOUT so you can use the normal docker tools to manage your logs.
For instance for the Compose-based installation:
docker-compose logs -f --tail 1000
Or the all-in-one docker installation:
docker logs -f --tail 1000 openproject
Raising the log level
OpenProject can log at different service levels, the default being info
. You can set the environment variable OPENPROJECT_LOG__LEVEL
to any of the following values:
- debug, info, warn, error
For example, to set this in the packaged installation, use the following command:
openproject config:set OPENPROJECT_LOG__LEVEL="debug"
service openproject restart
For Docker-based installations, add the ENV variable to your env file and restart the containers.
Help and feedback
If you did not find what you were looking for
If you need help from the community or want to support others
If you are eligible for professional support and have more questions
REQUEST SUPPORT
If you find an easily fixable error or need for improvement in the documentation for the stable release
If you would like to suggest bigger updates or improvements to this documentation
If you want to contribute to translate this documentation to another language
If there's something you don't like or understand about this feature
If you want to propose a new feature that OpenProject does not offer yet
To further help OpenProject to shape and test new features
To view OpenProject premium features and pricing
If you want to try all premium features in the OpenProject Cloud Edition 14 days for free
If you want to try all premium features in your on premise Community installation 14 days for free