2025-08-06 12:10:18 -04:00
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at https://mozilla.org/MPL/2.0/.
2023-04-21 12:12:43 -07:00
*
2025-08-06 12:10:18 -04:00
* (c) ZeroTier, Inc.
* https://www.zerotier.com/
2023-04-21 12:12:43 -07:00
*/
2025-07-03 08:41:19 -07:00
// clang-format off
2025-07-03 11:26:23 -04:00
#include <prometheus/simpleapi.h>
2025-07-03 08:41:19 -07:00
#include <prometheus/histogram.h>
// clang-format on
2023-04-21 12:12:43 -07:00
namespace prometheus {
2025-07-03 11:26:23 -04:00
namespace simpleapi {
std :: shared_ptr < Registry > registry_ptr = std :: make_shared < Registry > ();
Registry & registry = * registry_ptr ;
SaveToFile saver ;
} // namespace simpleapi
} // namespace prometheus
2023-04-21 12:12:43 -07:00
namespace ZeroTier {
2025-07-03 11:26:23 -04:00
namespace Metrics {
// Packet Type Counts
prometheus :: simpleapi :: counter_family_t packets { "zt_packet" , "ZeroTier packet type counts" };
2023-04-28 14:24:19 -07:00
2025-07-03 11:26:23 -04:00
// Incoming packets
prometheus :: simpleapi :: counter_metric_t pkt_nop_in { packets . Add ({ { "packet_type" , "nop" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_in { packets . Add ({ { "packet_type" , "error" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_ack_in { packets . Add ({ { "packet_type" , "ack" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_qos_in { packets . Add ({ { "packet_type" , "qos" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_hello_in { packets . Add ({ { "packet_type" , "hello" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_ok_in { packets . Add ({ { "packet_type" , "ok" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_whois_in { packets . Add ({ { "packet_type" , "whois" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_rendezvous_in { packets . Add ({ { "packet_type" , "rendezvous" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_frame_in { packets . Add ({ { "packet_type" , "frame" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_ext_frame_in { packets . Add ({ { "packet_type" , "ext_frame" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_echo_in { packets . Add ({ { "packet_type" , "echo" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_multicast_like_in { packets . Add ({ { "packet_type" , "multicast_like" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_network_credentials_in { packets . Add ({ { "packet_type" , "network_credentials" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_network_config_request_in { packets . Add ({ { "packet_type" , "network_config_request" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_network_config_in { packets . Add ({ { "packet_type" , "network_config" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_multicast_gather_in { packets . Add ({ { "packet_type" , "multicast_gather" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_multicast_frame_in { packets . Add ({ { "packet_type" , "multicast_frame" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_push_direct_paths_in { packets . Add ({ { "packet_type" , "push_direct_paths" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_user_message_in { packets . Add ({ { "packet_type" , "user_message" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_remote_trace_in { packets . Add ({ { "packet_type" , "remote_trace" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_path_negotiation_request_in { packets . Add ({ { "packet_type" , "path_negotiation_request" }, { "direction" , "rx" } }) };
2023-04-28 14:24:19 -07:00
2025-07-03 11:26:23 -04:00
// Outgoing packets
prometheus :: simpleapi :: counter_metric_t pkt_nop_out { packets . Add ({ { "packet_type" , "nop" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_out { packets . Add ({ { "packet_type" , "error" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_ack_out { packets . Add ({ { "packet_type" , "ack" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_qos_out { packets . Add ({ { "packet_type" , "qos" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_hello_out { packets . Add ({ { "packet_type" , "hello" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_ok_out { packets . Add ({ { "packet_type" , "ok" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_whois_out { packets . Add ({ { "packet_type" , "whois" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_rendezvous_out { packets . Add ({ { "packet_type" , "rendezvous" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_frame_out { packets . Add ({ { "packet_type" , "frame" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_ext_frame_out { packets . Add ({ { "packet_type" , "ext_frame" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_echo_out { packets . Add ({ { "packet_type" , "echo" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_multicast_like_out { packets . Add ({ { "packet_type" , "multicast_like" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_network_credentials_out { packets . Add ({ { "packet_type" , "network_credentials" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_network_config_request_out { packets . Add ({ { "packet_type" , "network_config_request" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_network_config_out { packets . Add ({ { "packet_type" , "network_config" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_multicast_gather_out { packets . Add ({ { "packet_type" , "multicast_gather" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_multicast_frame_out { packets . Add ({ { "packet_type" , "multicast_frame" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_push_direct_paths_out { packets . Add ({ { "packet_type" , "push_direct_paths" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_user_message_out { packets . Add ({ { "packet_type" , "user_message" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_remote_trace_out { packets . Add ({ { "packet_type" , "remote_trace" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_path_negotiation_request_out { packets . Add ({ { "packet_type" , "path_negotiation_request" }, { "direction" , "tx" } }) };
2023-04-28 14:24:19 -07:00
2025-07-03 11:26:23 -04:00
// Packet Error Counts
prometheus :: simpleapi :: counter_family_t packet_errors { "zt_packet_error" , "ZeroTier packet errors" };
2023-04-26 08:49:54 -07:00
2025-07-03 11:26:23 -04:00
// Incoming Error Counts
prometheus :: simpleapi :: counter_metric_t pkt_error_obj_not_found_in { packet_errors . Add ({ { "error_type" , "obj_not_found" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_unsupported_op_in { packet_errors . Add ({ { "error_type" , "unsupported_operation" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_identity_collision_in { packet_errors . Add ({ { "error_type" , "identity_collision" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_need_membership_cert_in { packet_errors . Add ({ { "error_type" , "need_membership_certificate" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_network_access_denied_in { packet_errors . Add ({ { "error_type" , "network_access_denied" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_unwanted_multicast_in { packet_errors . Add ({ { "error_type" , "unwanted_multicast" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_authentication_required_in { packet_errors . Add ({ { "error_type" , "authentication_required" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_internal_server_error_in { packet_errors . Add ({ { "error_type" , "internal_server_error" }, { "direction" , "rx" } }) };
2023-04-28 14:24:19 -07:00
2025-07-03 11:26:23 -04:00
// Outgoing Error Counts
prometheus :: simpleapi :: counter_metric_t pkt_error_obj_not_found_out { packet_errors . Add ({ { "error_type" , "obj_not_found" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_unsupported_op_out { packet_errors . Add ({ { "error_type" , "unsupported_operation" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_identity_collision_out { packet_errors . Add ({ { "error_type" , "identity_collision" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_need_membership_cert_out { packet_errors . Add ({ { "error_type" , "need_membership_certificate" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_network_access_denied_out { packet_errors . Add ({ { "error_type" , "network_access_denied" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_unwanted_multicast_out { packet_errors . Add ({ { "error_type" , "unwanted_multicast" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_authentication_required_out { packet_errors . Add ({ { "error_type" , "authentication_required" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t pkt_error_internal_server_error_out { packet_errors . Add ({ { "error_type" , "internal_server_error" }, { "direction" , "tx" } }) };
2023-04-28 14:24:19 -07:00
2025-07-03 11:26:23 -04:00
// Data Sent/Received Metrics
prometheus :: simpleapi :: counter_family_t data { "zt_data" , "number of bytes ZeroTier has transmitted or received" };
prometheus :: simpleapi :: counter_metric_t udp_recv { data . Add ({ { "protocol" , "udp" }, { "direction" , "rx" } }) };
prometheus :: simpleapi :: counter_metric_t udp_send { data . Add ({ { "protocol" , "udp" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t tcp_send { data . Add ({ { "protocol" , "tcp" }, { "direction" , "tx" } }) };
prometheus :: simpleapi :: counter_metric_t tcp_recv { data . Add ({ { "protocol" , "tcp" }, { "direction" , "rx" } }) };
2023-04-26 08:49:54 -07:00
2025-07-03 11:26:23 -04:00
// Network Metrics
prometheus :: simpleapi :: gauge_metric_t network_num_joined { "zt_num_networks" , "number of networks this instance is joined to" };
prometheus :: simpleapi :: gauge_family_t network_num_multicast_groups { "zt_network_multicast_groups_subscribed" , "number of multicast groups networks are subscribed to" };
prometheus :: simpleapi :: counter_family_t network_packets { "zt_network_packets" , "number of incoming/outgoing packets per network" };
2023-04-21 12:12:43 -07:00
2023-05-04 11:12:55 -07:00
#ifndef ZT_NO_PEER_METRICS
2025-07-03 11:26:23 -04:00
// PeerMetrics
prometheus :: CustomFamily < prometheus :: Histogram < uint64_t > >& peer_latency = prometheus :: Builder < prometheus :: Histogram < uint64_t > > (). Name ( "zt_peer_latency" ). Help ( "peer latency (ms)" ). Register ( prometheus :: simpleapi :: registry );
prometheus :: simpleapi :: gauge_family_t peer_path_count { "zt_peer_path_count" , "number of paths to peer" };
prometheus :: simpleapi :: counter_family_t peer_packets { "zt_peer_packets" , "number of packets to/from a peer" };
prometheus :: simpleapi :: counter_family_t peer_packet_errors { "zt_peer_packet_errors" , "number of incoming packet errors from a peer" };
2023-05-04 11:12:55 -07:00
#endif
2023-05-04 07:58:02 -07:00
2025-07-03 11:26:23 -04:00
// General Controller Metrics
prometheus :: simpleapi :: gauge_metric_t network_count { "controller_network_count" , "number of networks the controller is serving" };
prometheus :: simpleapi :: gauge_metric_t member_count { "controller_member_count" , "number of network members the controller is serving" };
prometheus :: simpleapi :: counter_metric_t network_changes { "controller_network_change_count" , "number of times a network configuration is changed" };
prometheus :: simpleapi :: counter_metric_t member_changes { "controller_member_change_count" , "number of times a network member configuration is changed" };
prometheus :: simpleapi :: counter_metric_t member_auths { "controller_member_auth_count" , "number of network member auths" };
prometheus :: simpleapi :: counter_metric_t member_deauths { "controller_member_deauth_count" , "number of network member deauths" };
2023-04-21 12:12:43 -07:00
2025-07-03 11:26:23 -04:00
prometheus :: simpleapi :: gauge_metric_t network_config_request_queue_size { "controller_network_config_request_queue" , "number of entries in the request queue for network configurations" };
2023-05-16 11:56:58 -07:00
2025-07-03 11:26:23 -04:00
prometheus :: simpleapi :: counter_metric_t sso_expiration_checks { "controller_sso_expiration_checks" , "number of sso expiration checks done" };
2023-05-16 11:56:58 -07:00
2025-07-03 11:26:23 -04:00
prometheus :: simpleapi :: counter_metric_t sso_member_deauth { "controller_sso_timeouts" , "number of sso timeouts" };
prometheus :: simpleapi :: counter_metric_t network_config_request { "controller_network_config_request" , "count of config requests handled" };
prometheus :: simpleapi :: gauge_metric_t network_config_request_threads { "controller_network_config_request_threads" , "number of active network config handling threads" };
prometheus :: simpleapi :: counter_metric_t db_get_network { "controller_db_get_network" , "counter" };
prometheus :: simpleapi :: counter_metric_t db_get_network_and_member { "controller_db_get_network_and_member" , "counter" };
prometheus :: simpleapi :: counter_metric_t db_get_network_and_member_and_summary { "controller_db_get_networK_and_member_summary" , "counter" };
prometheus :: simpleapi :: counter_metric_t db_get_member_list { "controller_db_get_member_list" , "counter" };
prometheus :: simpleapi :: counter_metric_t db_get_network_list { "controller_db_get_network_list" , "counter" };
prometheus :: simpleapi :: counter_metric_t db_member_change { "controller_db_member_change" , "counter" };
prometheus :: simpleapi :: counter_metric_t db_network_change { "controller_db_network_change" , "counter" };
2023-05-23 12:11:26 -07:00
2023-04-21 12:12:43 -07:00
#ifdef ZT_CONTROLLER_USE_LIBPQ
2025-07-03 11:26:23 -04:00
// Central Controller Metrics
prometheus :: simpleapi :: counter_metric_t pgsql_mem_notification { "controller_pgsql_member_notifications_received" , "number of member change notifications received via pgsql NOTIFY" };
prometheus :: simpleapi :: counter_metric_t pgsql_net_notification { "controller_pgsql_network_notifications_received" , "number of network change notifications received via pgsql NOTIFY" };
prometheus :: simpleapi :: counter_metric_t pgsql_node_checkin { "controller_pgsql_node_checkin_count" , "number of node check-ins (pgsql)" };
prometheus :: simpleapi :: counter_metric_t pgsql_commit_ticks { "controller_pgsql_commit_ticks" , "number of commit ticks run (pgsql)" };
prometheus :: simpleapi :: counter_metric_t db_get_sso_info { "controller_db_get_sso_info" , "counter" };
2023-05-23 12:11:26 -07:00
2025-07-03 11:26:23 -04:00
prometheus :: simpleapi :: counter_metric_t redis_mem_notification { "controller_redis_member_notifications_received" , "number of member change notifications received via redis" };
prometheus :: simpleapi :: counter_metric_t redis_net_notification { "controller_redis_network_notifications_received" , "number of network change notifications received via redis" };
prometheus :: simpleapi :: counter_metric_t redis_node_checkin { "controller_redis_node_checkin_count" , "number of node check-ins (redis)" };
2023-04-21 12:12:43 -07:00
2025-07-03 11:26:23 -04:00
// Central DB Pool Metrics
prometheus :: simpleapi :: counter_metric_t conn_counter { "controller_pgsql_connections_created" , "number of pgsql connections created" };
prometheus :: simpleapi :: counter_metric_t max_pool_size { "controller_pgsql_max_conn_pool_size" , "max connection pool size for postgres" };
prometheus :: simpleapi :: counter_metric_t min_pool_size { "controller_pgsql_min_conn_pool_size" , "minimum connection pool size for postgres" };
prometheus :: simpleapi :: gauge_metric_t pool_avail { "controller_pgsql_available_conns" , "number of available postgres connections" };
prometheus :: simpleapi :: gauge_metric_t pool_in_use { "controller_pgsql_in_use_conns" , "number of postgres database connections in use" };
prometheus :: simpleapi :: counter_metric_t pool_errors { "controller_pgsql_connection_errors" , "number of connection errors the connection pool has seen" };
2023-04-21 12:12:43 -07:00
#endif
2025-07-03 11:26:23 -04:00
} // namespace Metrics
} // namespace ZeroTier