EC2 - Instance Deployment Test

This test powers a specified VM on and off at configured intervals. In the process, the test verifies the success/failure of the corresponding operation (i.e., power on / off), and also reports the time taken by that instance to power on and off. Failed attempts to power-on and significant delays in powering on are thus brought to light.

This test is disabled by default. To enable the test, go to the enable / disable tests page using the menu sequence : Agents -> Tests -> Enable/Disable, pick the desired Component type, set Performance as the Test type, choose the test from the disabled tests list, and click on the < button to move the test to the ENABLED TESTS list. Finally, click the Update button.

Target of the test: Amazon Region

Agent deploying the test: A remote agent

Output of the test: One set of results for the AWS region being monitored

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.


The host for which the test is to be configured.

AWS Access Key, AWS Secret Key, Confirm AWS Access Key, Confirm AWS Secret Key

To monitor an Amazon instance, the eG agent has to be configured with the access key and secret key of a user with a valid AWS account. For this purpose, we recommend that you create a special user on the AWS cloud, obtain the access and secret keys of this user, and configure this test with these keys. The procedure for this has been detailed in the Obtaining an Access key and Secret key topic. Make sure you reconfirm the access and secret keys you provide here by retyping it in the corresponding Confirm text boxes.

Proxy Host and Proxy Port

In some environments, all communication with the AWS cloud and its regions could be routed through a proxy server. In such environments, you should make sure that the eG agent connects to the cloud via the proxy server and collects metrics. To enable metrics collection via a proxy, specify the IP address of the proxy server and the port at which the server listens against the Proxy Host and Proxy Port parameters. By default, these parameters are set to none , indicating that the eG agent is not configured to communicate via a proxy, by default.

Proxy User Name, Proxy Password, and Confirm Password

If the proxy server requires authentication, then, specify a valid proxy user name and password in the proxy user name and proxy password parameters, respectively. Then, confirm the password by retyping it in the CONFIRM PASSWORD text box. By default, these parameters are set to none, indicating that the proxy sever does not require authentication by default.

Proxy Domain and Proxy Workstation

If a Windows NTLM proxy is to be configured for use, then additionally, you will have to configure the Windows domain name and the Windows workstation name required for the same against the proxy domain and proxy workstation parameters. If the environment does not support a Windows NTLM proxy, set these parameters to none.

Instance ID

Specify the ID of the instance that is to be powered on/off by this test. By default, this test is not designed to report any metrics for any instance; this is why, the instance id is set to none by default. Note that this test will not run until a valid instance id and instance type are provided.

Instance Type

Specify the type of the configured instance. Since this test is not designed to report any metrics for any instance by default, this parameter is set to none by default. Note that this test will report metrics only if a valid instance id and instance type are provided.


Indicate how frequently (in seconds) the test needs to power an instance on and off. By default, the test period and frequency of this test will be the same; both will be set to 24 hrs (i.e., 86400 seconds) by default. However, some administrators may not want their critical instances to be powered on and off at the same frequency at which the test runs. In such a case, you can define a separate power on/off frequency for the test using the frequency parameter.

Measures reported by the test:

Measurement Description Measurement Unit Interpretation

Was instance powered on successful?:

Indicates whether/not the configured instance was powered on successfully.


If the instance was powered-on successfully, then the value of this measure will be Yes. If not, then the value of this measure will be No.

The numeric values that correspond to the measure values mentioned above are as follows:

Measure Value

Numeric Value






By default, this measure reports one of the Measure values listed in the table above. The graph of this measure however, represents the success/failure of a power-on operation using the numeric equivalents - ‘0’ and '100' - only.