feat(network): add connection lifecycle metrics (#11135)

Author: mergify[bot]

CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org).
 
 ## [Unreleased]
 
+### Added
+
+- Prometheus metrics now separate peer connection attempts and terminal outcomes by network,
+  direction, address family, lifecycle stage, and bounded outcome. Version-message metrics also
+  report the bounded self-reported implementation class without using peer IPs or raw user agents
+  as labels.
+
+### Changed
+
+- Peer-set, crawler-handshake, and address-book gauges now include a `network` label, so Mainnet
+  and Testnet values no longer overwrite each other in processes that run both networks.
+
 ## [Zebra 6.2.3](https://github.com/ZcashFoundation/zebra/releases/tag/v6.2.3) - 2026-07-27
 
 This is an optional release with network hardenings for operators that experience issues with their nodes peer set connectivity or otherwise want to be proactive about avoiding such issues.

zebra-network/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Connection-attempt, terminal-outcome, and remote-version metrics with bounded network,
+  direction, address-family, lifecycle-stage, outcome, and implementation labels.
+
+### Changed
+
+- Peer-set, crawler-handshake, and address-book gauges now include a `network` label, so multiple
+  network instances in one process do not overwrite each other's values.
+
 ## [11.0.0] - 2026-07-27
 
 ### Breaking Changes

zebra-network/src/address_book.rs

@@ -18,6 +18,7 @@ use tracing::Span;
 use zebra_chain::{parameters::Network, serialization::DateTime32};
 
 use crate::{
+    connection_metrics::network_kind_label,
     constants::{self, ADDR_RESPONSE_LIMIT_DENOMINATOR, MAX_ADDRS_IN_MESSAGE},
     meta_addr::MetaAddrChange,
     protocol::external::{canonical_peer_addr, canonical_socket_addr},
@@ -754,15 +755,20 @@ impl AddressBook {
         let _ = self.address_metrics_tx.send(m);
 
         // TODO: rename to address_book.[state_name]
-        metrics::gauge!("candidate_set.responded").set(m.responded as f64);
-        metrics::gauge!("candidate_set.gossiped").set(m.never_attempted_gossiped as f64);
-        metrics::gauge!("candidate_set.failed").set(m.failed as f64);
-        metrics::gauge!("candidate_set.pending").set(m.attempt_pending as f64);
+        let network = network_kind_label(&self.network);
+        metrics::gauge!("candidate_set.responded", "network" => network).set(m.responded as f64);
+        metrics::gauge!("candidate_set.gossiped", "network" => network)
+            .set(m.never_attempted_gossiped as f64);
+        metrics::gauge!("candidate_set.failed", "network" => network).set(m.failed as f64);
+        metrics::gauge!("candidate_set.pending", "network" => network)
+            .set(m.attempt_pending as f64);
 
         // TODO: rename to address_book.responded.recently_live
-        metrics::gauge!("candidate_set.recently_live").set(m.recently_live as f64);
+        metrics::gauge!("candidate_set.recently_live", "network" => network)
+            .set(m.recently_live as f64);
         // TODO: rename to address_book.responded.stopped_responding
-        metrics::gauge!("candidate_set.disconnected").set(m.recently_stopped_responding as f64);
+        metrics::gauge!("candidate_set.disconnected", "network" => network)
+            .set(m.recently_stopped_responding as f64);
 
         std::mem::drop(_guard);
         self.log_metrics(&m, instant_now);