第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

Copy to Clipboard

ブラウザーを使用して、レポート出力ディレクトリーにある index.html ファイルを開きます。これにより、処理されたアプリケーションの一覧が表示されます。各行には、ストーリーポイント、インシデントの数、アプリケーションで発生したテクノロジーの概要が含まれます。

図3.1 アプリケーションリスト

注記

新しいルールが MTA に追加されると、インシデントと予測されるストーリーポイントが変わります。この値は、このアプリケーションをテストする際に表示される値と一致しない場合があります。

以下の表は、このメインの MTA ランディングページからアクセスできるレポートおよびページの一覧です。アプリケーションの名前 jee-example-app-1.0.0.ear をクリックして、アプリケーションレポートを表示します。

ページ	アクセス方法
用途	アプリケーションの名前をクリックします。
テクノロジーレポート	ページ上部の `Technologies` リンクをクリックします。
複数のアプリケーションで共有されるアーカイブ	複数のアプリケーションで共有されるアーカイブリンクをクリックします。このリンクは、複数のアプリケーションに共有アーカイブがある場合にのみ利用できることに注意してください。
ルールプロバイダー実行の概要	ページ下部の Rule providers execution overview リンクをクリックします。
使用される FreeMarker 機能およびディレクティブ	ページの下部にある FreeMarker メソッドリンクをクリックします。
フィードバックフォームを送信	上部ナビゲーションバーの Send Feedback リンクをクリックして、MTA チームにフィードバックを送信できるフォームを開きます。

アプリケーションが、他の分析済みアプリケーションとアーカイブを共有している場合は、共有アーカイブからのストーリーポイントの数と、このアプリケーションに固有のストーリーポイントの数が表示されることに注意してください。

図3.2 共有アーカイブ

アプリケーション間で共有されるアーカイブに関する情報は、「複数アプリケーション間で共有されるアーカイブ」を参照してください。

3.1. アプリケーションレポート

3.1.1. Dashboard

アプリケーションのリスト でアプリケーション名をクリックして、レポートランディングページからこのレポートにアクセスします。

ダッシュボードでは、アプリケーションの移行作業全体の概要が表示されます。つまり、以下のようになります。

カテゴリー別のインシデントおよびストーリーポイント
提案された変更の作業レベル別のインシデントおよびストーリーポイント
パッケージ別のインシデント

図3.3 ダッシュボード

上部のナビゲーションバーには、このアプリケーションの移行に関する追加の詳細を含むさまざまなレポートが一覧表示されます。現在のアプリケーションに適用可能なレポートのみが利用できることに注意してください。

レポート	説明
Issues	注意が必要なすべての問題の簡潔な概要を提供します。
Application Details	移行時に注意する必要がある可能性のあるアプリケーション内で見つかったすべてのリソースの詳細を説明します。
Technologies	機能を基にグループ化されたすべての埋め込みライブラリーを表示します。これにより、各アプリケーションで使用されるテクノロジーを迅速に表示できます。
Unparsable	は、MTA が想定される形式で解析できなかったすべてのファイルを示しています。たとえば、`.xml` または `.wsdl` 接尾辞が付けられたファイルは XML ファイルであることを前提とします。XML パーサーが失敗すると、問題はここに報告され、また個々のファイルがリストされている場所も報告されます。
Dependencies	アプリケーション内にある Java パッケージの依存関係をすべて表示します。
Remote Services	アプリケーション内で見つかったすべてのリモートサービス参照を表示します。
EJB	アプリケーション内の EJB のリストが含まれます。
JBPM	分析中に見つかった JBPM 関連のリソースすべてが含まれます。
JPA	アプリケーションで見つかったすべての JPA 関連リソースの詳細が含まれます。
Hibernate	アプリケーションで検出されたすべての Hibernate 関連リソースの詳細が含まれています。
Server Resources	入力アプリケーションですべてのサーバーリソース (JNDI リソースなど) を表示します。
Spring Beans	分析中に見つかった Spring Bean のリストが含まれます。
ハードコーディングされた IP アドレス	アプリケーションで見つかったすべてのハードコーディングされた IP アドレスの一覧を提供します。
Ignored Files	特定のルールおよび MTA 設定に基づいてアプリケーションに含まれるファイルを一覧表示し、処理されませんでした。詳細は、`--userIgnorePath` オプションを参照してください。
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 ソースレポート

第3章レポートの確認