Configuration parameters for the Amazon EC2 agent
The configuration parameters for the Amazon EC2 agent are displayed in the following table 1.
Note: These settings are used to monitor Amazon EC2 instances remotely. Instances are automatically discovered in the specified region that you want to configure.
| Parameter name | Description | Silent configuration file parameter name |
|---|---|---|
| EC2 Subnode Name | Name of the EC2 Subnode for collection of data. Example, usw2a. This alias is part of the managed system name (MSN) and it is used to visually identify the monitored environment in the Cloud APM console. Note: This alias can be anything that you choose to represent the Amazon EC2 subnode instance with the following restrictions. Letters from the Latin alphabet (a-z, A-Z), Arabic numerals (0-9), the hyphen-minus character (-), and the underscore character (_) can be used to create agent subnode instance names. The maximum length of an EC2 subnode name is 25 characters. |
Each of the following parameters must have an agent subnode name suffix that is the same for each parameter of an agent subnode instance. New agent subnode instances must use a unique name for its set of parameters. For example, one agent
subnode instance can use .usw2a and another agent subnode instance can use .usw2b in place of .subnode_name in the parameter names that follow. |
| Access ID | AWS security credentials Access Key ID that is used to authenticate with the specified Amazon Region. For example, AKIAxxxxxxxxxxxxxxx. |
KB5_INS_ACCESS_ID.subnode_name |
| Secret Key | AWS security credentials Access Key ID that is used to authenticate with the specified Amazon Region. For example, AKIAxxxxxxxxxxxxxxx. |
KB5_INS_SECRET_KEY.subnode_name |
| Region | AWS Region to monitor. For example, us-west-2. |
KB5_INS_REGION.subnode_name |
| Filtering Condition | The type of filtering that is being done. You can use custom tags on EC2 instances to limit which EC2 instances are monitored by the agent. For more information, see Tagging Your Amazon EC2 Resources. Filtering options: none All EC2 instances within the region are monitored. Filter Value is ignored. tagName EC2 instances with the tag key that is specified in Filter Value are monitored, regardless of the actual value in the corresponding EC2 instance tag value. For example, to monitor all EC2 instances that have the tag key Stack, regardless of the value in its tag value, specify Stack in Filter Value. tagName|tagValue EC2 instances with the tag key and tag value pair that is separated with a vertical bar (|), and that is specified in Filter Value are monitored. For example, to monitor all EC2 instances that have the tag key Stack and the tag value Production, specify Stack|Production in Filter Value. monitoring-tag EC2 instances that have at least one tag are monitored. Filter Value is ignored. |
FILTER_CONDITION.subnode_name Valid values: none none tagName tagName tagName|tagValue tagName|tagValue monitoring-tag monitoring-tag |
| Filter Value | The value of the tag by which the EC2 instances are filtered when either tagName or tagName|tagValue are selected for Filtering Condition. | FILTER_VALUE.subnode_name |