Enable mail debugging mode in Jira Data Center

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

目的

To detail clearly how to enable debug mode for both the incoming and outgoing emails in Jira.

ソリューション

  • Administration (Gear next to profile) > System > Logging and Profiling ページに移動します。
    • これは、「g+g」と入力してポップアップに「Logging and Profiling」と入力することでもアクセスできます。
  • 送信メールの場合
    • 送信メール セクションまでページをスクロールします。
    • 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.
      (info) If you are only using Jira Service Management email, you need to add the package com.atlassian.mail as DEBUG
    • このセクションに表示される青い Enable リンクをクリックして、送信メールのデバッグを有効化します。
    • Jira の再起動後もデバッグ ログを引き続き有効化するには、次の手順を実行します。
      • <jira-installation>/atlassian-jira/WEB-INF/classes/log4j.properties ファイルを編集します。
      • 以下の部分に移動します。

        log4j.logger.com.atlassian.mail = INFO, outgoingmaillog

        INFODEBUG に変更します。

      • 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.
      (info) If you are only using Jira Service Management email, you need to add the package com.atlassian.mail.incoming as DEBUG
    • このセクションに表示される青い Enable リンクをクリックして、受信メールのデバッグを有効化します。
    • Jira の再起動後もデバッグ ログを引き続き有効化するには、次の手順を実行します。
      • <jira-installation>/atlassian-jira/WEB-INF/classes/log4j.properties ファイルを編集します。
      • 以下の部分に移動します。

        log4j.logger.com.atlassian.mail.incoming = INFO, incomingmaillog

        INFODEBUG に変更します。

      • 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 を追加します。


このテーマの詳細については「ログとプロファイリング」をご確認ください。

(info) デバッグ ログの主な目的はトラブルシューティングです。エントリが多すぎることによるパフォーマンスやログへの潜在的な影響を防ぐため、問題が解決したらデバッグ ログを無効化することをおすすめします。

最終更新日 2024 年 5 月 29 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.