Red Hat Summit第3章 レポートの確認
以下のセクションに示すレポート例は、MTA GitHub ソースリポジトリーにある jee-example-app-1.0.0.ear サンプルアプリケーションの com.acme および org.apache パッケージを分析した結果です。
以下のコマンドを使用してレポートが生成されました。
RHAMT_HOME/bin/rhamt-cli --input /home/username/rhamt-cli-source/test-files/jee-example-app-1.0.0.ear/ --output /home/username/rhamt-cli-reports/jee-example-app-1.0.0.ear-report --target eap:6 --packages com.acme org.apache
$ RHAMT_HOME/bin/rhamt-cli --input /home/username/rhamt-cli-source/test-files/jee-example-app-1.0.0.ear/ --output /home/username/rhamt-cli-reports/jee-example-app-1.0.0.ear-report --target eap:6 --packages com.acme org.apache
ブラウザーを使用して、レポート出力ディレクトリーにある index.html ファイルを開きます。これにより、処理されたアプリケーションの一覧が表示されます。各行には、ストーリーポイント、インシデントの数、アプリケーションで発生したテクノロジーの概要が含まれます。
図3.1 アプリケーションリスト
新しいルールが MTA に追加されると、インシデントと予測されるストーリーポイントが変わります。この値は、このアプリケーションをテストする際に表示される値と一致しない場合があります。
以下の表は、このメインの MTA ランディングページからアクセスできるレポートおよびページの一覧です。アプリケーションの名前 jee-example-app-1.0.0.ear をクリックして、アプリケーションレポート を表示します。
| ページ | アクセス方法 |
|---|---|
| アプリケーションの名前をクリックします。 | |
|
ページ上部の | |
| 複数のアプリケーションで共有される アーカイブリンクをクリックします。このリンクは、複数のアプリケーションに共有アーカイブがある場合にのみ利用できることに注意してください。 | |
| ページ下部の Rule providers execution overview リンクをクリックします。 | |
| ページの下部に ある FreeMarker メソッド リンクをクリックします。 | |
| 上部ナビゲーションバーの Send Feedback リンクをクリックして、MTA チームにフィードバックを送信できるフォームを開きます。 |
アプリケーションが、他の分析済みアプリケーションとアーカイブを共有している場合は、共有アーカイブからのストーリーポイントの数と、このアプリケーションに固有のストーリーポイントの数が表示されることに注意してください。
図3.2 共有アーカイブ
アプリケーション間で共有 されるアーカイブに関する情報は、「複数アプリケーション間で共有されるアーカイブ」を参照し てください。
3.1. アプリケーションレポート
3.1.1. Dashboard
アプリケーションのリスト でアプリケーション名をクリックして、レポートランディングページからこのレポートにアクセスします。
ダッシュボードでは、アプリケーションの移行作業全体の概要が表示されます。つまり、以下のようになります。
- カテゴリー別のインシデントおよびストーリーポイント
- 提案された変更の作業レベル別のインシデントおよびストーリーポイント
- パッケージ別のインシデント
図3.3 ダッシュボード
上部のナビゲーションバーには、このアプリケーションの移行に関する追加の詳細を含むさまざまなレポートが一覧表示されます。現在のアプリケーションに適用可能なレポートのみが利用できることに注意してください。
| レポート | 説明 |
|---|---|
| Issues | 注意が必要なすべての問題の簡潔な概要を提供します。 |
| Application Details | 移行時に注意する必要がある可能性のあるアプリケーション内で見つかったすべてのリソースの詳細を説明します。 |
| Technologies | 機能を基にグループ化されたすべての埋め込みライブラリーを表示します。これにより、各アプリケーションで使用されるテクノロジーを迅速に表示できます。 |
| Unparsable |
は、MTA が想定される形式で解析できなかったすべてのファイルを示しています。たとえば、 |
| Dependencies | アプリケーション内にある Java パッケージの依存関係をすべて表示します。 |
| Remote Services | アプリケーション内で見つかったすべてのリモートサービス参照を表示します。 |
| EJB | アプリケーション内の EJB のリストが含まれます。 |
| JBPM | 分析中に見つかった JBPM 関連のリソースすべてが含まれます。 |
| JPA | アプリケーションで見つかったすべての JPA 関連リソースの詳細が含まれます。 |
| Hibernate | アプリケーションで検出されたすべての Hibernate 関連リソースの詳細が含まれています。 |
| Server Resources | 入力アプリケーションですべてのサーバーリソース (JNDI リソースなど) を表示します。 |
| Spring Beans | 分析中に見つかった Spring Bean のリストが含まれます。 |
| ハードコーディングされた IP アドレス | アプリケーションで見つかったすべてのハードコーディングされた IP アドレスの一覧を提供します。 |
| Ignored Files |
特定のルールおよび MTA 設定に基づいてアプリケーションに含まれるファイルを一覧表示し、処理されませんでした。詳細は、 |
| About | 現在のバージョンの MTA を説明し、詳細なヘルプリンクを提供します。 |
3.1.2. アプリケーションの詳細レポート
Application Details リンクをクリックして、ダッシュボードからこのレポートにアクセスします。
レポートには、ストーリーポイント、パッケージごとの Java インシデント、およびアプリケーションで見つかったテクノロジーの発生回数が記載されます。以下は、移行プロセス中に生成されたアプリケーションメッセージの表示です。最後に、プロセス中に分析される各アーカイブにこの情報の内訳が表示されます。
図3.4 アプリケーションの詳細レポート
を展開 jee-example-app-1.0.0.ear/jee-example-services.jar して、ストーリーポイント、パッケージによる Java インシデント、およびこのアーカイブで見つかったテクノロジーの数を確認します。この概要は、移行に割り当てられたストーリーポイントの合計で始まり、アーカイブ内の各ファイルに必要な変更の詳細を示す表が続きます。レポートには以下のコラムが含まれます。
| 列名 | 説明 |
|---|---|
| Name | 分析されるファイルの名前。 |
| Technology | 分析するファイルのタイプ (例: Decompiled Java File または Properties)。 |
| Issues | レビューまたは変更が必要なコードのエリアに関する警告。 |
| Story Points | ファイルの移行に必要な作業レベル。詳細は、「 ルールのポイント 」を参照してください。 |
アーカイブがアプリケーションで複数回複製されると、そのアーカイブはレポートに 1 回だけ一覧表示され、でタグ付けされ [Included Multiple Times]ます。
図3.5 アプリケーションでのアーカイブの複製
アプリケーション内で重複するアーカイブのストーリーポイントは、そのアプリケーションの合計ストーリーポイント数に 1 回だけカウントされます。
3.1.3. アプリケーションテクノロジーレポート
Technologies リンクをクリックして、ダッシュボードからこのレポートにアクセスします。
レポートには、解析されたアプリケーションで機能別にグループ化されたテクノロジーが一覧表示されます。これは、アプリケーションに含まれるテクノロジーの概要であり、各アプリケーションの目的を素早く理解できるように設計されています。
以下の図は、で使用される技術を示してい jee-example-appます。
図3.6 アプリケーションにおけるテクノロジー
3.1.4. ソースレポート
JAR のファイル jee-example-services.jar の分析と、警告およびストーリーはそれぞれに割り当てられます。このテスト時に com.acme.anvil.listener.AnvilWebLifecycleListener ファイルには 22 の警告があり、16 ストーリーポイントが割り当てられている点に注意してください。ファイルリンクをクリックして詳細を表示します。
- Information セクションは、ストーリーポイントの概要を説明します。
- ファイルのソースコードが続きます。移行が必要な時点でファイルに警告が表示されます。
この例では、警告がさまざまなインポートステートメント、宣言、およびメソッド呼び出しに表示されます。各警告は、問題と実行すべきアクションを記述します。
図3.7 ソースレポート
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}