App Inspector
Introduction
Section titled “Introduction”App Inspector allows users to view, collect, and inspect data exchanges, including event payloads and metadata, between AWS services. It enhances system observability by displaying the data exchanged at every stage, facilitating clear understanding of event flows. It further centralizes debugging by enabling event replay at any system stage for detailed analysis and troubleshooting. In addition, it serves as a single point of truth to understand potential errors, service configuration mismatches and IAM permission issues.
With App Inspector, you can:
- Observe and understand the flow of events through your system.
- Identify errors and obtain detailed information for corrections.
- Get immediate feedback on any misconfigurations in your services.
- Gain insights into IAM policies and detect missing permissions.
- Enhance event contexts for advanced flow tracing.
Use Cases
Section titled “Use Cases”Debugging event routing failures
When an event doesn’t reach its intended target, App Inspector shows exactly where it stopped — a mismatched EventBridge rule pattern, an incorrect ARN, or a missing SQS event source mapping. You get a precise answer without deploying to AWS or adding instrumentation.
Verifying service-to-service payloads
Inspect the exact data passed between services at every hop of your workflow. This is especially useful for confirming that a Lambda is passing the right payload to SNS, or that an SQS message body matches what the downstream consumer expects — before it becomes a production issue.
Catching IAM misconfigurations early
Mocks return whatever you tell them to return, so they can’t surface permission errors. App Inspector runs against the real LocalStack emulator, which enforces IAM policies. Missing or overly restrictive permissions show up immediately, at the point of failure in the event chain.
LocalStack Toolkit for VS Code
Section titled “LocalStack Toolkit for VS Code”App Inspector is built into the LocalStack Toolkit for VS Code, so you can trace event flows and inspect payloads without leaving your editor. Once LocalStack is running, open the App Inspector panel directly in LocalStack Toolkit extension to view events, and drill into service interactions.
If you haven’t set up the toolkit yet, see LocalStack Toolkit for VS Code to get started.
Web Application
Section titled “Web Application”You can access App Inspector directly in the LocalStack Web Application. Navigate to App Inspector in your browser to view events captured from your running LocalStack instance, inspect payloads, and trace service connections.
Features
Section titled “Features”List the local events
Section titled “List the local events”With Event Studio, you can view a detailed list of events in your application, including event producers, types, and timestamps. The interface enables you to trace the flow of events, identify relationships between services, and analyze patterns for debugging or optimization.
View Event Details
Section titled “View Event Details”By clicking on an events details, you can visualize the relationships between AWS services in your event-driven architecture and drill down into the specifics of each interaction. App Inspector displays an interactive graph showing how services connect, alongside detailed payloads, metadata, and status for each operation. It also highlights errors, warnings, and potential IAM permission issues, enabling precise debugging and troubleshooting.
Plans & Tiers
Section titled “Plans & Tiers”| Feature | Hobby | Base / Ultimate / Enterprise |
|---|---|---|
| Maximum events stored | 10 | 1,000 |
| Error analysis | — | ✓ |
| Request payload | ✓ | ✓ |
| Response payload | — | ✓ |
Supported Services
Section titled “Supported Services”The following services are supported on App Inspector: