Jira Server でメールのデバッグ モードを有効化する

お困りですか?

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

コミュニティに質問

目的

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.
    • このセクションに表示される青い 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.
    • このセクションに表示される青い 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 年 2 月 12 日

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

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