Technologies/LocalStack/localstack.apigateway.integration.latency
LocalStackLocalStackMetric

localstack.apigateway.integration.latency

Backend integration latency
Dimensions:None
Available on:Native (1)
Interface Metrics (1)
Native
Time spent in backend integration execution in milliseconds
Dimensions:None

Technical Annotations (45)

Configuration Parameters (7)
GATEWAY_LISTENrecommended: :4566,:80,:443
Enables LocalStack gateway to listen on ports 80 and 443 for ALB-to-API Gateway integration
PROVIDER_OVERRIDE_APIGATEWAYrecommended: next_gen
Uses next-generation API Gateway provider implementation
$context.integration.latency
access logging variable to monitor integration latency duration
integration_timeoutrecommended: >29 seconds for long-running operations
default is 29 seconds; increasing may require throttle quota adjustment
APIGW_ENABLE_NEXT_GEN_WEBSOCKETSrecommended: 1
Enables next-gen WebSocket implementation; fix works with or without this setting
Statisticrecommended: Average
Statistical method for evaluating latency metric
Periodrecommended: 5 minutes
Evaluation period for latency measurements
Error Signatures (6)
504http status
Gateway TimeOut Exceptionexception
Internal Server Errorlog pattern
500http status
Error raised during invocation: Internal Server Errorlog pattern
Method completed with status: 504log pattern
CLI Commands (3)
curl -v http://local-alb.elb.localhost.localstack.cloud/accounts/healthdiagnostic
curl -v https://50b2495d.execute-api.localhost.localstack.cloud:4566/local/accounts/healthdiagnostic
aws apigatewayv2 update-integration --api-id abcd1234 --integration-id aaabbb --request-parameters 'integration.request.header.someHeaderParam'='route.request.body.someBodyParam'diagnostic
Technical References (29)
API Gateway DashboardcomponentCloudWatchcomponentOPTIONSprotocolPOSTprotocolIntegrationLatencycomponentLatencycomponentmapping templatescomponentLambda authorizercomponentINITconceptcold startconceptLambda function handlercomponentREPORT statementsconceptIntegration LatencyconceptCloudWatch LogscomponentREST API GatewaycomponentHTTP API Gatewaycomponentprovisioned concurrencyconceptcold startsconceptAPIGW v2 HTTP Endpointcomponentlocalhost.localstack.cloudcomponentTwistedWebcomponentJWT authorizercomponentresource-based policycomponentAPI Gateway REST APIcomponentasynchronous invocationconceptAPI Gateway WebSocketcomponentroute.request.bodyconceptintegration.request.headerconceptrequest-parameterscomponent
Related Insights (14)
API Gateway Dashboard metric averaging creates misleading latency comparisonwarning
Lambda backend delays when IntegrationLatency equals Latencywarning
API Gateway processing delays when IntegrationLatency is lowwarning
Lambda cold starts increase IntegrationLatencywarning
API Gateway integration latency exceeds 29 seconds causing 504 timeoutcritical
Lambda cold starts increase API Gateway integration latencywarning
REST API Gateway has higher latency than HTTP API Gatewayinfo
API Gateway returns 500 when proxying to ALB on port 80critical
X-Ray tracing underreports end-to-end API Gateway latencyinfo
JWT authorizer causes unexplained latency overhead in HTTP API Gatewaywarning
API Gateway IntegrationLatency spike causes 504 timeoutcritical
API Gateway integration timeout exceeds 29-second default limitcritical
API Gateway WebSocket body parameters not mapped to integration headerswarning
Microservice API latency exceeds SLA thresholdscritical