StormCrawler is a web crawler that uses an Elasticsearch module to create a winning combination for their users.

This is one in an occasional series of community-generated stories developed from our <a href="https://twitter.com/search?q=%23elasticstories&src=typed_query">#ElasticStories</a> campaign. 
<a href="http://stormcrawler.net/">StormCrawler</a> is a popular and mature open source web crawler. It is written in Java and is both lightweight and scalable, thanks to the distribution layer based on <a href="https://storm.apache.org/">Apache Storm</a>. One of the attractions of the crawler is that it is extensible and modular, as well as versatile. In this blog we will have a closer look at the Elasticsearch module of StormCrawler and see how it is being used in production by various organisations, sometimes on a very large scale.
<h2>Elasticsearch module in StormCrawler</h2>My personal journey with Elasticsearch began more than ten years ago when I met Shay Banon at a conference. Shay was giving a talk on a relatively new project he had recently started, which a customer asked me to evaluate shortly after. Elastic has since become one of the leaders in open source search solutions and one of my favourite projects to work with. Naturally, it soon found its place in my own web crawling project, StormCrawler.
An obvious use of a web crawler is to provide documents to index to a search engine and, with Elastic being one of the leading open source tools for search and analytics, we needed a resource in StormCrawler to achieve this. The <a href="https://github.com/DigitalPebble/storm-crawler/blob/master/external/elasticsearch/src/main/java/com/digitalpebble/stormcrawler/elasticsearch/bolt/IndexerBolt.java">IndexerBolt</a> in the Elasticsearch module takes a web page fetched and parsed by StormCrawler and sends it for indexing to Elasticsearch. It builds a representation of a document containing of course its URL and the text extracted by the parser but also any relevant metadata extracted during the parsing, such as the title of the page, keywords, summary, language, hostname, etc. StormCrawler comes with various resources for data extraction which can be easily configured or extended. The fields generated end up in the Elasticsearch index — and thus we have a search engine with powerful use cases described below.
What differentiates StormCrawler from other web crawlers is that it uses Elasticsearch as a back end for storage as well. Elasticsearch is an excellent resource for doing this and provides visibility into the data as well as great performance. The Elasticsearch module contains a number of spout implementations (a spout is a Storm component which emits tuples, or finite sequences of elements, down a processing topology) which query the status index to get the URLs for StormCrawler to fetch. The illustration below shows the main steps in a StormCrawler topology.
<img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt56e2eaeafc3303dc/5d5ea8e465c1577f11a49bc8/stormcrawler-topology-blog.png" data-sys-asset-uid="blt56e2eaeafc3303dc" alt="StormCrawler topology" style="display: block; margin: auto;">
Finally, StormCrawler also uses Elasticsearch for indexing the metrics provided by Apache Storm, both internal ones coming from Storm itself and metrics implemented in StormCrawler such as the number of pages fetched per minute or average amount of time spent querying Elasticsearch in the status spout. Once indexed in Elasticsearch, these metrics can be displayed in Kibana (see illustration below) and help monitor the behaviour of the crawler in production.
<img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/bltd61c411c4764fd7c/5d5ea9a5ac511e7362584f06/stormcrawler-metrics-blog.jpg" data-sys-asset-uid="bltd61c411c4764fd7c" alt="StormCrawler metrics" style="display: block; margin: auto;">
￼The Elasticsearch module in StormCrawler contains a number of dashboards and visualisations for Kibana, which users can easily import and further customise to their heart's content.
<h2>Use cases</h2>Below are a few use cases which illustrate the use of Elasticsearch and Kibana with StormCrawler, in various domains and scales.
<h3>Search portal</h3>The <a href="https://www.gov.nt.ca/">Government of Northwestern Territory</a> (Canada) have replaced their search system based on Google Search Appliance with a combination of StormCrawler and Elasticsearch. The search front end (below) queries Elasticsearch indices and uses aggregations to filter the result sets across several dimensions.
<img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt87dc1c89e20779ba/5d5ea9c75b220072e8aa32f6/stormcrawler-frontend-blog.jpg" data-sys-asset-uid="blt87dc1c89e20779ba" alt="StormCrawler frontend" style="display: block; margin: auto;">
The web sites are crawled with StormCrawler, using Elasticsearch as a back end for storing the information about the URLs. StormCrawler has been configured to extract various information from the pages to fine tune the relevance of the results such as the title, headers, etc., as well as identify the language of the pages.
The combination of StormCrawler and Elasticsearch has made it possible for a public organisation to build a low-cost and robust search engine in a relatively short amount of time.
<h3>Web archiving</h3><a href="http://commoncrawl.org/">Common Crawl</a> is a non-profit organisation that crawls the web and freely provides its archives and datasets to the public. Common Crawl's web archive consists of petabytes of data collected since 2008 and is available in the Registry of Open Data on AWS.
Alongside the main dataset, which is released monthly, Common Crawl provides a news dataset which is continuously produced, as announced on their blog <a href="http://commoncrawl.org/2016/10/news-dataset-available/">News Dataset</a> Available in 2016.
As of May 2019, the dataset consisted of
<ul>
	<li>220 million pages in total</li>
	<li>5.5 TiB WARC files</li>
	<li>8 to 10 million pages per month from</li>
	<li>12,000 domains</li>
	<li>200 top-level domains</li>
	<li>over 100 languages</li>
</ul>StormCrawler crawls the news sites using the spout and status update from the Elasticsearch module to store the information about the URLs. Unlike the search application described previously, the topology for the news crawl does not parse the documents or index them but stores them in AWS S3 using the <a href="https://en.wikipedia.org/wiki/Web_ARChive">WARC</a> format, which is the standard format used by the web archiving community.
Sebastian Nagel from CommonCrawl explains that they’ve been able to build a crawler which they have now been running for almost three years with minimal maintenance efforts and on cheap hardware. Their main challenge was to not miss recently published articles from any of the 10,000 crawled new sites.
“The streaming crawler approach in combination with Elasticsearch made it possible to keep track of 100,000s of news feeds and sitemaps and adapt to their update frequencies,” Nagel says. “The Elasticsearch status index also allows for quick insights and aggregations, really helpful for detecting and analyzing crawler issues and to ‘steer’ the crawler into the right direction.”
<h3>Large-scale crawling of photos </h3><a href="https://pixray.com/">Pixray</a> are experts in image tracking on the web. They work for image rights holders to protect their pictures on the web as well as brands and manufacturers to monitor sales channels. Their customers range from news agencies and picture agencies, individual photographers, e-commerce companies to luxury brands. Web crawling is one of the core building blocks of Pixray’s platform — next to a massive picture matching platform, various APIs and our customer portals.
Pixray does three kinds of scans: broad scans across complete regions of the web (like the EU or North America), deep scans on single domains and also near-real time discovery scans on thousands of selected domains. For all of these different scans, they employ customized versions of StormCrawler to match the very distinct requirements in crawling patterns. Obviously, the biggest crawls are the broad regional scans, including more than 10 billion URLs and tens of millions of different domains.
Elasticsearch is used as a status backend with Kibana to explore the content of the status index and has shown its scalability when dealing with such large amounts of data.
<a href="http://digitalpebble.blogspot.com/2019/02/meet-stormcrawler-users-q-with-pixray.html">Mike Piel</a>, CTO of Pixray, explains that, before moving to StormCrawler, they initially built their web crawler on Apache Nutch. Though it’s a great and robust platform, once a certain point of growth was reached, limitations started to appear. The main limitation was the low responsiveness to changes and the uneven system utilization due to the long generate/crawl/update cycles. They would sometimes take up to 24 hours or more before they could see the effect of a change they made in their software. In addition to this, they found it troublesome to obtain valid statistical data from Nutch in real-time. They would have to run analysis jobs of around 4 hours even if they just needed the status of one single URL. “StormCrawler and the Elastic Stack solve all that for us. Every configuration or code change that we commit shows its effect immediately and you get statistics very, very easily. There is no long-cycle batching anymore reducing our need for massive queuing of results to ensure an even utilization of down-stream infrastructure,” Piel says. “Kibana also gives us great real-time insights into the crawl database.”
As illustrated by the use cases, StormCrawler and the Elastic Stack are a winning combination. StormCrawler uses Elasticsearch to store the information about the URLs crawled and then ultimately to provide a search functionality on the documents crawled. The combination of both projects allows for tailor-made crawl solutions at a low cost, with great performance, even on a very large scale. The maintenance of the crawlers is made easier thanks to the visibility into the data provided by Kibana — for instance to monitor the custom metrics coming from Apache Storm, which is the perfect complement to <a href="https://www.elastic.co/beats/metricbeat">Metricbeat</a>.
The Elasticsearch module in StormCrawler gets constantly improved as it is very popular. One possible addition for a future release would be an implementation of a <a href="https://storm.apache.org/releases/2.0.0/Metrics.html">MetricsConsumer</a> for the new version of the Storm metrics API. This could in fact be a separate project as it would appeal to users of Apache Storm who don’t necessarily need StormCrawler but want to send their Storm metrics to an Elasticsearch index, typically to display with Kibana.
In the meantime, if you want to give StormCrawler a go and see how to use it with Elasticsearch, the tutorials on <a href="https://www.youtube.com/channel/UCUuzkdeQV-XEPUq53bH_b5A">DigitalPebble’s channel</a> are a good starting point.
Happy crawling!
<hr><table style="border: 0px; border-collapse: collapse;">
<tbody>
<tr>
	<td style="border: 0px; border-collapse: collapse; width: 30%; vertical-align: middle;"><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt4844f97614384bca/5d5ea9f6d47d0742ac772ff5/stormcrawler-julien-nioche.png" data-sys-asset-uid="blt4844f97614384bca" alt="Julien Nioche" width="200" height="200" style="width: 200px; height: 200px; margin: 0px; float: left;">
	</td>
	<td style="border: 0px; border-collapse: collapse; width: 70%; vertical-align: middle;">Julien Nioche works for <a href="https://www.cameraforensics.com/">CameraForensics</a> and lives in Bristol, UK. He is a committer and contributor to various open source projects. Julien is the author of <a href="http://stormcrawler.net/">StormCrawler</a> and a long-time user of Elasticsearch, which he used for various customers of his <a href="http://digitalpebble.com/">consultancy</a>. When not coding or playing with his kids, he’s either on his Telecaster or woodworking.
	</td>
</tr>
</tbody>
</table>

ElasticStories_Blog Header - 2000x415.png

Stormcrawler-thumbnail.jpg

StormCrawler open source web crawler strengthened by Elasticsearch, Kibana

Start free trial

Blog Footer CTA

Sign up for Elastic Cloud free trial

Julien Nioche

By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_self">Terms of Service</a>, and you agree to receive the <a href="/legal/privacy-statement#how-we-use-the-information" target="_self">selected communications</a> at the contact details you provided above. See <a href="/legal/privacy-statement/" target="_self">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Communication Preferences - ONLY for /communication-preferences

提交即表示您确认您已阅读并同意我们的<a href="/cn/legal/elastic-cloud-account-terms" target="_self">服务条款</a>，并且您同意通过您提供的上述联系方式接收<a href="/cn/legal/privacy-statement#how-we-use-the-information" target="_self">所选的通信</a>。如需了解更多信息，或想随时取消订阅，请参阅 <a href="/cn/legal/privacy-statement/" target="_self">Elastic 的隐私声明</a>。

By submitting you acknowledge that you've read and agree to our <a href="/legal/serverless-preview-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Serverless GDPR Text

提交即表示您确认您已阅读并同意我们的<a href="/cn/legal/serverless-preview-terms" target="_self">服务条款</a>，并且 Elastic 可以使用您提供的上述详细信息与您联系，以向您介绍我们相关的<a href="/cn/legal/privacy-statement#how-we-use-the-information" target="_self">产品和服务</a>。如需了解更多信息，或想随时取消订阅，请参阅 <a href="/cn/legal/privacy-statement/" target="_self">Elastic 的隐私声明</a>。

By submitting you agree to <a href="/agreements/global/cloud-services-monthly" rel="nofollow">Elastic Cloud Terms of Service</a>. Your personal data will be processed in accordance with <a href="/legal/privacy-statement">Elastic's Privacy Statement</a>.

Cloud Trial GDPR Text

提交即表示您同意 <a href="/cn/agreements/global/cloud-services-monthly" rel="nofollow">Elastic Cloud 服务条款</a>。我们将会按照 <a href="/cn/legal/privacy-statement">Elastic 的隐私声明</a>处理您的个人数据。

By submitting you acknowledge that you've read and agree to our <a href="/legal/terms-of-use" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Newsletter GDPR Text

提交即表示您确认您已阅读并同意我们的<a href="/cn/legal/terms-of-use" target="_self">服务条款</a>，并且 Elastic 可以使用您提供的上述详细信息与您联系，以向您介绍我们相关的<a href="/cn/legal/privacy-statement#how-we-use-the-information" target="_self">产品和服务</a>。如需了解更多信息，或想随时取消订阅，请参阅 <a href="/cn/legal/privacy-statement/" target="_self">Elastic 的隐私声明</a>。

Explore similar demos

Overview

Speakers

Close

See more insights

The content on this page is not available in the selected language. As Elastic grows globally, we continue to support content in multiple languages.

The content on this page is not available in the selected language.

本页内容尚不支持所选语言。Elastic 正在不断努力，以实现对多种语言内容的支持。感谢您在此期间给予的耐心与陪伴！

Author

Articles by

Learn more

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

Share this story

Share by Email

Thank you for your interest!

Contact Info

Follow us on Youtube

Load More

Share on LinkedIn

Follow us on LinkedIn

Search Integrations

All Solutions

Video for

Follow us on Twitter

See when this webinar starts in my time zone

查看本次网络研讨会在我的时区的开始时间

Register to Watch

Register now

See All Posts

Can't make it? Register and we'll send you the recording. You'll also receive an email with related content

无法实时参加？注册后我们会给您发送录像。您还将收到相关内容的电子邮件。

Author

Articles by Julien Nioche

StormCrawler open source web crawler strengthened by Elasticsearch, Kibana

Sign up for Elastic Cloud free trial