Captures statistics for APIs in the API Gateway from Amazon CloudWatch and displays them in the AppDynamics Metric Browser.
Configure the AWS API Gateway monitoring extension by editing the config.yml file in
If SIM is enabled, then use the following metricPrefix
metricPrefix: "Custom Metrics|AWS APIGateway" Else, configure the "COMPONENT_ID" under which the metrics need to be reported. This can be done by changing the value of
For example, metricPrefix: "Server|Component:100|Custom Metrics|AWS APIGateway|"
cloudWatchMonitoring: "Basic"If you want to run the extension with a further delay, comment the "cloudWatchMonitoring" and use the following field which takes in the number of minutes after which the extension should call the cloudwatch metrics.
Configure the AWS account by specifying the awsAccessKey(required), awsSecretKey(required) of the AWS account. displayAccountName(required) and regions(required) also needs to be configured.
accounts: - awsAccessKey: "XXXXXXXX1" awsSecretKey: "XXXXXXXXXX1" displayAccountName: "TestAccount_1" regions: ["us-east-1","us-west-1","us-west-2"]
If you know for which Apis you need the metrics for, the you can mnitor only those Apis. This can be done by secifying the patterns of the Api names that needs to be minitored
For example, If you want only Apis who name is exactly "sample" as well as the Apis with the name starting with demo, then you can configure it as below
apiNames: ["^sample$", "^demo"]
Apart from the above metrics, the extension also gives a metric called "API calls", that gives out the number of cloudwatch API calls per minutes from the extension.
You need to have events service setup and working before you do the following.
To get configuration metrics related to AWS API Gateway on your analytics platform, please follow the below steps:
#eventsService: # enableTraditionalMetrics: false # enableApiMetrics: false # enableResourceMetrics: false # enableStageMetrics: false # credentials: # controllerEventsServiceHost: "" # controllerEventsServicePort: 9080 # enableSSL: false # controllerGlobalAccountName: "" # eventsAPIKey: ""
enableTraditionalMetrics: false enableApiMetrics: false enableResourceMetrics: false enableStageMetrics: false
credentials: controllerEventsServiceHost: "" controllerEventsServicePort: 9080 enableSSL: false controllerGlobalAccountName: "" eventsAPIKey: ""
AWSAPIGatewayMonitor_traditionalMetrics AWSAPIGatewayMonitor_APIMetrics AWSAPIGatewayMonitor_ResourceMetrics AWSAPIGatewayMonitor_StageMetrics
Workbench is an inbuilt feature provided with each extension in order to assist you to fine tune the extension setup before you actually deploy it on the controller. Please review the following document on How to use the Extensions WorkBench
Please follow the steps listed in this troubleshooting-document in order to troubleshoot your issue. These are a set of common issues that customers might have faced during the installation of the extension. If these don't solve your issue, please follow the last step on the troubleshooting-document to contact the support team.
|4.4 or later|
Please follow the steps specified in the Troubleshooting document to debug problems faced while using the extension.
Always feel free to fork and contribute any changes directly via GitHub.
For any questions or feature request, please contact AppDynamics Support.