IPFS KPIs

IPFS KPIs #

Please note that this website is a preview and is subject to change at any time. We strive to provide accurate and up-to-date information, but we cannot guarantee the completeness or reliability of the information presented during the preview.

IPFS relies on the coordinated participation of a swarm of independent peers to function correctly. Therefore, measuring the performance and health of the network is crucial for ensuring its reliability and efficiency. In this context, we summarise a number of network characteristics as key performance indicators. Our KPIs are currently focusing primarily on the public IPFS DHT (although we do report on other parts of the architecture too). Understanding that IPFS is an ecosystem of content routing subsystems, over time, we plan to expand to other content routing subsystems too.

Network Size & Stability #

Client vs Server Node Estimate #

The total number of peers in the network is estimated using the number of unique Peer IDs seen by Protocol Labs' bootstrap nodes. The number of unique DHT Server peer IDs identified by the Nebula crawler is then subtracted from the total number of peers (seen by the bootstrappers) to estimate the number of peers that exclusively function as DHT Clients.

Mar 122023Mar 26Apr 9Apr 23May 7May 21Jun 4Jun 18050k100k150k200k250k300k
DHT Server IP AddressesDHT ClientsDHT ServersData: 12 Mar 2023 to 18 Jun 2023. Sources: Bootstrap+preload server logs; Nebula.Number of unique peers
Copy Link to Plot

Unique Software Agents #

The total number of unique software agents operating in the network is estimated from those seen by Protocol Labs' bootstrap nodes when a peer connects. The number of unique agents seen by the Nebula crawler when crawling the IPFS DHT is included for comparison. The software agent strings have not been refined or processed, resulting in the count treating major and minor versions of each software agent as distinct entries.

Mar 132023Mar 20Mar 27Apr 3Apr 10Apr 17Apr 24May 1May 8May 15May 22May 29Jun 5Jun 12Jun 19020040060080010001200
Bootstrap Unique AgentsDHT Unique AgentsData: 12 Mar 2023 to 18 Jun 2023. Sources: Bootstrap+preload server logs; Nebula.Number of unique agents
Copy Link to Plot

Content Routing #

IPFS employs several content routing subsystems, with the Kademlia Distributed Hash Table (DHT) being the most established. Within the network, peers commonly use this system to locate other peers that hold the content being requested. We measure the availability of DHT server nodes and the latency of DHT lookups for random content.

DHT server availability #

We categorize DHT Server nodes with regard to their “availability” as follows:

  • “Online”: the node has been found online for 80% of time or more.
  • “Mostly Online”: the node has been found online between 40%-80% of time.
  • “Mostly Offline”: the node has been found online between 10%-40% of time.
  • “Offline”: the node has been found online less than 10% of time.

Data is collected using the Nebula crawler.

DHT Server Availability #

27.33k▼−1.07%Online1714▲17.64%Mostly Online2188▲11.63%Mostly Offline6.81k▼−6.58%OfflineData: week ending 18 Jun 2023. Source: Nebula.
Copy Link to Plot

DHT Server Availability, classified over time #

Mar 122023Mar 26Apr 9Apr 23May 7May 21Jun 4Jun 1805k10k15k20k25k30k35k40k
OfflineMostly offlineMostly onlineOnlineData: 5 Mar 2023 to 18 Jun 2023. Source: Nebula.
Copy Link to Plot

DHT Lookup performance #

We use Parsec to capture the DHT Lookup performance over time and from several different geographic locations. In this section we present the average performance over all regions.

DHT Lookup Performance #

0.546s▼−2.53%Median1.13s▲0.21%P901.573s▲2.51%P99Data: 18 Jun 2023. Source: Parsec.
Copy Link to Plot

Historic DHT Lookup Performance #

The historic trend over time is currently provided by Parsec. Before 21 April 2023 an older script was used that queried IPFS preload servers to measure DHT lookup performance.

Jan 2022Mar 2022May 2022Jul 2022Sep 2022Nov 2022Jan 2023Mar 2023May 202300.20.40.60.811.21.41.6
historicparsec3m6m1y18mallData: 12 Feb 2021 to 18 Jun 2023. Source: Legacy monitoring script and Parsec.Lookup time, 6 day rolling average (seconds)
Copy Link to Plot

IPNI utilization #

IPNI is a set of protocols that describe how data can be indexed across the IPFS and Filecoin networks. Network indexers complement the IPFS DHT to enable peers to locate content-addressed data. The data in the plot below shows the number of requests made per day to the network indexers operated by cid.contact.

Mar 262023Apr 9Apr 23May 7May 21Jun 4Jun 18020M40M60M80M100M
Data: 20 Mar 2023 to 18 Jun 2023. Source: contact.cid prometheus metrics.Number of requests
Copy Link to Plot

Websites #

A common use-case for IPFS is hosting websites, addressed using IPNS or DNSLink. We monitor the time it takes to load sample websites using the Tiros monitoring tool.

Time to First Byte for IPFS Hosted Websites #

0.528s▲1.69%Median1.177s▼−3.17%P902.108s▲0.01%P99Data: 18 Jun 2023 (KUBO, ttfb). Source: Tiros.
Copy Link to Plot

HTTP Gateway Usage #

Gateway Requests #

The following plot shows the total number of requests made per day to the public IPFS gateways operated by Protocol Labs (ipfs.io and dweb.link). Data is collated from nginx access logs that front the gateway infrastructure.

Mar 262023Apr 9Apr 23May 7May 21Jun 4Jun 18050M100M150M200M250M
Data: 20 Mar 2023 to 18 Jun 2023. Source: ipfs.io / dweb.link access logsNumber of requests
Copy Link to Plot
Last published on 19 Jun, 2023 at 8:58am