Enable debug logging
This page describes how to enable various types of debug-level logging in Bitbucket Data Center and Server.
Logs can be found in <Bitbucket home directory>/log.
On this page
Debug logging for your instance
This section describes how to enable debug level logging in Bitbucket.
UI 経由でデバッグ ログ作成を有効化する
To enable debug logging:
- Go to the
> Logging and Profiling. - Select Enable debug logging.
起動時にデバッグ ログ作成を有効化する
To enable debug logging whenever Bitbucket. is started, edit the <Bitbucket home directory>/shared/bitbucket.properties file (if this file doesn't exist then you should create it) and add these two lines:
logging.logger.ROOT=DEBUG
logging.logger.com.atlassian.bitbucket=DEBUGIf your instance is earlier than version 3.2, the bitbucket.properties file is at the top level of your home directory.
実行中にデバッグ ログ作成を有効にする
To enable debug logging for the root logger once Bitbucket. has been started, run these two commands in your terminal:
curl -u <ADMIN_USERNAME> -v -X PUT -d "" -H "Content-Type: application/json" <BASE_URL>/rest/api/latest/logs/rootLogger/debug
curl -u <ADMIN_USERNAME> -v -X PUT -d "" -H "Content-Type: application/json" <BASE_URL>/rest/api/latest/logs/logger/com.atlassian.bitbucket/debug
# e.g.
curl -u admin -v -X PUT -d "" -H "Content-Type: application/json" http://localhost:7990/rest/api/latest/logs/rootLogger/debug
curl -u admin -v -X PUT -d "" -H "Content-Type: application/json" http://localhost:7990/rest/api/latest/logs/logger/com.atlassian.bitbucket/debug特定のロガーに対するデバッグ ログ作成を有効にするには、ターミナルで次のコマンドを実行します。
curl -u <ADMIN_USERNAME> -v -X PUT -d "" -H "Content-Type: application/json" <BASE_URL>/rest/api/latest/logs/logger/<LOGGER_NAME>/debug
# e.g. embedded Crowd debug log
curl -u admin -v -X PUT -d "" -H "Content-Type: application/json" http://localhost:7990/rest/api/latest/logs/logger/com.atlassian.crowd/debug
# e.g. LDAP debug log
curl -u admin -v -X PUT -d "" -H "Content-Type: application/json" http://localhost:7990/rest/api/latest/logs/logger/com.atlassian.crowd.directory.SpringLDAPConnector/DEBUG
# e.g. email debug log
curl -u admin -v -X PUT -d "" -H "Content-Type: application/json" http://localhost:7990/rest/api/latest/logs/logger/bitbucket.mail-log/debugProfiling logging for your instance
This section describes how to enable profiling in Bitbucket. This log is essential when troubleshooting performance issues.
UI からプロファイルのログ作成を有効化する
To enable profiling:
- Go to the > Logging and Profiling.
- Select Enable profiling.
クライアントでの Git オペレーションのデバッグ ログ作成
Atlassian Support might request debug logs for Git operations (on the client) when troubleshooting issues. You can enable debug logging on the Git client by setting the following variables. If you are using HTTP/S, remove the Authorization header from the output, as it contains your Basic-Auth information. Atlassian provides a set of scripts that simplify the collection of Git client debug information.
Linux の場合
Git コマンドを実行する前に、コマンド ラインで以下を実行します。
export GIT_TRACE_PACKET=1
export GIT_TRACE=1
export GIT_CURL_VERBOSE=1To measure the length of time a command takes to complete, use the time utility/command prior to the actual git command. For example, to test a push to branch "master":
time git push origin masterWindows の場合
Git コマンドを実行する前に、コマンド ラインで以下を実行します。
set GIT_TRACE_PACKET=1
set GIT_TRACE=1
set GIT_CURL_VERBOSE=1Setting GIT_CURL_VERBOSE is only useful for connections over HTTP/S since SSH doesn't use the libcurl library.
Debug logging for your Backup Client
アトラシアン サポートでは問題のトラブルシューティングを行う際に、Backup クライアントのデバッグ ログを依頼する場合があります。
To enable debug logging for the Backup client, add a file named logback.xml to your working directory (pwd) with the following content:
<included><logger name="com.atlassian.bitbucket" level="DEBUG"/></included>