CA APM TG スクリプトの作成および編集 › スクリプト レコーダの使用 › 記録セッションの開始

記録セッションの開始

CA APM TG スクリプト レコーダを使用して、ブラウザのクリック ストリームを記録することによりスクリプトを作成できます。 スクリプト レコーダは、プロキシとして動作し、URL とポストされたデータをキャプチャします。

セッションの記録を開始する方法

1. CA APM TG スクリプト エディタを開き、［File］-［New］を選択します。

   ［New Script］ダイアログ ボックスが表示されます。

2. ［New Script］ダイアログ ボックスで、以下を入力します。
   • スクリプトの［New Script Name］。

     注： スクリプトを CA CEM にマイグレートする場合、この名前は、自動的に作成されたビジネス プロセス名にも使用されます。

   • ［Group Name］（オプション。ただし、推奨）。

     注： グループ名を指定しない場合、HTTP スクリプトのデフォルトのグループ名が使用されます。 このグループ名は、エージェント構成インターフェースの［Scripts By Group］タブに表示されます。

3. デフォルトの設定を使用するか、設定を指定するかを選択します。
   • Use Default Settings — スクリプトがデフォルトの設定で定義されます。 スクリプトは、CA APM TG エージェントにロードされるときに、そのグループで指定された設定を使用します。
   • Specify Settings — ［Global Parameters］ダイアログ ボックスを使用して、このスクリプト専用のパラメータを設定できます。 ［Global Parameters］ダイアログ ボックスは、［Specify Settings］オプションを選択して［OK］をクリックすると表示されます。

   ［Global Parameters］は、スクリプト全体に有効です。 これらの設定は、レコーダに影響を与えません。これらは、スクリプトがエージェントで実行された場合にのみ使用されます。 これらの設定はこのスクリプトだけに適用され、このスクリプトのグループ設定またはエージェント設定を上書きします。

   ［Global Parameters］ダイアログ ボックスでは、以下の設定を指定できます。

   • Normal Interval (sec) — スクリプトのステータスが Normal である場合のポーリング間の秒数を指定します。
   • Error Interval (sec) — スクリプトの実行でエラーが発生した場合のポーリング間の秒数を指定します。
   • Timeout Value (ms) — スクリプト内の各要求の予想される応答時間（ミリ秒単位）を指定します。 しきい値に到達した場合は、要求のステータスがエラーに変わります。
   • Detail Level — 要求する URL コンポーネントを指定します。 Web ページを監視する詳細レベルを設定します。 以下のオプションを選択できます。
     • Page+Frames： ページ、およびそのページに存在する可能性のあるすべてのフレームを要求します。
     • Page+Components： ページ、およびそのページ上のすべてのイメージ コンポーネントを要求します。
     • PageOnly： 初期ページのみを要求します。
     • Max Connections： ［Detail Level］に［PageOnly］以外のいずれかが設定された場合、コンポーネントの要求に対して使用される同時接続数を決定します。 ［Max Connections］は合計 20 に制限されています。

     注： ネットワーク トラフィックに応じて、この値を増加させることによりポーリングのパフォーマンスが向上する場合があります。

   • Enable monitoring — このスクリプトの監視を有効にします。
   • Create debug files — 要求ヘッダと応答ヘッダ、および返されるページのコンテンツが記述されたれたファイルを要求するかどうかを指定します。 この情報は、要求がエラー ステータスを返した理由を判断するのに役立ちます。

     デバッグ ファイルは、<apmtg_home>/RTM_7201/machine_agentname ディレクトリに保存されます。

     注： ディレクトリ名にある 7201 は、インストール時に指定されたデフォルトのポート番号で、後で設定できます。 このポートは、CA APM TG エージェントと RTMCServer 間の通信用です。 ポート番号は、CA APM TG エージェント構成ファイル（wtgagent.ini）を介して設定可能ですが、デフォルトは 7201 です。

   • Send script information to CA Introscope® — CA APM TG エージェントがこのスクリプトの CA Introscope® に情報を送信するかどうかを決定します。

     デフォルトでは、情報を送信するように設定しない限り、CA APM TG エージェントは CA Introscope® にデータを送信しません。 これは、CA APM TG エージェントのインストール時、またはエージェント構成インターフェースを使用して設定できます。 データを送信するようにエージェントを設定すると、スクリプトごとにデータを送信するかどうかを設定できます。

     この機能が無効な場合、データは CA Introscope® に送信されません。 CA APM TG は、引き続き合成トランザクションを実行しますが、CA Introscope® に情報を送信しません。

     この機能を有効にすると、スクリプト情報を CA Introscope® で表示できます。

   • Use Wininet for Windows Extended Authentication — CA APM TG は、Microsoft の Wininet インターフェースを使用して、Windows 拡張認証を使用する Web サイトをサポートします。 Wininet を使用するように RTMCServer を設定できますが、設定後にすべての URL 要求が Wininet を使用するようになります。 Wininet は、共有セッション メモリおよび Internet Explorer の永続 Cookie キャッシュを使用するため、必要な場合のみ Wininet を使用することをお勧めします。

     デフォルトでは、［Use RTM］に設定されています。 RTMCServer 設定で指定された設定が使用されます。

     ［Yes］に設定した場合は、この要求に対して Wininet が使用されます。［No］に設定した場合は、RTMCServer での設定にかかわらず、Wininet は使用されません。

     注： この機能は、Linux プラットフォームでは使用できません。 Linux で CA APM TG エージェントに対してこのオプションを設定すると、有効になりません。

   • Remove control characters from parsing buffer — 選択すると、キャリッジ リターンとライン フィードを削除します。
   • スクリプトに <parse> タグを実装すると、CA APM TG は、解析に使用するバッファからキャリッジ リターンとライン フィードを削除できます。 これにより、解析される文字列を一意に識別できるようになります。
   • Stop script on first error — 要求でエラーが返されると、スクリプトの実行が停止します。 エラーが発生した後にスクリプトを続行しない場合は、このオプションを指定します。
   • Valid Codes — スクリプト要求によって返された場合に、OK ステータスを示す 1 つ以上の HTTP ステータス コードを定義します。 コードはスペースで区切ります。

     たとえば、URL が HTTP 401 コードで応答して認証が必要であることを示す場合、401 を有効なコードとして指定し、Web アプリケーションが認証を確認していることを検証できます。

   • Valid Component Codes — ページ コンポーネントに対してのみ、スクリプト要求によって返された場合に OK ステータスを示す 1 つ以上の HTTP ステータス コードを定義します。 コードはスペースで区切ります。
   • SSL Version — Web サーバによってサポートされている SSL バージョンをオンにします。 SSLv2 と SSLv3 の両方をオンにすることによって、多数の Web サーバ上で記録できます。

     注： Web サーバが IBM WebSphere バージョンまたは Apache Web サーバの場合は、SSLv3 を指定します。

   • Bypass any CA APM TG agent proxy settings — CA APM TG エージェント RTMCServer 設定で指定されたプロキシ情報があり、そのプロキシ情報をこのスクリプトに使用するべきではない場合は、このオプションをオンにします。
   • Specify an override proxy for this script — このスクリプトだけに使用されるプロキシを指定する場合は、このオプションをオンにします。 オンにした場合は、以下のプロキシ フィールドが有効になります。
     • Override Proxy: Address — このスクリプトだけに使用される代替プロキシ サーバのアドレス。
     • Port — このスクリプトだけに使用される代替プロキシ サーバのポート。
     • Security: User and Pswd — このスクリプトだけに使用される代替プロキシ サーバの URL のユーザ名およびパスワード。
4. ［Record］オプションを選択して、［OK］をクリックします。

   設定を指定するように選択した場合は、［Global Parameters］ダイアログ ボックスが表示されます。 ダイアログ ボックスに設定を入力し、［OK］をクリックします。

   スクリプト レコーダが表示されます。

5. ［Start］をクリックし、スクリプト レコーダを設定する際に指定したいずれかのブラウザを使用して記録セッションを開始します。

   ブラウザに空白のページが表示されます。

6. 監視対象の Web サイトの URL を入力し、記録するタスクを実行します。

   注： デフォルトでは、すべてのスクリプト要求（記録されたクリックストリーム イベント）は、シーケンス番号の識別子と共に、CA APM TG エージェント構成インターフェースおよび CA CEM にリスト表示されます。 ［Set Request ID］を使用してスクリプト要求に名前を付けるためのヒントについては、「［Set Request ID］を使用した要求の論理的なグループ化」を参照してください。

7. 記録が完了したら、スクリプト レコーダ（Alt+Tab キー）に切り替えて［Stop］をクリックします。
8. ［File］-［Save］を選択してスクリプトを保存します。

   スクリプト エディタは、エージェント マシンの以下のディレクトリにスクリプトを保存します。

   <apmtg_home>¥wtgagent_name¥scripts
   

   注： スクリプト エディタでスクリプトを確認および編集し、変更を保存できます。

9. エージェント構成でスクリプトを更新します。 エージェント構成に接続し、［All Scripts］タブまたは［Group Scripts］ページ（［Scripts By Group］-［GroupName］）のいずれかで［Update Modified Scripts］ボタンをクリックします。
10. スクリプトをクリックして、その詳細を表示します。 スクリプトは、エージェントの間隔設定に基づいて起動します。