Getting StartedSetupAccount Setup & AnalyticsAnalytics

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.

Screenshot-Origin images vs renders example

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.

Screenshot-Total bandwidth example

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.

Screenshot-Daily vs cumulative stats example

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.

Screenshot-Video Analytics Example

Downloadable Reports

If you are a Premium account with the Reporting API enabled, you can download a daily usage report in the Reports tab.

Screenshot reporting tab

The report types and examples can be found below:

TypeDescription
cdn_logsContains 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_analyticsContains metrics for each Origin Image accessed that day. Includes the number of requests and errors generated by each Origin Image URL. Example file.
mild_errorsContains data related to 4xx-level errors per image. Example file.
source_analyticsContains 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.