Jira Server でメールのデバッグ モードを有効化する
目的
Jira で受信メールと送信メールの両方でデバッグ モードを有効化する方法について説明します。
ソリューション
Administration (Gear next to profile) > System > Logging and Profiling
ページに移動します。- これは、「g+g」と入力してポップアップに「
Logging and Profiling
」と入力することでもアクセスできます。
- これは、「g+g」と入力してポップアップに「
- 送信メールの場合
- 送信メール セクションまでページをスクロールします。
- Ensure that you have an Outgoing Mail configured and that Outgoing Mail log is enabled as without it, debugging cannot be enabled through the UI.
- このセクションに表示される青い
Enable
リンクをクリックして、送信メールのデバッグを有効化します。 - Jira の再起動後もデバッグ ログを引き続き有効化するには、次の手順を実行します。
<jira-installation>/atlassian-jira/WEB-INF/classes/
log4j.properties
ファイルを編集します。以下の部分に移動します。
log4j.logger.com.atlassian.mail = INFO, outgoingmaillog
INFO
をDEBUG
に変更します。- For Jira 9.5 and above the configuration file that will need to be updated is named log4j2.xml and the syntax for adding the debug logging has changed.
- Edit the
<jira-installation>/atlassian-jira/WEB-INF/classes/
log4j2.xml file
Add the content below just before the closing "<Loggers>" tag.
<Logger name="com.atlassian.mail.outgoing" level="DEBUG" additivity="false"> <AppenderRef ref="outgoingmaillog"/> </Logger>
- For batch notifications specifically, set the
package
com.atlassian.jira.plugins.inform.batching
to DEBUG
- 受信メールの場合
- 受信メール セクションまでページをスクロールします。
- Ensure that you have an Incoming Mail configured and that Incoming Mail log is enabled as without it, debugging cannot be enabled through the UI.
- このセクションに表示される青い
Enable
リンクをクリックして、受信メールのデバッグを有効化します。 - Jira の再起動後もデバッグ ログを引き続き有効化するには、次の手順を実行します。
<jira-installation>/atlassian-jira/WEB-INF/classes/
log4j.properties
ファイルを編集します。以下の部分に移動します。
log4j.logger.com.atlassian.mail.incoming = INFO, incomingmaillog
INFO
をDEBUG
に変更します。- For Jira 9.5 and above the configuration file that will need to be updated is named log4j2.xml and the syntax for adding the debug logging has changed.
- Edit the
<jira-installation>/atlassian-jira/WEB-INF/classes/
log4j2.xml file
Add the content below just before the closing "<Loggers>" tag.
<Logger name="com.atlassian.mail.incoming" level="DEBUG" additivity="false"> <AppenderRef ref="incomingmaillog"/> </Logger>
受信および送信でのメールのログをプロトコル レベル (より詳細) で有効化したい場合は、Jira の起動パラメーターに
-Dmail.debug=true
を追加します。
このテーマの詳細については「ログとプロファイリング」をご確認ください。
デバッグ ログの主な目的はトラブルシューティングです。エントリが多すぎることによるパフォーマンスやログへの潜在的な影響を防ぐため、問題が解決したらデバッグ ログを無効化することをおすすめします。
最終更新日: 2024 年 2 月 12 日
Powered by Confluence and Scroll Viewport.