Related pages:

レポートサービスは、レポートの生成および送信を担当するスタンドアロン コントローラ プロセスです。コントローラはレポートサービスを使用して、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",
     }
CODE


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

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

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

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

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

これらのスクリプトを実行して controller.sh プロセスを開始するには、まずコントローラホストにログインする必要があります。

bin/controller.sh stop-reporting-service
CODE
Windows の [Service] > [AppDynamics Reporting Service] を停止して、コントローラ レポート サービスを停止します。

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

これらのスクリプトを実行して controller.sh プロセスを開始するには、まずコントローラホストにログインする必要があります。

bin/controller.sh start-reporting-service
CODE
Windows の [Service] > [AppDynamics Reporting Service] を開始して、コントローラ レポート サービスを開始します。

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

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

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

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

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

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

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


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

これらのスクリプトを実行して controller.sh プロセスを開始するには、まずコントローラホストにログインする必要があります。

bin/controller.sh stop-reporting-service
CODE
Windows の [Service] > [AppDynamics Reporting Service] を停止して、コントローラ レポート サービスを停止します。

これらのスクリプトを実行して controller.sh プロセスを開始するには、まずコントローラホストにログインする必要があります。

bin/controller.sh start-reporting-service
CODE
Windows の [Service] > [AppDynamics Reporting Service] を開始して、コントローラ レポート サービスを開始します。

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

サービスの起動と停止

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

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

レポートサービスが実行中であるかどうかを確認するには、次のコマンドを実行します。

./reporting_service/reports/bin/reports-service.sh|bat list

レポートサービスを起動するには、次のコマンドを実行します。

./reporting_service/reports/bin/reports-service.sh|bat start

レポートサービスを停止するには、次のコマンドを実行します。

./reporting_service/reports/bin/reports-service.sh|bat stop

ログの確認

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

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

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

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

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

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