レポートサービスの管理

レポートサービスは、レポートの生成および送信を担当するスタンドアロン コントローラ プロセスです。コントローラはレポートサービスを使用して、1 回限りのレポートとスケジュール設定されたレポートの両方を送信します。レポートサービスの詳細については、「レポートサービスに必要なフォント」および「インストール設定」を参照してください。  

サービスの構成

レポートサービスは、以下のディレクトリにあるファイルを使用して構成できます。

<Controller home>/reporting_service/reports/config

レポートサービスの動作は、user-config.json ファイルで構成できます。ロードタイムアウトなどのプロパティを構成できます。 

user-config.json に加えた構成変更は、default-config.json で指定されたデフォルトの動作を上書きします。

HTTP または HTTPS ポートの無効化

一部のオンプレミスインストールでは、HTTP または HTTPS 接続を無効にすることができます。これは、リスニングポートの設定に使用されるのと同じ reportServer:port 構成値を使用して実行されます。default-config.json のインストールには、ポートに関する次の値があります。

"reportServer": { "port": "8020", "portSecure": "8021", }

localhost システムの HTTPS を無効にするには、portSecure を 0 に変更します。

"reportServer": { "port": "8020", "portSecure": "0", }

または、セキュリティ上の理由から HTTPS および HTTP を強制する場合は、port を 0 に変更できます。

 "reportServer": { "port": "0", "portSecure": "8021", }

変更後、レポートサーバーを停止してから起動します。

bin/controller.sh stop-reporting-service

コントローラ レポート サービスを開始するには、次の手順を実行します。

bin/controller.sh start-reporting-service

reporting-server.log には、起動時のポート設定に関する情報が含まれています。

レポートサービスのポートリスニングを localhost に制限する

多くのオンプレミスインストールでは、レポートサービスのノードサーバーのリスニングポートを制限し、localhost 接続をリッスンする必要がある可能性があります。これらのリクエストは、ネットワークには送られません。これを行うには、listen ホスト名パラメータを設定するために使用される reportServer:portHostname および reportServer:portSecureHostname 値を使用します。default-config.json のインストールでは、ポートホスト名の値にこれらの値が設定されています。以下にポートとともに示します。

デフォルト値は次のとおりです。

"reportServer": { "port": "8020", "portHostname" : "", "portSecure": "8021", "portSecureHostname" : "" },

reporting-server.log には、起動時のホスト名設定に関する情報が示されています。
次に示すように user-config.json で port*Hostname フィールドに localhost を追加すると、レポートサービスは同じホストにインストールされているコントローラに接続しなくなります。

"reportServer": { "portHostname" : "localhost", "portSecureHostname" : "localhost" },

変更後、次のようにレポートサーバーを停止して起動します。

bin/controller.sh stop-reporting-service

bin/controller.sh start-reporting-service

構成可能なプロパティの詳細については、default-config.json を参照してください。

レポートサービスで使用されるコントローラ URL の更新

レポートサービスでは、デフォルトのディープリンク URL を使用してコントローラに自動的に接続します。この URL は、設定に基づいてロードバランサのコントローラ URL にすることができます。

レポートサービスが同じホスト上の接続に使用するコントローラ URL を変更するには、次の手順を実行します。これにより、レポート送信時にレポートサービスのコントローラ URL を定義する追加のアカウントプロパティが設定されます。

1. ルートユーザーとして管理コンソールにログインします。
2. [Account Settings] を選択します。
3. [Accounts & Licenses] で、更新するアカウント名を選択します。シングル テナント コントローラのデフォルトアカウントは、customer1 です。
4. [編集（Edit）] をクリックします。
5. [Account Properties] で、
   reports-service-controller-url プロパティを追加します。プロパティ値を localhost に設定し、コントローラポートを HTTP または HTTPS として使用します。たとえば、http://localhost:8090 または https://localhost:8181 です。
6. [保存（Save）] をクリックします。

サービスの起動と停止

レポートサービスは、コントローラから独立して起動または停止することができます。コントローラのホームディレクトリで次のコマンドを実行します。

Enterprise Consoleを使用する場合、コントローラを起動または停止すると、レポートサービスも起動または停止されます。

レポートサービスの開始または停止の詳細については、「Start or Stop the Controller Reporting Service」を参照してください。

レポートサービスの正常性ステータスを確認するには、次の手順を実行します。

• レポートサービスプロセスがタスクマネージャまたはアクティビティモニターでアクティブになっているかどうかを確認します。
• レポートサービスサーバーで次の curl コマンドを実行します。

curl -v http://localhost:<port of Reporting Service>

ログの確認

レポートサービスは、コントローラのホームディレクトリで以下のログを使用します。

• /logs/reporting-server.log。レポートメールが送信されたかどうか、およびユーザーからリクエストされたレポートオブジェクトの詳細が記録されます。
• /reporting_service/reports/logs/reporting-process.log。レポートサービスプロセスが開始されているかどうか、および例外が発生したかどうかを確認できます。このログファイルはLinuxのコントローラでのみ使用されます。

レポートサービスのトラブルシューティング

レポートの送信に失敗した理由を調査するには、server.log ファイルを開き、送信しようとしたレポートの runUUID を検索してください。その後、このレポートのログエントリを検索します。

一般的なレポートサービスの問題に対する解決策は以下のとおりです。

• レポートサービスが実行中であることを確認してください。
• サービスのデフォルトポートが8020（HTTPの場合）または8021（HTTPSの場合）であることを確認してください。
• レポートサービスの起動に使用したユーザーアカウントが、コントローラの起動に使用したアカウントと同じであることを確認してください。