General guidelines

Please review the following guidelines if you're experiencing Crawler Errors in the Google Webmaster Tools Health Dashboard.

  • Monitor the performance and availability of your website directly to rule out any errors produced by your own web server. There are a number of free and paid services which you can use:
  • Do not block Google crawler IPs in the CloudFlare Threat Control Panel. Although subject to change, Google has been observed crawling from 66.249.64.0/19. Blocking IPs in this range, (66.249.64.0 - 66.249.95.255) will prevent Google from crawling your website.
  • Do not block the United States as a country in the CloudFlare Threat Control Panel. Many search engines are based in the United States and this will prevent them from crawling your website.
  • Do not block Google's User-Agents in your .htaccess, server configuration, robots.txt, or web application. Google may use a variety of User-Agents to crawl your website. Please review this list of common User-Agents Google uses when crawling your website. When making modifications, you can test your robots.txt file on the, "Blocked URLs page" under the, "Health" section in Google Webmaster Tools.
  • Do not allow crawling of files in the /cdn-cgi/ directory. This path is used internally by CloudFlare and Google will encounter errors when crawling it.

Troubleshooting

Troubleshooting steps for the most commonly reported errors are below. For anything not mentioned here, please follow the steps in the additional troubleshooting section and then open a support ticket.

HTTP 4xx Errors

"Google detected a significant increase in the number of URLs we were blocked from crawling due to authorization permission errors"

HTTP errors in the 400 range are the most common type of error users will see in Google Webmaster Tools Health Dashboard. Errors in this range indicate a request failure. CloudFlare acts as a messenger and delivers these errors from your web server to Google. These errors may be caused by something as simple as a missing page on your web server or a malformed link in your HTML. The solution will depend upon the problem encountered. Once you have identified and corrected the problem, Google will make additional attempts to crawl your website and errors will clear automatically.

HTTP 5xx Errors

HTTP errors in the 500 range, indicate that CloudFlare or your web server experienced an internal error. Unfortunately, the Google Webmaster Tools Health Dashboard provides a limited diagnostic view into these kinds of errors. If your web server is producing errors in the 500 range, it can be challenging to isolate these errors from errors that CloudFlare may be producing. It's very important to report these errors to CloudFlare as soon as they are detected. CloudFlare stores 7 days of error logs and Customer Support will have limited ability to troubleshoot if too much time has elapsed since the error occurred. The best solution is to monitor the health of your web server to help correlate dates of any outages with dates of errors.

Increased "Time spent downloading a page"

Please open a Support Ticket if you are experiencing increased page download times after enabling CloudFlare. Please include the diagnostic output that the process below will generate in your inquiry.

  1. Login to your Google Webmaster Tools account and navigate to the Health section of the affected domain.
  2.  Click, "Fetch as Google" in the left hand navigation.

Screen_Shot_2013-02-26_at_1.09.52_PM.png

3. Type, "cdn-cgi/trace" in lowercase in the form field and then press, "FETCH".

Screen_Shot_2013-06-19_at_12.35.49_PM.png

4. Click, "Success" under the, "Fetch Status" column.

Screen_Shot_2013-06-19_at_5.28.20_PM.png

5. Copy all of the text in the grey area and submit this to Customer Support.

Screen_Shot_2013-06-19_at_12.33.02_PM.png

DNS Errors

"Over the last 24 hours, Googlebot encountered number errors while attempting to retrieve DNS information for your site. The overall error rate for DNS queries for your site is percent."

Most DNS failures will be handled gracefully by browsers and your visitors will not be impacted. Steps for further troubleshooting will vary depending on how your CloudFlare service is configured. CloudFlare can be enabled either through usage of a CNAME or through zone delegation. If you are using CloudFlare through a hosting provider, you are likely using a CNAME setup.

To verify which configuration you're using, open a terminal and execute the following command. Replacewww.example.com with your domain registered with CloudFlare.

dig +short SOA www.example.com

If you get output from the command similar to the text below, you are using a CNAME setup. Please proceed to the CNAME section.

example.com.cdn.cloudflare.net.

If you get output from the command similar to the text below, you are using CloudFlare through zone delegation. Please proceed to the Delegation section.

josh.ns.cloudflare.com. dns.cloudflare.com. 2013050901 10000 2400 604800 3600

CNAME

In a CNAME setup, your hosting provider is primarily responsible for your DNS service. In order to investigate DNS errors, you will need to contact their Technical Support Team. Provide them with the date that Google encountered DNS errors to help with their investigation. Additionally, you should view the CloudFlare System Status page and observe any network outages on the date the errors were encountered by Google.

Delegation

At all plan levels, CloudFlare will provide at least two authoritative name server records for your domain. Browsers and Operating System APIs handle failure of all but one of these nameservers gracefully without exposing an error to your visitors. If Google reports DNS errors to you often, please open a Support Ticket and provide the date and time that Google observed the errors.

Additional troubleshooting

Follow the following steps below to export crawler errors as a .csv file from your Google Webmaster Tools Dashboard. Please include this file when reporting errors to our Technical Support Team.

  1. Login to your Google Webmaster Tools account and navigate to the Health section of the affected domain.
  2. Click, "Crawl Errors" in the left hand navigation.
  3. Screen_Shot_2013-06-19_at_1.42.54_PM.png

  4. Click, "Download" to export the list of errors as a .csv file.
    Screen_Shot_2013-06-19_at_5.35.46_PM.png
  5. Attach the downloaded .csv file to the Support Ticket