Node.jsエージェントをIBM Cloudでインストール
エージェントをnpmからインストールする場合は、アプリケーションのルートディレクトリで次のコマンドを実行します。
npm install @contrast/agent
または、yarnを使用する場合、次のコマンドを実行してエージェントをインストールします。
yarn add @contrast/agent
YAML設定ファイルを使用してNode.jsエージェントを設定し、エージェントの認証キーおよびアプリケーション固有の設定を指定します。
Agent Token: This variable is a base64 encoded JSON object containing the
url
,api_key
,service_key
, anduser_name
configuration settings, allowing you to set them in a single variable.api: token: <Base64Token> server: name: <ServerName>
Legacy settings: For older agents, you can use this sample contrast_security.yaml file, but replace
<URL>
,<UserName>
,<APIKey>
and<ServiceKey>
with your values, and set<ServerName>
to the name of the IBM cloud server to which this application will report. (This way you will be able to identify the server when you view it in Contrast.)contrast: url: <URL> user_name: <UserName> api_key: <APIKey> service_key: <ServiceKey> server: name: <ServerName>
そのYAML設定ファイルをアプリケーションのルートディレクトリにコピーするか、環境変数を使用して必要なContrast API認証情報と設定を行います。
アプリケーションのpackage.jsonファイルの
"scripts":
セクションに次のコマンドを追加します。"ibmcloud-with-contrast": "CONTRAST_CONFIG_PATH=[the full path location of your YAML file] node --import @contrast/agent index.js",
IBM Cloudではデフォルトで起動スクリプトが実行されるため、前述の手順で指定した
ibmcloud-with-contrast
の行で開始するよう起動コマンドを変更する必要があります。次のコマンドを使用して、エージェントを実行します。"start":"npm run bluemix-with-contrast"
そして、package.jsonの"scripts"セクションは以下のようになるはずです。
"scripts": { "bluemix-with-contrast": "CONTRAST_CONFIG_PATH=[the full path location of your YAML file] node --import @contrast/agent index.js", "start":"npm run bluemix-with-contrast” },
次のコマンドを使用して、アプリケーションをIBM Cloudにプッシュします。
cf push <application-name> -t 180
次のコマンドを使用して、エージェントを実行します。
npm start
手動または自動テストを行なってアプリケーションを操作し、エージェントがインストールされた状態でアプリケーションが正しく機能することを確認してください。
アプリケーションサーバがContrastに認識され、アプリケーションがContrastに報告されていることを確認します。