Unsupported product This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Amazon Web Services (AWS)


The AWS application class is a container for all of the AWS account instances.

BMC PATROL properties

Item

Description

Active

Yes

Created by

Discovery

Parent class

None

Child classes

None

InfoBox

The AWS application class InfoBox contains the following information:

Note

InfoBoxes are not accessible from a BMC ProactiveNet console.

InfoBox item

Description

Release

The version number for this release of PATROL for AWS.

Configuring the monitoring of Amazon Web Services

This topic provides information about configuring PATROL for Amazon Web Services KM in the Central Monitoring Administration and TrueSight console. To configure the KM, set the following preferences on the Add Monitoring Configuration dialog.

Monitoring Solution

Version

Monitoring Profile

Monitor Type

Amazon Web Services

2.0.00

Amazon Web Services

Amazon Web Services

With Amazon Web Services as the selected monitor type, the Add Monitor Types dialog box enables you to configure details for connecting to the accounts and web services provided by Amazon Web Services. For more information, see Defining-a-monitoring-policy.

Field

Instructions

Amazon Web Services Monitoring Configuration

Administration

JAVA Home

Specify the full path of JRE directory on the PATROL Agent server. JAVA version should be 1.7 and later.

Forexample:c:\java\jre7

AWS Account Configuration

Account Name

Specify the name that identifies this set of AWS account monitoring configuration. This name is used as the instance name of the top level container.

Note: Do not use special characters like (@), slash mark (/) in the Account Name field.

Access Key

Specify the access key for the account provided by Amazon Web Services account user.

Secret Key

Specify the secret key for the account provided by Amazon Web Services account user.

Click to view a short video on how to create user policy in Amazon Web Services console.

icon-play.png https://youtu.be/7YJ6XtkhBnA

Note

These keys are generated from the AWS console. Also, see Prerequisites-for-configuring-AWS-instance.

Proxy Server Configuration

Click this tab to configure the proxy server.

Use Proxy Configuration

Select the checkbox to enable the proxy configuration.

Server Name

Specify the proxy server name that is being used to route HTTP requests .

Port

Specify the proxy server port number that is being used to connect specified proxy server.

User Name

Specify the proxy server username that is being used to log in.

Password

Specify the proxy server password that is being used to log in.

Select Services

Click this tab to enable/disable the services.

Note

The services like Elastic Compute Cloud (EC2), Elastic Block Storage (EBS), Elastic Load Balancer (ELB) are monitored by default. 

Relational Database Service (RDS)

Select the checkbox to enable the monitoring of Relational Database Service (RDS) for the specified account.

Simple Notification Service (SNS)

Select the checkbox to enable the monitoring of Simple Notification Service (SNS) for the specified account.

Simple Queue Service (SQS)

Select the checkbox to enable the monitoring of Simple Queue Service (SQS).

Elasticache

Select the checkbox to enable the monitoring of Elasticache.

Lambda

Select the checkbox to enable the monitoring of Lambda functions.

DynamoDB

Select the checkbox to enable the monitoring of DynamoDB.

Redshift

Select the checkbox to enable the monitoring of Redshift.

API Gateway

Select the checkbox to enable the monitoring of API Gateway.

Filter Configuration

Click this tab to enable filtering options.

Region Filter Type

Select Include to monitor only the regions mentioned in the Regions field below.

Select Exclude to exclude the regions mentioned in the Regions field below.

Regions

Specify the regions that you want to include or exclude from monitoring. The following is the format for specifying regions:

  • us-east-1
  • us-west-2
  • us-east-2

Use comma (,) only to separate the regions.

EC2 Tag Filter Type

Select Include to monitor only the EC2 tags mentioned in the EC2 Tag Filter field below.

Select Exclude to exclude the EC2 tags mentioned in the EC2 Tag Filter field below.

EC2 Tag Filter

Specify the EC2 tags that you want to include or exclude from monitoring. The following is the format for EC2 tags:

  • TagKey=TagValue

Use comma (,) only to separate the tags.

Lambda Function Filter Type

Select Include to monitor only the Lambda functions mentioned in the Lambda function filter.

Select Exclude to exclude the Lambda functions mentioned in the Lambda function filter.

Lambda Function Filter

Specify the lambda function name that you want to include or exclude from monitoring. Use comma (,) only to separate the functions.

It supports regex pattern.

Monitor Lambda Custom Metrics

Select this checkbox to enable lambda function log monitoring for custom metrics.

Note

  • To monitor Lambda function custom metrics, it is recommended to use the following format in the AWS Lambda function log:
    LOGMON|<CUSTOM_METRIC_NAME>|<CUSTOM_METRIC_VALUE>
  • To find the custom metric name and metric value, it searches AWS Lambda function logs for the following string:
    LOGMON|metricname|metricvalue
    Metricname 
    represents the name of the metric. It should not have any spaces and special characters. For example: TestAWS, Amazon
    Metricvalue represents the value of the metric. It should be any integer or float value. For example: 101, 21.0

For example:

LOGMON|CustomMetric1|768

By default the Lambda custom metrics monitoring is disabled. You can enable the Lambda custom metrics monitoring by enabling the Monitor Lambda Custom Metrics check-box in Central Monitoring Administration and TrueSight console.

Add to List

Click this option to add the account to the list of monitored accounts.

Modify Selection

Click this option to save the changes you made in the configuration details for the selected account. After doing this, click Update to reflect your changes under the list of Defined Monitor Types and Attributes on the Monitor Configuration tab.

This option is only available when you select an existing policy and click Edit on the Monitor Configuration tab.

Remove from List

Click this option to remove the account from the list of monitored accounts.

This option is only available when you select an existing policy and click Edit or Delete on the Monitor Configuration tab.

Enable Debug

Enable Debug

Select thecheck-boxto enable debug. This will create log files at <PATROL_HOME>/pll directory on the PATROL Agent server.

For example:

RemoteCollector-<PATROL_AGENT_PORT>-aws.log

Add

Click this option to add the monitor type under the list of Defined Monitor Types and Attributes on the Monitor Configuration tab

Close 

Click this option to close the Add Monitor Types dialog box without saving any changes

Reset

Click this option to clear off your configuration and revert to default settings

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*