Skip to main content
Last Reviewed: April 03, 2023

Metrics in the Site Dashboard

Measure your site's traffic with the Metrics tool, found in the Live environment of the Site Dashboard.

Access Metrics through the Live tab of the Site Dashboard once a Live environment has been initialized. The number of unique visits displayed in Pantheon’s Site Dashboard determines the traffic Pantheon will apply for evaluating use on your site under your pricing plan. The Site Dashboard also includes other information you may use to project future traffic, including number of pages served.

To access metrics for another environment, use the Terminus metrics command:

terminus metrics <site>.<env>

Access Metrics

  1. Navigate to the Live environment of the Site Dashboard.
  2. Click Metrics.
  3. Toggle displayed date ranges by clicking Day, Week, or Month: Charts for pages served and visits within the Metrics tool of the Site Dashboard

Available Metrics

The number of unique visits displayed in Pantheon’s Site Dashboard represents the traffic measurement Pantheon will apply for evaluating use on your site under your pricing plan. The Site Dashboard also includes the number of pages served, to help evaluate trends, and project future traffic. Traffic information is refreshed daily.

The data comes directly from our Global CDN, which tracks all requests for resources on Pantheon. However, many known bots and crawlers do not count towards site traffic limits, nor do we meter requests for static assets (images, PDFs, CSS, JS, etc.).


A visitor is a person or device who/that receives information from the site. The platform counts each visitor once per day, regardless of the number of times they return that day or the number of pages they visit that day.

Site Visits

We consider a Site Visit as a 200-level (and some 300-level

) response code in response to a visitor, and we identify unique consumers as a combination of user agent (device/browser) and IP address (network source), as shown in the diagram below.

Pages Served

Think of this as something that gets delivered to the visitor. Pages served is the number of requests for resources generated by the CMS (WordPress or Drupal). Most commonly these are HTML web pages, but they also include non-HTML resources such as JSON, RSS, or XML-RPC. These are typically used for bringing data into the site from another source (e.g., a list of places on a map).

The number of Pages Served allowed for each Site Plan is five times the maximum monthly Site Visits.

For both metrics, the platform counts based on the total volume of requests, which includes visitors receiving pages (or other CMS-generated resources) which are served from our Global CDN cache.

Diagram demonstrating how pages served and visits are tracked

As shown here, visits and visitors have different meanings. If two visitors go to the site, and one opens another page but the other leaves, that would be tracked as two visitors and three pages served. If one of those visitors returns again the next day, it would be counted as two visitors, three visits, and four pages served.

Cache Hit Ratio

An important performance benchmark is the number of requests that can be served from the Global CDN. This metric does not affect site traffic measurements for the Site Plan. Serving requests from cache rather than by the CMS allows visitors to experience a faster response and removes load from the site's server resources. A cached request is served from the nearest edge endpoint without any delay, while a request to the CMS must be individually processed and loaded. A high cache hit ratio greatly improves the browsing experience and site performance.

A low Cache Hit Ratio may be caused by:

  • Sites with mainly authenticated traffic have a low cache hit ratio because authenticated traffic is never cached. This includes both logged in site users as well as admin actions.
  • A low or missing max-age header in the response from the CMS. This means cached pages are not stored or are invalidated too quickly. You may view this header and others with the Configure and Verify Edge Caching guide.
  • Setting a cookie on page requests bypasses the GCDN cache. Refer to Debugging Cookies and Global CDN for more information.

Learn more about how to enable and improve caching in the Pantheon Global CDN guide.

How Do You Know if a Visit Counts?

Counted Visits

A visit counts if it is one of the following:

  • Valid

  • Not a known bot

  • Returns a 200-level response that originates from PHP, or returns a 300-level response of 303, 304, or 305.

  • Additionally, if that visit is from a unique IP and user agent combination for the day, then that counts as a unique visitor that day as well.

Uncounted Visits

The traffic measurement model below describes interactions excluded from your site's visit count. Our exclusion metric model relies partly on customer feedback. Contact support to request that Pantheon consider additional exclusions if you experience issues with your site.

A visit does not count if it is one of the following:

  • Invalid (originating from a known bot or crawler)

    • A high-performance response to crawlers supports SEO, which is one of the reasons Pantheon is the platform of choice for our customers. Although it places load on the platform, Pantheon excludes select automated traffic from legitimate crawlers and bots that would otherwise count towards your website's total traffic. Refer to the visits definition above regarding the combination of datasets to determine traffic metrics. Pantheon excludes certain activity on your Site Dashboard (e.g., Google bot user agent).

    • Some bots and crawlers present themselves as end-user browsers. This makes their behavior difficult to distinguish from human end users. Some bots exhibiting this behavior, while they claim to be regular browsers, remain distinctive enough to exclude from billing.

    • To block specific bots and crawlers from your site, add them to robots.txt or use PHP to block specific User Agents.

  • A non-unique or repeated IP address for a given day

  • A response from a static asset, such as images, PDFs, CSS, JS, etc.

  • Uses excessive bandwidth

    • Individual sites consuming excessive bandwidth may be contacted separately by Pantheon for monitoring and actions required to address any plan abuse.
  • A redirect

    • The platform does not count the following 300-level redirect responses: 301, 302, 307, 308.
  • A 404 or other client error

    • Client errors are returned as 400-level responses, and do not count as part of plan traffic limits.

Flowchart shows that traffic is only counted as a visit if the points above are satisfied and it loads successfully.

Frequently Asked Questions

How often is data collected?

Data is updated daily, shortly after midnight UTC, with data for the previous day.

How long do you keep the data?

Data is retained for the following amounts of time:

PeriodData Retention
Day28 days
Week12 weeks
Month12 months

Can I download or access the raw data directly?

Raw data is not currently available.

Why doesn't Pantheon's traffic match my analytics?

There are some inherent limitations with using an analytics suite (e.g., Google Analytics) when measuring site traffic. See Traffic Limits and Overages.

How does Pantheon handle overages?

All non-Basic plans come with free overage protection. Where there is a pattern of consistent overage, we will align a site's plans with its load on the platform. For details, see Traffic Limits and Overages.

What about bots?

Pantheon-identified bots are excluded from the Visits and Pages Served Metrics. See Traffic Limits and Overages for more information.

What about redirects?

Only requests with a 200-level status count as pages served, so 301 redirects will not be included in metrics. See Traffic Limits and Overages for more information.

Are multiple user agents on the same originating IP address counted separately?

Yes. For example, multiple devices on the same home network visiting your site would each be considered a unique visitor. See Traffic Limits and Overages for more information.

Can I check metrics from the command line with Terminus?

Yes! Access to metrics via the Terminus env:metrics command. Install Terminus or update to the current release for access to the env:metrics command.

More Resources