トラブルシューティング用のログを取得する方法
この記事では、OutSystemsコンポーネントおよびその他のシステムコンポーネントからログやレポートファイルを取得する方法について説明しています。
サポートケースの対応中、発生している問題をトラブルシューティングするために、OutSystems Supportからこれらのファイルの一部を提供するよう求められる場合があります。その場合、この記事の説明に従って必要なファイルを取得し、サポートケースに添付する必要があります。
Service Studioのレポートを取得する
Service Studioで予期しないエラーが発生すると、［Unexpected Error］ウィンドウが表示されます。このウィンドウで、エラーレポートを取得してOutSystems Supportに送信することができます。
レポートを取得するには、以下の手順を実行します。
1.ウィンドウが展開されていない場合、［You can help us fix this...］をクリックしてウィンドウを展開します。
1.［View diagnostics report］をクリックして、テキストエディタでレポートを開きます。OutSystems 10では、［View report］リンクを使用します。
1.レポートをテキストファイルとして保存します。OutSystemsサポートのサポートが必要な場合でサポートケースをまだ開いていない場合は、［open a support case］リンクを使用してSupport Portalにアクセスすることができます。
1.［Continue］をクリックして、ウィンドウを閉じます。OutSystems 10では、［Cancel］リンクを使用します。
OutSystems Supportからのリクエストに応じてこのレポートを取得した場合は、保存したファイルをサポートケースに添付します。
Service Centerのログを取得する
実行時ログ
プラットフォームの実行時のログは、各環境（アプリケーションおよびLifeTime環境）のService Centerコンソールで取得することができます。
- エラー
- Generalログ
- Webリクエスト
- モバイルリクエスト
- サービスアクション
- 連携
- エクステンション
- タイマー
- メール
これらのログを取得するには、以下の手順を実行します。
1.ログを取得する環境のService Centerコンソール（https://<ご利用のサーバー>/ServiceCenter）で、［Monitoring］セクションに移動します。
1.取得するログのタイプ（［Errors］や［General］など）を選択します。
1.フィルタが適用されている可能性がある場合は、［Reset］をクリックして削除します。
1.［Export to excel］をクリックして、ファイルを保存します。
OutSystems Supportからのリクエストに応じてこれらのログを取得した場合は、保存したすべてのファイルをローカルのダウンロードフォルダから取得してサポートケースに添付します。
モバイルアプリの生成ログ
OutSystemsでは、エラー発生時の詳細情報を示すスタックトレースなど、モバイルアプリのパッケージ生成手順のログが記録されます。
このモバイルアプリのパッケージ生成ログを取得するには、以下の手順を実行します。
1.Service Studioを開いている場合は、モバイルアプリの詳細ページに移動し、［Application Management...］をクリックしてService Centerコンソールのモバイルアプリのページを開きます。別のブラウザでページが開きます。
Service Studioを開いていない場合は、環境のService Centerコンソール（`https://<ご利用のサーバー>/ServiceCenter`）を開き、［**Factory** > **Applications**］に移動し、モバイルアプリ名をクリックして、アプリの詳細ページに移動します。
1.［Native Platforms］タブに移動します。各モバイルプラットフォームの最新のモバイルアプリのパッケージ生成に関する情報が表示されます。
1.ログファイルアイコンをクリックして、ファイルを保存します。
OutSystems Supportからのリクエストに応じてこのログを取得した場合は、保存したファイルをローカルのダウンロードフォルダから取得してサポートケースに添付します。
LifeTimeのレポートを取得する
LifeTimeコンソールで、以下のレポートを取得することができます。
- LifeTimeレポート
- ステージングレポート
- ユーザー権限レポート
これらのレポートを取得するには、Manage Infrastructure and Users（インフラとユーザーの管理）権限が必要です。この権限がない場合は、インフラ管理者にお問い合わせください。
LifeTimeレポート
OutSystems 11でLifeTimeレポートを取得する
OutSystems 11でLifeTimeレポートを取得するには、以下の手順を実行します。
1.ページhttps://<LifeTimeサーバー>/lifetime/troubleshoot.aspxにアクセスします。
1.［Download Infrastructure report］リンクをクリックして、ファイルを保存します。
OutSystems Supportからのリクエストに応じてこのレポートを取得した場合は、保存したファイルをローカルのダウンロードフォルダから取得してサポートケースに添付します。
OutSystems 10でLifeTimeレポートを取得する
OutSystems 10でLifeTimeレポートを取得するには、以下の手順を実行します。
1.LifeTimeコンソール（https://<LifeTimeサーバー>/lifetime）に移動します。
1.右上にあるフィードバック送信アイコンをクリックします。
1.［here］リンクをクリックして、ファイルを保存します。
OutSystems Supportからのリクエストに応じてこのレポートを取得した場合は、保存したファイルをローカルのダウンロードフォルダから取得してサポートケースに添付します。
ステージングレポート
OutSystems 11でステージングレポートを取得する
OutSystems 11でステージングレポートを取得するには、以下の手順を実行します。
1.https://<LifeTimeサーバー>/lifetime/troubleshoot.aspxページにアクセスして、［Deployment/Staging］リストを表示します。
1.ステージングのリストで、トラブルシューティングが必要なステージングを特定します。ステージング日または環境でフィルタリングすることができます。
1.特定したステージングの行の［Download staging report］リンクをクリックして、ファイルを保存します。
OutSystems Supportからのリクエストに応じてこのレポートを取得した場合は、保存したファイルをローカルのダウンロードフォルダから取得してサポートケースに添付します。
OutSystems 10でステージングレポートを取得する
OutSystems 10でステージングレポートを取得するには、以下の手順を実行します。
1.LifeTimeコンソール（https://<LifeTimeサーバー>/lifetime）に移動します。
1.［Applications］ページでターゲット環境の名前をクリックして、ドロップダウンメニューから［View Change Log］を選択します。
1.トラブルシューティングするデプロイのデプロイ計画番号をメモに取ります。
1.デプロイ計画番号を使用して、以下のページにアクセスします。
https://<LifeTimeサーバー>/lifetime/DebugStaging.aspx?StagingId=<デプロイ計画番号>.
Javaスタックの場合は、`https://<LifeTimeサーバー>/lifetime/DebugStaging.jsf?StagingId=<デプロイ計画番号>`を使用します。
1.［download the staging report］をクリックして、ファイルを保存します。
OutSystems Supportからのリクエストに応じてこのレポートを取得した場合は、保存したファイルをローカルのダウンロードフォルダから取得してサポートケースに添付します。
ユーザー権限レポート
OutSystems 11でユーザー権限レポートを取得する
OutSystems 11でユーザー権限レポートを取得するには、以下の手順を実行します。
1.ページhttps://<LifeTimeサーバー>/lifetime/troubleshoot.aspxにアクセスします。
1.［Download the user permissions report］リンクをクリックして、ファイルを保存します。
OutSystems Supportからのリクエストに応じてこのレポートを取得した場合は、保存したファイルをローカルのダウンロードフォルダから取得してサポートケースに添付します。
OutSystems 10でユーザー権限レポートを取得する
OutSystems 10でユーザー権限レポートを取得するには、以下の手順を実行します。
1.ページhttps://<LifeTimeサーバー>/lifetime/DebugPermissions.aspxにアクセスします。
Javaスタックの場合は、`https://<LifeTimeサーバー>/lifetime/DebugPermissions.jsf`を使用します。
1.［download the user permissions report］リンクをクリックして、ファイルを保存します。
OutSystems Supportからのリクエストに応じてこのレポートを取得した場合は、保存したファイルをローカルのダウンロードフォルダから取得してサポートケースに添付します。
BPTUtilsのトラブルシューティングレポートを取得する
BPT Utilsは、トラブルシューティングレポートなどのBPTプロセスに関する情報を提供するForgeコンポーネントです。
まだ入手していない場合は、LifeTime環境にBPT Utilsコンポーネントをインストールする必要があります（環境の「Full Control（完全制御）」権限が必要です）。
1.OutSystems ForgeからBPT Utilsをダウンロードします。OutSystemsアプリケーションファイル（.oap）を入手します。OutSystems 9.1、10、11で利用可能なバージョンが1つあります。ご利用のLifeTime環境に対応するバージョンを必ずダウンロードしてください。
1.LifeTime環境のService Centerコンソール（https://<LifeTimeサーバー>/ServiceCenter）に移動します。
1.［Factory > Applications］に移動します。
1.［Publish an Application］リンクをクリックします。
1.［Choose File］をクリックして、Forgeからダウンロードした.oapファイルを選択します。
1.［1-Click Publish］をクリックします。
これでLifeTime環境にBPT Utilsがインストールされました。
BPTUtilsのトラブルシューティングレポートを取得するには、以下の手順を実行します。
1.BPT Utilsアプリケーション（https://<LifeTimeサーバー>/BPTUtils/）で、［Troubleshooting Processes］に移動します。
1.［Download Troubleshooting Report］をクリックして、ファイルを保存します。
OutSystems Supportからのリクエストに応じてこのレポートを取得した場合は、保存したファイルをローカルのダウンロードフォルダから取得してサポートケースに添付します。
.Netスタック固有のログ
Windowsのイベントログ
特定の環境のWindowsのイベントログを取得するには、以下の手順を実行します。
1.リモートデスクトップを使用してサーバーに接続します。
1.Windowsイベントビューアアプリケーションを起動します。
1.Windows Logsフォルダを展開します。
1.ログのカテゴリ（Application、Security、またはSystem）を選択します。
1.右パネルの［Save All Events As…］をクリックして、ファイルを保存します。
OutSystems Supportからのリクエストに応じてこれらのログを取得した場合は、指定がない限り、ApplicationログとSystemログを保存し、保存したファイルをローカルのダウンロードフォルダから取得してサポートケースに添付します。
IISマネージャのログ
特定の環境のIISマネージャのログを取得するには、以下の手順を実行します。
1.リモートデスクトップを使用してサーバーに接続します。
1.インターネットインフォメーションサービス（IIS）マネージャアプリケーションを起動します。
1.左側のツリーでWebサイトを選択します。
1.［Logging］機能をダブルクリックします。
1.ログファイルが保存されているディレクトリを確認します。
1.ファイルエクスプローラを使用して、ログディレクトリに移動します。 1.ディレクトリのすべての内容をzipにまとめ、サポートケースに添付します。
OutSystems Supportからのリクエストに応じてこれらのログを取得した場合は、ログディレクトリのすべての内容をzipにまとめて、そのzipファイルをサポートケースに添付します。
Javaスタック固有のログ
JBossのログ
特定の環境のJBossのログを取得するには、以下の手順を実行します。
1.サーバーに接続します。
1.ログファイルは、以下の場所にあります。 * JBoss 5: /opt/jboss-5.1.0.GA/server/outsystems/log * JBoss 7: /opt/jboss-as-7.1.1.Final/standalone/log
OutSystems Supportからのリクエストに応じてこれらのログを取得した場合は、すべてのファイルをzipにまとめて、そのzipファイルをサポートケースに添付します。
WildFlyログ
特定の環境のWildFlyのログを取得するには、以下の手順を実行します。
1.サーバーに接続します。
1.ログファイルは、以下の場所にあります。
* WildFly 8.2: /opt/wildfly-8.2.0.Final/
OutSystems Supportからのリクエストに応じてこれらのログを取得した場合は、すべてのファイルをzipにまとめて、そのzipファイルをサポートケースに添付します。
WebLogicのログ
特定の環境のWebLogicのログを取得するには、以下の手順を実行します。
1.サーバーに接続します。
1.ログファイルは、以下の場所にあります。
* 管理サーバーのログ: /opt/Oracle/Middleware/user_projects/domains/outsystems_domain/servers/AdminServer/logs
* 管理対象サーバーのログ: /opt/Oracle/Middleware/user_projects/domains/outsystems_domain/servers/<管理対象サーバー名>/logs
OutSystems Supportからのリクエストに応じてこれらのログを取得した場合は、すべてのファイルをzipにまとめて、そのzipファイルをサポートケースに添付します。