Traffic Explorer
Traffic Explorer in Contentstack Analytics provides a granular, near real-time view of your API request logs. Other Analytics dashboards report aggregated metrics; Traffic Explorer shows the individual requests behind those metrics.
Use Traffic Explorer to trace a specific request, confirm what a client actually sent, and investigate error spikes without raising a support ticket.
Note Traffic Explorer is currently available in the AWS North America and AWS Europe regions only, and is not enabled by default for every organization. If you do not see it in Analytics, contact support to have it enabled for your organization.
Prerequisites
- Contentstack account
- Organization Owner, Admin, or Product Analytics Viewer role, or a custom role for Administration with view access to Analytics
- Traffic Explorer enabled for your organization
What You Will Learn
- How to open the Traffic Explorer dashboard.
- What Traffic Explorer records and what it deliberately does not record.
- How to filter logs, set a date range, and save a view for reuse.
- How to export the filtered log results to CSV.
When to Use Traffic Explorer
Use Traffic Explorer when you need request-level detail:
- Diagnose a failing request. Find the exact request by status code, URL, or client IP, and read its timestamp, method, and response time.
- Investigate a traffic spike. Filter by host, environment, or country to see which clients drove an unexpected increase.
- Verify usage against your bill. Confirm which requests counted toward your API request and bandwidth consumption.
Use the product-specific dashboards, such as Analytics for CMS or Analytics for Launch, when you need trends and totals rather than individual requests.
Access the Traffic Explorer Dashboard
To open the Traffic Explorer dashboard, sign in to your Contentstack account and perform the following steps:
- Open the App Switcher and select Analytics.
- By default, the CMS analytics dashboard appears. Click Traffic Explorer to switch dashboards.
What Traffic Explorer Records
Traffic Explorer currently logs requests served for images, assets, CDN, and GraphQL. Support for additional products is planned for future releases.
Each log entry records request metadata: timestamp, host, URL, method, status code, response time, request and response size, cache status, client IP, country, HTTP user agent, request referrer, API key, environment, and project.
Note Traffic Explorer records request metadata only. Request and response payloads are not captured and are not visible in the dashboard.
Data Freshness and Retention
Traffic Explorer is near real time rather than instantaneous, because logs are collected from the CDN in batches and processed before they become searchable.
- A request appears in Traffic Explorer within 15 to 20 minutes of being made.
- Traffic Explorer processes a high volume of data, so results can sometimes take around 10 seconds to load after you apply a filter or a query.
- Logs are retained for the last 7 days. Older data is deleted and cannot be recovered.
Tip To keep a record beyond 7 days, capture the details you need while the logs are still available.
Apply Filters and Manage Views
Filters narrow the log view to the requests you care about. You can combine multiple filters in a single query.
Add a Filter
- Click Filters in the upper-right corner.
- Choose a condition from the dropdown, such as Status Code, URL, or Country.
- Enter a value for that condition, for example, Status Code = 200.
- Click Apply Filter(s).
Available Filters
| Filter | Narrows results by |
| Host | The host that served the request |
| URL | The requested path |
| Status Code | The HTTP response code |
| Method | The HTTP method, such as GET or POST |
| Services | The Contentstack service that handled the request |
| Response Size | The size of the response |
| Request Size | The size of the request |
| Response Time | How long the request took |
| Cache | Whether the response was a cache HIT or MISS |
| Client IP | The IP address the request came from |
| Country | The country the request originated in |
| HTTP User Agent | The client that made the request |
| Request Referrer | The referring URL |
| API Key | The stack the request targeted |
| Environment | The environment the request targeted |
| Project | The project the request targeted |
Set the Date Range
Use the date selector to view results for a specific period within the last 7 days.
- Click the date range dropdown in the upper-right corner.
- Choose a preset, such as Last 4 hours, Last 24 hours, or Last 7 days, or select Custom Date.
- For a custom range, enter both the From Date/Time and the To Date/Time.
- Click Done to apply the range.
Note You can select dates only from the most recent 7 days, as data older than 7 days is not retained.
Save a Filtered View
Save a set of filters so you can reapply it without rebuilding the query each time.
- Apply the filters and date range you want to keep.
- Click the horizontal ellipsis (...) next to the filter bar.
- Select Save As New View.
- Enter a name and save the view.
The saved view appears in the dropdown so you can reapply it later.
Export Log Results
Export the current log view to a CSV file to analyze it outside Contentstack or to attach it to a support ticket.
- Apply the filters and date range you want to export.
- Click the Export CSV icon in the upper-right corner, next to the date range selector.
- Save the CSV file when your browser prompts you.
Note The export contains only the requests that match your current filters and date range, and is limited to 1,000 rows per file. To export a larger result set, narrow the date range or the filters and export each set separately.
Additional Resource To learn how Analytics brings usage data together across products, refer to the About Analytics document.