Analytics
The Analytics section of the Imgix dashboard offers usage statistics for your account and Imgix’s service health, which updates every hour. You can use these to gauge your site or app’s monthly usage. For definitions of the terms, click the (?) icons in each section or check out the Glossary.
Here are some basic concepts to understand about Imgix’s analytics.
Origin Images vs. Renders
Origin Images are your original assets, stored on your servers or another web host such as Amazon S3. Renders (or derivative images) are the images we deliver to your users after our API parameters are applied via the rendering api. Each unique variation of an image counts as a render, so you should expect to see more renders than Origin Images, given that you may be delivering the same asset with different parameters depending on your user’s context.
Under our current pricing, we only charge for the requested Origin Images and don’t charge for creating derivatives. The counter for Origin Images resets at the beginning of each month, so you should expect to see a spike then as Origin Images are requested for the first time and counted.
Total Bandwidth
Though we don’t charge to create derivative assets, we charge for the bandwidth necessary to deliver them to your end users (Total Bandwidth) on some pricing plans. This includes the bandwidth to request the derivative asset from Imgix’s rendering engine into the CDN (Render Bandwidth), cache it, and then deliver the derivative from the CDN to the user (CDN Bandwidth). Fetch Bandwidth is tracked on this page but not charged under our current pricing.
Daily vs. Cumulative Stats
We provide two modes for displaying your monthly usage stats so that you have a clear picture of your usage at different levels of granularity: daily totals and day-over-day cumulative totals. Daily stats can show you where you have usage spikes throughout the month (helpful in tracking how your website changes affect usage), and cumulative stats show you the general trend of your usage from the beginning to the end of the month.
Error Calculation
We want only to log actionable errors in your analytics dashboard. As a result, errors are only recorded if the Origin image has been successfully requested at least once. If an original image has never been successfully rendered, we treat it as if it did not exist.
Additionally, we use de-duplication to ensure that the same error is not counted multiple times over a short period. For example, if a user receives a 404
and refreshes or requests the same image 10 times over a 5-minute period, it will only be logged as one error.
For more information on error status codes, see our HTTP status code documentation.
Video Analytics
If video is enabled for your Source, monthly stats for all videos served through Imgix using our Video API will be displayed. Analytics for video is broken down into Total Video Encoded, Total Minutes Encoded, Total Video Delivered, and Total Minutes Delivered.
Downloadable Reports
If you are a Premium account with the Reporting API enabled, you can download a daily usage report in the Reports tab.
The report types and examples can be found below:
Type | Description |
---|---|
cdn_logs | Contains daily logs for requests made to our CDN for your images. Includes information such as referrers, user agents, cache hits/misses per image, and more. Example file For the referers and user_agent column, blank values indicate that there was no referer or user-agent data sent to Imgix. |
image_analytics | Contains metrics for each Origin Image accessed that day. Includes the number of requests and errors generated by each Origin Image URL. Example file. |
mild_errors | Contains data related to 4xx -level errors per image. Example file. |
source_analytics | Contains cumulative metrics for each Source. Includes information regarding total Origin Images, total bandwidth, average response times, and more. Example file. Since this report is cumulative, the report generated for July 31 will have Source analytics for that entire month. The report generated for July 15 will have the July Source analytics up to that day. |