Raw File
shell_metrics.mli
(*****************************************************************************)
(*                                                                           *)
(* Open Source License                                                       *)
(* Copyright (c) 2022 Nomadic Labs, <contact@nomadic-labs.com>               *)
(*                                                                           *)
(* Permission is hereby granted, free of charge, to any person obtaining a   *)
(* copy of this software and associated documentation files (the "Software"),*)
(* to deal in the Software without restriction, including without limitation *)
(* the rights to use, copy, modify, merge, publish, distribute, sublicense,  *)
(* and/or sell copies of the Software, and to permit persons to whom the     *)
(* Software is furnished to do so, subject to the following conditions:      *)
(*                                                                           *)
(* The above copyright notice and this permission notice shall be included   *)
(* in all copies or substantial portions of the Software.                    *)
(*                                                                           *)
(* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR*)
(* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  *)
(* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL   *)
(* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER*)
(* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING   *)
(* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER       *)
(* DEALINGS IN THE SOFTWARE.                                                 *)
(*                                                                           *)
(*****************************************************************************)

module Worker : sig
  type timestamps

  type counters = {
    worker_request_count : Prometheus.Counter.t;
    worker_completion_count : Prometheus.Counter.t;
    worker_error_count : Prometheus.Counter.t;
  }

  val update_timestamps : timestamps -> Worker_types.request_status -> unit
end

(** Metrics associated to the mempool *)
module Mempool : sig
  type t = {worker_counters : Worker.counters}

  val init : string list -> t

  val set_validated_collector : (unit -> float) -> unit

  val set_refused_collector : (unit -> float) -> unit

  val set_branch_refused_collector : (unit -> float) -> unit

  val set_branch_delayed_collector : (unit -> float) -> unit

  val set_outdated_collector : (unit -> float) -> unit

  val set_unprocessed_collector : (unit -> float) -> unit
end

module Distributed_db : sig
  type t = {table_length : Prometheus.Gauge.t}

  val init : kind:string -> entry_type:string -> t

  val update : t -> length:int -> unit

  module Messages : sig
    val on_received_msg :
      (Distributed_db_message.t, 'peer_meta, 'conn_meta) P2p.connection ->
      Distributed_db_message.t ->
      unit

    val on_sent_msg :
      (Distributed_db_message.t, 'peer_meta, 'conn_meta) P2p.connection ->
      Distributed_db_message.t ->
      unit

    val on_broadcasted_msg :
      (Distributed_db_message.t, 'peer_meta, 'conn_meta) P2p.connection
      P2p_peer.Table.t ->
      ?except:
        ((Distributed_db_message.t, 'peer_meta, 'conn_meta) P2p.connection ->
        bool) ->
      ?alt:
        ((Distributed_db_message.t, 'peer_meta, 'conn_meta) P2p.connection ->
        bool)
        * Distributed_db_message.t ->
      Distributed_db_message.t ->
      unit
  end
end

module Block_validator : sig
  type t = {
    already_commited_blocks_count : Prometheus.Counter.t;
    outdated_blocks_count : Prometheus.Counter.t;
    validated_blocks_count : Prometheus.Counter.t;
    validation_errors_count : Prometheus.Counter.t;
    preapplied_blocks_count : Prometheus.Counter.t;
    preapplication_errors_count : Prometheus.Counter.t;
    validation_errors_after_precheck_count : Prometheus.Counter.t;
    precheck_failed_count : Prometheus.Counter.t;
    worker_timestamps : Worker.timestamps;
    worker_counters : Worker.counters;
  }

  val init : string list -> t

  val set_operation_per_pass_collector : (unit -> float list) -> unit
end

module Chain_validator : sig
  type t = {
    head_level : Prometheus.Gauge.t;
    ignored_head_count : Prometheus.Counter.t;
    branch_switch_count : Prometheus.Counter.t;
    head_increment_count : Prometheus.Counter.t;
    head_round : Prometheus.Gauge.t;
    head_cycle : Prometheus.Gauge.t;
    consumed_gas : Prometheus.Gauge.t;
    is_bootstrapped : Prometheus.Gauge.t;
    sync_status : Prometheus.Gauge.t;
    worker_timestamps : Worker.timestamps;
    worker_counters : Worker.counters;
  }

  val update_bootstrapped : metrics:t -> bool -> unit

  val update_sync_status :
    metrics:t -> Chain_validator_worker_state.synchronisation_status -> unit

  val init : string list -> Chain_id.t -> t

  val update_proto_metrics_callback :
    metrics:t -> cycle:float -> consumed_gas:float -> round:float -> unit

  val update_proto : (unit -> unit Lwt.t) -> unit
end

module Version : sig
  val init :
    version:string ->
    commit_info:Node_version.commit_info ->
    ('a, 'b, 'c) P2p.t ->
    unit
end

module Peer_validator : sig
  type t = {
    on_no_request : Prometheus.Counter.t;
    new_head_completed : Prometheus.Counter.t;
    new_branch_completed : Prometheus.Counter.t;
    invalid_locator : Prometheus.Counter.t;
    invalid_block : Prometheus.Counter.t;
    system_error : Prometheus.Counter.t;
    unavailable_protocol : Prometheus.Counter.t;
    unknown_ancestor : Prometheus.Counter.t;
    too_short_locator : Prometheus.Counter.t;
    operations_fetching_canceled_new_branch : Prometheus.Counter.t;
    operations_fetching_canceled_new_known_valid_head : Prometheus.Counter.t;
    operations_fetching_canceled_new_unknown_head : Prometheus.Counter.t;
    unknown_error : Prometheus.Counter.t;
    connections : Prometheus.Counter.t;
  }

  val init : string list -> t
end
back to top