This version of the SonarQube documentation is no longer maintained. It relates to a version of SonarQube that is not active.

See latest version
Start Free
8.9 | Instance administration | Server logs and system info

Server logs and system info

On this page

The System Info page is found at Administration > System. It gives you access to detailed information on the state of your SonarQube instance.

System info

You can browse details about your running instance on this page.

Download

Additionally, if you have a support contract, you might be asked by a support representative to send in your system info, which can be downloaded from the page Administration > System using the Download System Info button at the top.

Server ID

Your server ID can be obtained from this page by expanding the System section. If you're running a commercial instance, you can also find this value on the License page (Administration > Configuration > License Manager)

Logs

Server-side logging is controlled by properties set in <SONARQUBE_HOME>/conf/sonar.properties.

4 log files are created: one per SonarQube process.

Log level

The server-side log level can be customized via the sonar.log.level property. Supported values are:

  • INFO: the default
  • DEBUG: for advanced logs.
  • TRACE: show advanced logs and all SQL and ElasticSearch requests. TRACE level logging slows down the server environment, and should be used only for tracking web request performance problems.

Log level by process

The server-side log level can be adjusted more precisely for the 4 processes of SonarQube Server via the following property:

  • sonar.log.level.app: for the Main process of SonarQube (aka WrapperSimpleApp, the bootstrapper process starting the 3 others)
  • sonar.log.level.web: for the WebServer
  • sonar.log.level.ce: for the ComputeEngineServer
  • sonar.log.level.es: for the SearchServer

Log rotation

To control log rolling, use the sonar.log.rollingPolicy

  • time:[value]: for time-based rotation. For example, use time:yyyy-MM-dd for daily rotation, and time:yyyy-MM for monthly rotation.
  • size:[value]: for size-based rotation. For example, size:10MB.
  • none: for no rotation. Typically this would be used when logs are handled by an external system like logrotate.

sonar.log.maxFiles is the maximum number of files to keep. This property is ignored if sonar.log.rollingPolicy=none.

Wrapper Config

If SonarQube was started using the SonarQube wrapper (for example, by using the provided start.sh and stop.sh scripts), the log rotation of the main process (sonar.log) needs to be defined in the wrapper.conf.
By default, the wrapper will rotate the sonar.log file each day if there is new content to be logged.

The log rotation in the wrapper can be fine-tuned with the following properties:

  • wrapper.logfile.maxsize=value[m for mb, k for kb]
  • wrapper.logfile.maxfiles=value
  • wrapper.logfile.rollmode=DATE|SIZE

wrapper.logfile.maxsize and wrapper.logfile.maxfiles are only considered if wrapper.logfile.rollmode is set to SIZE.
For wrapper.logfile.rollmode=DATE to work properly, the file specified by the property wrapper.logfile needs to include a YYYYMMDD token.

UI access to logs and log levels

The System Info page gives you the ability to download your instance's current log files (log files rotate on a regular basis), and to tune the log level via controls at the top of the page. Changes made here are temporary, and last only until the next time the instance is restarted, at which point the level will be reset to the more permanent value set in <SONARQUBE_HOME>/conf/sonar.properties. Regardless, if you change your log level from INFO, but sure to change it back as soon as is practical; log files can get very large very quickly at lower log levels.

Total lines of code

The number of lines of code (for licensing purposes) in an instance can be found in the System section of the System Info page and on the License page (Administration > Configuration > License Manager) in commercial editions.

If you're on a commercial edition and using branch or PR analysis, rest assured that only lines from the single largest branch in a project are considered for licensing purposes. The lines of code in the rest of the branches are ignored.


Was this page helpful?

© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARLINT, SONARQUBE, SONARCLOUD, and CLEAN AS YOU CODE are trademarks of SonarSource SA.

Creative Commons License