Add structured log for indexer falling behind the chain by more than 50 ledgers

[Chucks1093]

Summary

When the indexer falls behind the latest ledger by more than 50 ledgers it signals a processing problem, but currently no log is emitted to alert operators. A warning log should be emitted each time the gap is detected above the threshold.

Scope

• Compare the latest processed ledger to the latest network ledger after each indexer tick
• If the gap exceeds 50, emit a warning log with fields: latest_processed_ledger, latest_network_ledger, gap, detected_at
• Log emitted once per tick while the gap persists — not rate-limited to once per gap event
• Log level: warn

Acceptance Criteria

• Warning log emitted when gap > 50
• Log not emitted when gap ≤ 50
• All four fields present with correct values
• Log emitted on every tick while gap persists

ETA: 12 hours

---

Coordinate on Telegram

[manasehstephen131-ops]

@manasehstephen131-ops has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hello maintainer please i would like to work on this issue I am a Motivated developer experienced in debugging, resolving issues, and contributing to projects. I work with JavaScript, React, Next.js, Node.js, and Rust, and I’m comfortable navigating and improving existing codebases.

Quick to learn, proactive, and focused on delivering quality work.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @manasehstephen131-ops to this issue.

[Lordofsacarsm]

@Lordofsacarsm has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hey, I would like to take this one on.

I will add the logic to compare the latest processed ledger to the network ledger after each indexer tick. If the gap exceeds 50, I will ensure it emits a structured warning log containing the four requested fields. I will make sure the warning fires on every tick while the threshold is crossed and write tests to confirm it stays quiet when the gap is 50 or below.

Let me know if I am good to get started.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Lordofsacarsm to this issue.

[yusufadeagbo]

@yusufadeagbo has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

can i work on this, please?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @yusufadeagbo to this issue.

[bandanadivya]

@bandanadivya has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi
I’d like to work on this issue if it’s available. I’m a full-stack Web2 & Web3 developer with solid open-source experience and can start working on it right away.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @bandanadivya to this issue.

[Chuks-coderr]

@Chuks-coderr has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

hello i would like to work on this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Chuks-coderr to this issue.

[JennyRichy]

@JennyRichy has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi maintainer, I am confident that I can resolve this issue before 24hrs if assigned to me because I have the technical expertise to resolve it.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @JennyRichy to this issue.

[drips-wave]

Congratulations, @Chuks-coderr! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @Chuks-coderr: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊