// Copyright 2017-2021 Parity Technologies (UK) Ltd. // This file is part of Polkadot. // Polkadot is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // Polkadot is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // You should have received a copy of the GNU General Public License // along with Polkadot. If not, see . //! Metered variant of bounded mpsc channels to be able to extract metrics. use super::*; /// Create a wrapped `mpsc::channel` pair of `MeteredSender` and `MeteredReceiver`. pub fn channel(capacity: usize, name: &'static str) -> (MeteredSender, MeteredReceiver) { let (tx, rx) = mpsc::channel(capacity); let mut shared_meter = Meter::default(); shared_meter.name = name; let tx = MeteredSender { meter: shared_meter.clone(), inner: tx }; let rx = MeteredReceiver { meter: shared_meter, inner: rx }; (tx, rx) } /// A receiver tracking the messages consumed by itself. #[derive(Debug)] pub struct MeteredReceiver { // count currently contained messages meter: Meter, inner: mpsc::Receiver, } impl std::ops::Deref for MeteredReceiver { type Target = mpsc::Receiver; fn deref(&self) -> &Self::Target { &self.inner } } impl std::ops::DerefMut for MeteredReceiver { fn deref_mut(&mut self) -> &mut Self::Target { &mut self.inner } } impl Stream for MeteredReceiver { type Item = T; fn poll_next(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> { match mpsc::Receiver::poll_next(Pin::new(&mut self.inner), cx) { Poll::Ready(x) => { // always use Ordering::SeqCst to avoid underflows self.meter.fill.fetch_sub(1, Ordering::SeqCst); Poll::Ready(x) } other => other, } } /// Don't rely on the unreliable size hint. fn size_hint(&self) -> (usize, Option) { self.inner.size_hint() } } impl MeteredReceiver { /// Get an updated accessor object for all metrics collected. pub fn meter(&self) -> &Meter { &self.meter } /// Attempt to receive the next item. pub fn try_next(&mut self) -> Result, mpsc::TryRecvError> { match self.inner.try_next()? { Some(x) => { self.meter.fill.fetch_sub(1, Ordering::SeqCst); Ok(Some(x)) } None => Ok(None), } } } impl futures::stream::FusedStream for MeteredReceiver { fn is_terminated(&self) -> bool { self.inner.is_terminated() } } /// The sender component, tracking the number of items /// sent across it. #[derive(Debug)] pub struct MeteredSender { meter: Meter, inner: mpsc::Sender, } impl Clone for MeteredSender { fn clone(&self) -> Self { Self { meter: self.meter.clone(), inner: self.inner.clone() } } } impl std::ops::Deref for MeteredSender { type Target = mpsc::Sender; fn deref(&self) -> &Self::Target { &self.inner } } impl std::ops::DerefMut for MeteredSender { fn deref_mut(&mut self) -> &mut Self::Target { &mut self.inner } } impl MeteredSender { /// Get an updated accessor object for all metrics collected. pub fn meter(&self) -> &Meter { &self.meter } /// Send message, wait until capacity is available. pub async fn send(&mut self, item: T) -> result::Result<(), mpsc::SendError> where Self: Unpin, { self.meter.fill.fetch_add(1, Ordering::SeqCst); let fut = self.inner.send(item); futures::pin_mut!(fut); fut.await } /// Attempt to send message or fail immediately. pub fn try_send(&mut self, msg: T) -> result::Result<(), mpsc::TrySendError> { self.inner.try_send(msg)?; self.meter.fill.fetch_add(1, Ordering::SeqCst); Ok(()) } } impl futures::sink::Sink for MeteredSender { type Error = mpsc::SendError; fn start_send(mut self: Pin<&mut Self>, item: T) -> Result<(), Self::Error> { Pin::new(&mut self.inner).start_send(item) } fn poll_ready(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> { Pin::new(&mut self.inner).poll_ready(cx) } fn poll_close(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> { match Pin::new(&mut self.inner).poll_close(cx) { val @ Poll::Ready(_)=> { self.meter.fill.store(0, Ordering::SeqCst); val } other => other, } } fn poll_flush(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> { match Pin::new(&mut self.inner).poll_flush(cx) { val @ Poll::Ready(_)=> { self.meter.fill.fetch_add(1, Ordering::SeqCst); val } other => other, } } }