Technologies/LocalStack/localstack.service.errors

LocalStackMetric

localstack.service.errors

Service operation errors

Dimensions:None

Available on:

OpenTelemetry (1)

Interface Metrics (1)

OpenTelemetry

localstack.service.errors

Total number of errors encountered in AWS service operations

Dimensions:None

Sources

localstack.service.errorsdocs.localstack.cloud

Technical Annotations (85)

Configuration Parameters (9)

VisibilityTimeoutrecommended: 10

SQS queue retry delay for failed DynamoDB writes during outage

S3_HOSTNAMErecommended: localstack:4566

Default s3.localhost.localstack.cloud fails in container-to-container networking; use service name instead

AWS_ENDPOINT_URLrecommended: http://localstack:4566

LocalStack API endpoint for container-to-container communication

KINESIS_SHARD_LIMITrecommended: Infinity

Set to Infinity to disable limit for testing, or increase above 100 for realistic quotas

DYNAMODB_ERROR_PROBABILITYrecommended: 0.0

Disable random throttling errors in DynamoDB

KINESIS_ERROR_PROBABILITYrecommended: 0.0

Disable random throttling errors in Kinesis

integration_http_methodrecommended: POST

Required value for Lambda proxy integrations in API Gateway (AWS requirement)

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

Error Signatures (22)

ServiceUnavailableexception

Operation failed due to a simulated faultlog pattern

503http status

ServiceUnavailableExceptionexception

Service'dynamodb'not accessible in'us-east-1'region due to an outagelog pattern

dial tcp: lookup s3.localhost.localstack.cloud: no such hostlog pattern

dial tcp 127.0.0.1:4566: connect: connection refusedlog pattern

RequestError: send request failedlog pattern

ProvisionedThroughputExceededExceptionexception

Internal server errorhttp status

500http status

InternalServerErrorerror code

Internal Server Errorlog pattern

Error raised during invocation: Internal Server Errorlog pattern

No moto route for service apigateway on path /usageplans/<plan ID>/usage found.error code

exception while calling cloudwatch.GetMetricData: 'MetricStat'exception

KeyError: 'MetricStat'exception

InternalErrorerror code

AWS logs.StartQuery => 500 (InternalError)log pattern

TypeError: 'NoneType' object is not iterableexception

list index out of rangeexception

exception while calling cloudwatch.GetMetricData: list index out of rangelog pattern

CLI Commands (19)

curl --location --request POST 'http://localhost.localstack.cloud:4566/_localstack/chaos/faults' --header 'Content-Type: application/json' --data '[]'

remediation

awslocal sqs set-queue-attributes --queue-url http://localhost:4566/000000000000/ProductEventsQueue --attributes VisibilityTimeout=10

remediation

curl --location --request GET 'http://localhost.localstack.cloud:4566/_localstack/chaos/faults'diagnostic

awslocal s3 cp sample.csv s3://<your-bucket-name/>diagnostic

curl --location --request POST 'http://outages.localhost.localstack.cloud:4566/outages' --header 'Content-Type: application/json' --data '[{"service": "dynamodb", "region": "us-east-1"}]'

diagnostic

curl --location --request POST 'http://outages.localhost.localstack.cloud:4566/outages' --header 'Content-Type: application/json' --data '[]'

remediation

curl --location --request GET 'http://outages.localhost.localstack.cloud:4566/outages'diagnostic

awslocal dynamodb scan --table-name Productsdiagnostic

docker compose -f docker-compose.dev.yaml run --rm --entrypoint curl local_terraform_setup http://localstack:4566/_localstack/health

diagnostic

docker compose -f docker-compose.dev.yaml run --rm --entrypoint rm local_terraform_setup -f localstack_providers_override.tf

remediation

docker compose -f docker-compose.dev.yaml run --rm --entrypoint tflocal local_terraform_setup apply -auto-approveremediation

curl -v http://local-alb.elb.localhost.localstack.cloud/accounts/healthdiagnostic

curl -v https://50b2495d.execute-api.localhost.localstack.cloud:4566/local/accounts/healthdiagnostic

awslocal cloudwatch get-metric-data --metric-data-queries file:///path/to/metrics.json --start-time 2024-10-01T00:00:0000 --end-time 2024-10-01T23:00:0000

diagnostic

awslocal cloudwatch put-metric-data --namespace "service/my-service" --metric-name "request.count" --dimensions call_type=service_call --value 0.2

diagnostic

awslocal logs get-log-events --region=ap-south-1 --log-group-name local-log-group --log-stream-name local-log-streamdiagnostic

awslocal logs describe-log-groups --region=ap-south-1diagnostic

awslocal logs describe-log-streams --region=ap-south-1 --log-group-name local-log-groupdiagnostic

aws cloudwatch get-metric-data --endpoint-url http://localhost:4566 --start-time 2023-11-17T06:00:00+00:00 --end-time 2023-11-17T09:00:00+00:00 --metric-data-queries '[...]'

diagnostic

Technical References (35)

Chaos APIcomponent/_localstack/chaos/faultsfile pathdead-letter queuesconceptChaos DashboardcomponentOutages extensioncomponenthttp://outages.localhost.localstack.cloud:4566/outagescomponenttflocalcomponentProvider Overrideconceptlocalstack_providers_override.tffile pathDocker Compose networkcomponentaws_api_gateway_integrationcomponentLambda ProxyconceptAPI GatewaycomponentIAM permissionsconceptenvironment variablesconfigurationSNS topiccomponentSQS queuecomponentmulti-region replicationconcepteventual consistencyconceptAPIGW v2 HTTP Endpointcomponentlocalhost.localstack.cloudcomponentTwistedWebcomponentGetUsagecomponentmotocomponentusage plansconcepthealth-check API endpointcomponentMetricStatcomponentExpressioncomponentprovider_v2.pyfile pathREMOVE_EMPTYconceptSEARCHconceptStartQuerycomponentawslocalcomponentget-metric-datacomponentmetric-data-queriescomponent

Related Insights (15)

DynamoDB returns 503 ServiceUnavailable during chaos fault injectioncritical

▸

SQS returns 503 Service Unavailable causing Lambda message processing failurescritical

▸

DynamoDB service unavailable during outage injectioncritical

▸

Terraform apply fails with connection refused when LocalStack runs in separate Docker containercritical

▸

Kinesis operations fail when shard limit reachedwarning

▸

Random ProvisionedThroughputExceededException errors from error injectionwarning

▸

API Gateway accepts invalid GET method for Lambda proxy integrationwarning

▸

500 Internal Server Error prevents request fulfillment due to server-side failurescritical

▸

Service or region unavailability returns 503 errors causing application failurescritical

▸

API Gateway returns 500 when proxying to ALB on port 80critical

▸

Missing API Gateway GetUsage endpoint prevents local testingwarning

▸

Microservice health check endpoint unavailablecritical

▸

CloudWatch get-metric-data with Expression parameter fails with KeyErrorwarning

▸

CloudWatch Logs StartQuery API fails with TypeError when called from Grafanawarning

▸

CloudWatch get-metric-data fails with 10 or more metric queriescritical

▸