Blockscout
SupportWebsiteGithubDiscord
  • Blockscout Open-Source Explorer
  • 💡About BlockScout
    • Features
      • Ethereum Bytecode Database Microservice
      • Blockscout Redesign
    • Chains Using Blockscout
    • Partners & Integrations
      • RaaS Providers
      • Vera: Verifier Alliance
        • Adding your chain to the Vera database
        • Programmatic verification via the API
    • News & Media
      • Newsletter & Blog
    • Funding
      • L2 Funding Proposal
        • Aux Funding Images
    • Roadmap
  • 🙎Using Blockscout
    • Getting Started
      • Glossary of Terms
      • Main Menu
      • Blocks
      • Transaction Types
      • Beacon Chain Withdrawal Views
    • My Account
      • Watch list
      • Private tags
      • Public tags
      • API keys
      • Custom ABI
      • Verified addresses
        • Copy and Sign Message
      • For developers
    • Dappscout Apps Marketplace
      • DApp Integration
    • Swapscout
      • Earn Merits when using Swapscout
    • Revokescout
    • Autoscout Explorer Launchpad
    • CSV Exports
    • Token Support
      • ERC-1155 Support
    • Merits
      • Streak rewards
      • Activity Pass
      • Leaderboard
      • Badges
      • FAQs
  • 👩‍💻Developer Support
    • For Web3 Developers
    • Link to Blockscout
    • Blockscout APIs
      • Requests & Limits
      • REST API Endpoints
        • Stats API
        • Interpreter API
      • JSON RPC & ETH Compatible RPC Endpoints
        • Account
        • Block
        • Contract
        • Logs
        • Stats
        • Token
        • Transaction
        • ETH RPC API
      • GraphQL in Blockscout
    • Smart Contract Verification
      • Blockscout UI
      • Blockscout smart-contract verification API
      • Hardhat Verification Plugin
        • Sourcify Plugin for Hardhat
      • Foundry Verification
      • Sourcify Verification
      • OpenZeppelin Contract Verification
      • Automate verifications with Catapulta
      • Verification via thirdweb
      • Interacting with Smart Contracts
    • Blockscout SDK
    • Integrate Merits
    • Chainscout chains list
  • 🏃‍♂️Setup and Run Blockscout
    • General Overview
      • Separate Indexer, Web App, and API
      • Umbrella Project Organization
      • Indexer Architecture Overview
      • ShareLock
      • EVM Version Information
    • Requirements
      • General Backend Requirements / Blockscout Backend Prerequisites
      • Backend/Frontend Compatibility Matrix
      • Hardware & Hosting Requirements
      • Database Storage Requirements
      • Client Setting Requirements
      • Node Tracing / JSON RPC Requirements
      • L2 -> L1 JSON-RPC Method Requests
    • ☑️ENV Variables
      • Backend ENVs: Common
      • Backend ENVs: Chain-Specific
      • Backend ENVs: Integrations
      • Frontend ENVs: Common
        • ENVs
        • Deprecated ENVs
      • Deprecated Backend ENVs
        • Previous ENV Variable Home Page
    • Deployment
      • ⭐Manual Deployment Guide
        • Ubuntu Setup
        • MacOS setup
      • ⭐Docker-compose Deployment
      • ⭐Kubernetes Deployment
      • Rollup Deployment
      • 🌟Cosmos-based chains
      • 🍀Upgrade Guide (v7.0 & v8.0)
      • Frontend Migration
        • All-In-One Container
        • Separate Frontend
        • Customized Backend
        • Proxy Setup
        • FAQs
      • Manual Deployment (backend + old UI)
        • Manual cleaning an instance from the previous deployment
      • Terraform Deployment
      • Ansible Deployment (AWS Cloud)
        • Overview
        • Prerequisites
        • AWS Permissions & Settings
          • Creating a Secret Key Pair
          • Login with AWS CLI
          • Creating an AWS certificate for SSL
          • Manually Cleaning Terraform Related Instances
        • Variables
        • Deploying the Blockscout Infrastructure
        • Deploying Blockscout
        • Destroying Provisioned Infrastructure
        • Common Additional Tasks
        • Common Errors and Questions
        • AWS Marketplace (deprecated)
          • Overview
          • CloudFormation Template
          • Prerequisites & Install Parameters
          • Install from AWS Marketplace
          • AWS EC2 archive node setup with OpenEthereum (formerly Parity)
          • Updating & Redeploying in AWS
          • Customizing CSS
    • Microservices
      • Blockscout ENS (BENS) Name Service Integration
      • Smart Contract Verification
    • Configuration Options
      • Admin Panel Usage
      • Automating Restarts
      • Branding Configs
      • Circle CI Updates
      • Charts and Stats
      • CSS Configuration & Presets
      • Exchange Rates
      • Front-end Config Files
      • haproxy Settings for Blockscout.com
      • Internationalization
      • Logger Configs
      • Memory Usage
      • Metrics
      • My Account Settings
      • Sorting and Pagination
      • Tracing
      • Reown Project ID for contract Read/Write
    • Indexing
      • How do I fix indexer timeouts?
      • How do I update memory consumption to fix indexer memory errors?
    • Testing
    • DB schema
  • FAQs
    • User FAQs
    • Developer FAQs
  • 🧩Resources
    • EaaS: Hosting with Blockscout
    • Contributing to Blockscout
    • Bug Bounty Program
    • Media kit
    • Release Notes
      • v5.3.0: 10/23/23
      • v5.2.0: 6/20/23
      • v5.1.0: 2/13/23
      • v5.0.0: 1/11/23
    • Discord Channel
    • Discussion
    • GitHub Repo
Powered by GitBook
LogoLogo

Privacy and Terms

  • Privacy Notice
  • Terms and Conditions

Copyright © Blockscout Limited 2023-2024

On this page
  • Understanding Errors and Timeouts
  • Resolving Timeout Issues
  • Other Actions

Was this helpful?

Export as PDF
  1. Setup and Run Blockscout
  2. Indexing

How do I fix indexer timeouts?

Last updated 1 year ago

Was this helpful?

BlockScout utilizes two separate indexers in order to index the network history as well as keep up with new incoming blocks. Due to this process, a node may become overloaded and not respond to BlockScout's RPC requests within the designated timeout period.

The indexer umbrella application can be tweaked to meet your node's size and responsiveness. Outlined below are the locations and adjustments that can be made to each fetcher.

Fetchers are available at

Fetcher
Description
Batch size
Concurrency

This fetcher indexes blocks, transactions and receipts starting from the tip of the chain working backward to the Genesis block.

10 INDEXER_CATCHUP_BLOCKS_BATCH_SIZE

10 INDEXER_CATCHUP_BLOCKS_CONCURRENCY

Transaction receipts fetcher.

250 INDEXER_RECEIPTS_BATCH_SIZE

10 INDEXER_RECEIPTS_CONCURRENCY

This fetcher indexes internal transactions. For the real-time fetcher this process is done synchronously and for the catchup fetcher, this process is done asynchronously.

10 INDEXER_INTERNAL_TRANSACTIONS_BATCH_SIZE

4 INDEXER_INTERNAL_TRANSACTIONS_CONCURRENCY

This fetcher indexes each coin balance at the block height the address was interacted with.

100 INDEXER_COIN_BALANCES_BATCH_SIZE

4 INDEXER_COIN_BALANCES_CONCURRENCY

This fetcher indexes non-consensus blocks, transactions, and receipts.

10

10

This fetcher indexes token balances. Note you may experience some token balances that cannot be fetched due to a malformed smart contract or other functions that do not allow a balance to be fetched.

100 INDEXER_TOKEN_BALANCES_BATCH_SIZE

10 INDEXER_TOKEN_BALANCES_CONCURRENCY

This indexer fetches the metadata for a token contract

1

10

Block reward fetcher.

10 INDEXER_BLOCK_REWARD_BATCH_SIZE

10 INDEXER_BLOCK_REWARD_CONCURRENCY

Token instance realtime fetcher.

1 INDEXER_TOKEN_INSTANCE_REALTIME_BATCH_SIZE

10 INDEXER_TOKEN_INSTANCE_REALTIME_CONCURRENCY

Token instance retry fetcher.

10 INDEXER_TOKEN_INSTANCE_RETRY_CONCURRENCY

10 INDEXER_TOKEN_INSTANCE_RETRY_BATCH_SIZE

Token instance sanitize fetcher.

10 INDEXER_TOKEN_INSTANCE_SANITIZE_BATCH_SIZE

10 INDEXER_TOKEN_INSTANCE_SANITIZE_CONCURRENCY

Understanding Errors and Timeouts

application=indexer fetcher=coin_balance count=500 error_count=500 [error] failed to fetch: :timeout

In the error provided above, we can tell that the indexer application failed to fetch 500 coin balances due to a timeout error. Usually, when an indexer starts to receive timeouts, many more timeouts from other fetchers will occur as well.

Resolving Timeout Issues

The best action to take when fetchers start to receive timeouts is to lower the batch size and concurrency of a few fetchers which will put less pressure on the node.

The two indexers that cause the most strain to the node are the block fetcher and the internal transactions fetcher. It would be advised to cut these fetchers values in half and restart the application. A restart of the node may also be required.

Other Actions

BlockScout comes equipped with functionality to automatically stop sending requests for n seconds if timeouts are detected. You may adjust these settings by setting a different value for wait_per_timeout.

Content moved from

🏃‍♂️
https://github.com/blockscout/blockscout/tree/master/apps/indexer/lib/indexer/fetcher
https://github.com/poanetwork/blockscout/blob/1475e3bfd002d9397efd0f0cc29c20f39a70d023/apps/ethereum_jsonrpc/config/config.exs#L3-L9
https://forum.poa.network/t/faq-how-do-i-fix-indexer-timeouts/1829
Catchup Block Fetcher
Transaction Receipts Fetcher
Internal Transaction Fetcher
Coin Balance Fetcher
Uncle Block Fetcher
Token Balance Fetcher
Token Fetcher
Block Reward Fetcher
Token Instance Realtime Fetcher
Token Instance Retry Fetcher
Token Instance Sanitize Fetcher