Skip to content

Bugfix/ccip 11890 executor OOF metrics - #109

Merged
kirtan-amin merged 7 commits into
mainfrom
bugfix/CCIP-11890-executor-OOF-metrics
Jul 9, 2026
Merged

Bugfix/ccip 11890 executor OOF metrics#109
kirtan-amin merged 7 commits into
mainfrom
bugfix/CCIP-11890-executor-OOF-metrics

Conversation

@kirtan-amin

@kirtan-amin kirtan-amin commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Description

Adds a new metric that tracks when we get an error on broadcasting for insufficient funds at the sender address. This metric will surface the case were an executor address needs topping up so we can act to notify the executor to reduce the number of txs that get stuck and the time they are stuck for

CCIP-11890

Requires Dependencies

Resolves Dependencies

@kirtan-amin
kirtan-amin requested a review from a team as a code owner July 7, 2026 12:57
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

👋 kirtan-amin, thanks for creating this pull request!

To help reviewers, please consider creating future PRs as drafts first. This allows you to self-review and make any final changes before notifying the team.

Once you're ready, you can mark it as "Ready for review" to request feedback. Thanks!

@kirtan-amin
kirtan-amin marked this pull request as draft July 7, 2026 12:57
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

⚠️ API Diff Results - github.com/smartcontractkit/chainlink-framework/metrics

⚠️ Breaking Changes (1)

GenericTXMMetrics (1)
  • IncrementNumInsufficientFundsForTx — ➕ Added

📄 View full apidiff report

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

⚠️ API Diff Results - github.com/smartcontractkit/chainlink-framework/chains

⚠️ Breaking Changes (2)

txmgr.broadcasterMetrics (1)
  • IncrementNumInsufficientFundsForTx — ➕ Added
txmgr.confimerMetrics (1)
  • IncrementNumInsufficientFundsForTx — ➕ Added

📄 View full apidiff report

@kirtan-amin kirtan-amin changed the title Bugfix/ccip 11890 executor oof metrics Bugfix/ccip 11890 executor OOF metrics Jul 7, 2026
kirtan-amin and others added 7 commits July 7, 2026 15:03
Counter labeled {chainID, fromAddress}, emitted as both Prometheus and
OTel instruments, so operators can alert on a specific underfunded
sending address.
…tion

Broadcaster and confirmer now call IncrementNumInsufficientFundsTxs with
the sending address when a node rejects a tx for insufficient funds. The
broadcaster also logs a meta-enriched warn, which carries messageID for
transactions that set TxMeta.MessageIDs (e.g. CCIP).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…senderAddress label

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…s warn

The package's existing logs (confirmer, resender, txmgr) all use the
fromAddress key for the sending address; keep the log stream on one
vocabulary. The metric label remains senderAddress.
Code identifiers follow the package's fromAddress vocabulary; the
externally-visible metric label stays senderAddress.
@kirtan-amin
kirtan-amin force-pushed the bugfix/CCIP-11890-executor-OOF-metrics branch from eeab9e0 to 204cc36 Compare July 7, 2026 14:03
@kirtan-amin
kirtan-amin marked this pull request as ready for review July 8, 2026 08:30
@kirtan-amin
kirtan-amin merged commit 78ab531 into main Jul 9, 2026
25 checks passed
@kirtan-amin
kirtan-amin deleted the bugfix/CCIP-11890-executor-OOF-metrics branch July 9, 2026 08:26
kirtan-amin added a commit to smartcontractkit/chainlink that referenced this pull request Jul 13, 2026
…ent-funds observability

- chainlink-framework/{chains,metrics} -> 78ab531: TXM emits
  tx_manager_insufficient_funds_tx_count{chainID,senderAddress} and a
  retry warn log when an RPC rejects a tx for insufficient funds
  (smartcontractkit/chainlink-framework#109)
- chainlink-ccv -> 690f2037: CL-mode executor transmitter attaches the
  CCIP messageID to TxMeta so the TXM warn logs carry messageID
  (smartcontractkit/chainlink-ccv#1242)

Covers CL-mode CCV executors and the keystone writer flow (CCIP-11890).
cyh7789 pushed a commit to cyh7789/chainlink that referenced this pull request Jul 17, 2026
* chore(deps): bump chainlink-framework and chainlink-ccv for insufficient-funds observability

- chainlink-framework/{chains,metrics} -> 78ab531: TXM emits
  tx_manager_insufficient_funds_tx_count{chainID,senderAddress} and a
  retry warn log when an RPC rejects a tx for insufficient funds
  (smartcontractkit/chainlink-framework#109)
- chainlink-ccv -> 690f2037: CL-mode executor transmitter attaches the
  CCIP messageID to TxMeta so the TXM warn logs carry messageID
  (smartcontractkit/chainlink-ccv#1242)

Covers CL-mode CCV executors and the keystone writer flow (CCIP-11890).

* chore: bump framework (metric + chains) 527495d

* chore: bump framework (metrics + chains) to include OOF metrics

chore: remove changeset

chore: tidy submodule go.mod/go.sum for framework smartcontractkit#110 bump
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants