indexer icon indicating copy to clipboard operation
indexer copied to clipboard

Requests for indexer process guides

Open fordN opened this issue 3 years ago • 4 comments

There is an ever growing set of indexer tools, scripts, and processes that are often described well in discord conversations but are not easily searchable there. I've created this issue to track all requests for guides and additional documentation to solicit input from the community and help organize prioritization.

fordN avatar Jul 01 '21 16:07 fordN

I'd like to write and/or make available the following guides:

  • [ ] Indexer management using the indexer-cli (may be able to simply make the guide from mission control available)
  • [ ] Configuring transaction management in the agent: there is a tradeoff space between gas efficiency and transaction immediacy that I would like to make clear and provide several example scenarios.
  • [ ] Guide to debugging PoI issues and using PoI analysis tools

fordN avatar Jul 01 '21 16:07 fordN

Also (maybe related to 3rd item) "closing manually" (remix, cli.ts, etc)

koen84 avatar Jul 01 '21 17:07 koen84

For POI issues we need those for stuck/not on chain head which need to redeploy the subgraphs, closing manually via remix etc, like Koen said.. and then there are those that die and we need to find the last valid POI then manually close it with that.

Then theres also the one where subgraphs need to be replaced:

  1. Stop agent
  2. Stop index/query nodes
  3. Remove deployment with graphman
  4. Drop eth_call_cache
  5. Start index/query nodes
  6. Start agent

mindstyle85 avatar Jul 01 '21 17:07 mindstyle85

For PoI issues Gary contributed https://docs.thegraph.academy/technical-documentation/tips-and-tricks/manuallyclosingallocationsforfailedsubgraphs

Would be great if we could exploit the efforts already being made to avoid doubling up on the documentation work.

cryptovestor21 avatar Jul 01 '21 17:07 cryptovestor21