Cloud Foundry での PHP アプリケーションの展開および監視
PHP アプリケーションの Cloud Foundry への展開および CA APM PHP エージェントを使用したインスツルメンテーションは、以下の基本的な手順で構成されます。
apmdevops106
PHP アプリケーションの Cloud Foundry への展開および CA APM PHP エージェントを使用したインスツルメンテーションは、以下の基本的な手順で構成されます。
前提条件
Cloud Foundry に PHP アプリケーションを展開する前に、以下の要件を満たしていることを確認します。
- Cloud Foundry への展開の準備ができている PHP アプリケーション
- Cloud Foundry コマンド ライン インターフェース
Cloud Foundry へのアプリケーションのプッシュ
Cloud Foundry に PHP アプリケーションを展開します。 アップロードされたら、ビルドパックはアプリケーションが PHP アプリケーションであることを検出し、ビルドパックが実行されます。 ビルドパックはアプリケーションを調べて、バインドされるサービスと通信するためにダウンロードする必要がある依存関係およびアプリケーションを設定する方法を特定します。
以下の手順に従います
。- Cloud Foundry CLI にログインします。
- 以下のコマンドを実行して、アプリケーションを Cloud Foundry にプッシュします。$ cf push <php_application_name>
- アプリケーションには、デフォルトのルートでアクセス可能です。 新しいアプリケーションの URL を表示するには、以下のコマンドを使用します。$ cf app <php_application_name>
インフラストラクチャ エージェント(CA Digital Experience Insights)のインストール
Cloud Foundry 上で PHP アプリケーションをインスツルメントする前に、CA Digital Experience Insights でインフラストラクチャ エージェントをダウンロードおよびインストールする必要があります。 インフラストラクチャ エージェントをインストールするには、以下の手順に従います。
- 最上部のバーで[エージェントのダウンロード]をクリックします。1 つのエージェントをすでに接続している場合は、[設定]の左ペインで[エージェント]をクリックすることによってのみ[エージェントのダウンロード]ボタンにアクセスできます。
- オペレーティング システムとして[Unix/Linux]を選択します。
- [PHP エージェント]を選択し、tarball をダウンロードします。
- ダウンロードした tarball を解凍します:tar -xf <downloaded_tarball.tar>
- apmia ディレクトリを開きます。
- ./apmia-ca-installer.sh installを実行して、Infrastructure Agent をインストールします。
次のセクションの説明に従って作成する caapm サービスは、このインフラストラクチャ エージェントを指す必要があります。 PHP エージェントは、Cloud Foundry ビルドパックによって自動的にインストールされます。
カスタム サービスの作成
PHP アプリケーションを Cloud Foundry にインストールしたら、CA APM PHP サービスを作成し、このサービスにアプリケーションをバインドする必要があります。 サービス名は文字列 caapm で始まる必要があり、PHP エージェントをインストールするために必要なパラメータをこのサービスに提供する必要があります。
$ cf cups caapm-demophp -p collhost,collport,appname
指定されたパラメータの値をコマンド ラインで対話的に指定します。
- collhostインフラストラクチャ エージェントが存在するホストの IP アドレス。
- collportインフラストラクチャ エージェントがリスンしているポート。 指定されていない場合、デフォルトのポート5005が使用されます。
- appnamePHP アプリケーションの名前。 指定されていない場合、サービスは、Cloud Foundry にアプリケーションをプッシュしたときに定義した名前を使用します。
PHP アプリケーションのサービスへのバインド
Cloud Foundry で、サービスを PHP アプリケーションにバインドします。
$ cf bs <php_application_name> <service_name>
アプリケーションの再ステージング
caapm
サービスを作成し、PHP アプリケーションをそのサービスにバインドしたら、変更を反映するためにアプリケーションを再ステージングする必要があります。 ビルドパックは最後の再ステージング後に、展開されたアプリケーションに加えられたすべての設定を更新します。 アプリケーションを再ステージングすると、アプリケーションが Cloud Foundry に展開されます。$ cf restage <php_application_name>
アプリケーションはサービスを検出し、PHP エージェントのインストール スクリプトを実行します。 CA APM PHP エージェントが自動的にダウンロードおよびインストールされます。 PHP アプリケーションが Cloud Foundry に展開され、インスツルメントされます。
アプリケーション メトリックの表示
アプリケーションに対するトラフィックを生成します。 ブラウザでアプリケーションにアクセスし、CA APM を実行して、アプリケーション メトリックを表示します。
以下の手順に従います。
- アプリケーションに対して何らかのトラフィックを生成します。たとえば、PHP アプリケーションに何らかの入力データを繰り返し追加して、そのアプリケーションに何らかのアクションを実行させます。
- ブラウザを使用して、<Application_Name>.cfapps.ioURL に移動して PHP アプリケーションにアクセスします。
- チーム センター、WebView、または Workstation を開き、アプリケーション メトリックを表示します。
トラブルシューティング
問題の状況
アプリケーションの展開が失敗します。 Cloud Foundry CLI には、展開が失敗したことを示すメッセージが表示されます。 Cloud Foundry 上のアプリケーションがインスツルメントされていません。
解決方法
Cloud Foundry のログを確認します。 コマンド プロンプトで、このコマンドを実行して、ログにアクセスします。
$ cf logs <Application_Name> --recent