APIGW node Traces to CA APM
search cancel

APIGW node Traces to CA APM

book

Article ID: 107859

calendar_today

Updated On:

Products

STARTER PACK-7 CA Rapid App Security CA API Gateway

Issue/Introduction

Enabled the integration between CA API Gateway and CA APM using Precision agent.
Following the instructions on this guide to generate metrics and traces. Metrics are arriving fine in APM but traces don't.
REF : 
https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-enterprise-software/layer7-api-management/precision-api-monitoring/3-4/configuring/configure-trace-and-metrics-collection.html

Environment

Product Versions:

Any APM Agent release

Precision 3.2 API Gateway 9.2 

Cause

Configure Gateway Traces to APM

Resolution

1) EPACtrl-SSH.sh file (MIN and MAX heap values to 512), 

2) created a crontab entry to recycle the epagent to ensure it always has a pipe open to APM. 
epagent restart

3) enable the “Latency Metrics Assertion” for the services customer is using (Its recommended to use “Collect for every 15000 milliseconds” instead of “Collect for every 1 service calls”). 
Per Documentation 
https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-enterprise-software/layer7-api-management/precision-api-monitoring/3-1/Gateway-Tracing-Tuning-Instructions.html
And 
under (Optional) Configure Latency Metrics Assertion

https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-enterprise-software/layer7-api-management/precision-api-monitoring/3-4/configuring/configure-trace-and-metrics-collection.html

, check “Recommended global limits”, collecting traces for every service call should only be done in testing/dev environments. If a API is heavily used, collecting traces for every service call could crash the Gateway, and it certainly will impact the GW’s performance 

4) Updated Precision API Monitoring in Tasks -> Manage Solution Kits to 3.3

5) Extremely Important *** 
Tracing will only show or work on policies that are in success. 

If any policy fails with assertion falsified (or custom error) for example a route via http fails (as can be observed in policy Manager Audit logs then it will not show traces for the assertions. It will show a Failed (in APM) record count increase.. 

Only policy execution that ends in success will have Traces data.