Monitoring

Liveness Probe endpoint

curl "http://localhost:18081/ping"

Returns the HTTP status code 200 right after basic initialisation procedures.

Readiness Probe endpoint

curl "http://localhost:18081/ready"

Returns the HTTP status code 200 when Bondy is ready to accept client WAMP (WS|TCP) or HTTP connections. Otherwise returns HTTP status code 503.

How quickly Bondy is ready to accept connections depends on the Coordinated Startup configuration settings. As soon as the shutdown procedure is initiated, this endpoint will return 503.

Prometheus Metrics

curl "http://localhost:18081/metrics" \
-H 'Content-Type: text/plain; version=0.0.4'

Metrics

Metric

Type

Description

bondy_cluster_dropped_bytes

counter

The total bytes dropped by a bondy node from another node in the cluster since reset

bondy_cluster_received_bytes

counter

The total bytes received by a bondy node from another node in the cluster since reset

bondy_cluster_sent_bytes

counter

The total bytes sent by a bondy node from another node in the cluster since reset

bondy_errors_total

counter

The total number of errors in a bondy node since reset

bondy_http_early_errors_total

counter

Total number of HTTP early errors

bondy_http_errors_total

counter

Total number of HTTP request errors

bondy_http_receive_body_duration_microseconds

histogram

Request body receiving duration

bondy_http_request_duration_microseconds

histogram

HTTP request duration

bondy_http_requests_total

counter

Total number of HTTP requests

bondy_http_spawned_processes_total

counter

Total number of spawned HTTP handlers (processes)

bondy_protocol_upgrades_total

counter

Total number of protocol upgrades

bondy_received_bytes

counter

The total bytes received by a bondy node from clients since reset

bondy_registry_tries

gauge

Registry tries count

bondy_send_errors_total

counter

The total number of router send errors in a bondy node since reset

bondy_sent_bytes

counter

The total bytes sent by a bondy node from clients since reset

bondy_session_duration_seconds

histogram

A histogram of the duration of sessions

bondy_sessions_closed_total

counter

The number of sessions closed on a bondy node since reset

bondy_sessions_opened_total

counter

The number of sessions opened on a bondy node since reset

bondy_sessions_total

gauge

The number of active sessions on a bondy node since reset

bondy_socket_duration_seconds

histogram

A histogram of the duration of a socket

bondy_socket_errors_total

counter

The number of socket errors on a bondy node since reset

bondy_sockets_closed_total

counter

The number of sockets closed on a bondy node since reset

bondy_sockets_opened_total

counter

The number of sockets opened on a bondy node since reset

bondy_sockets_total

gauge

The number of active sockets on a bondy node

bondy_wamp_abort_messages_total

counter

The total number of abort messages routed by a bondy node since reset

bondy_wamp_authenticate_messages_total

counter

The total number of authenticate messages routed by a bondy node since reset

bondy_wamp_call_latency_milliseconds

histogram

A histogram of routed RPC response latencies

bondy_wamp_call_messages_total

counter

The total number of call messages routed by a bondy node since reset

bondy_wamp_call_retries_total

counter

The total number of retries for WAMP call

bondy_wamp_cancel_messages_total

counter

The total number of cancel messages routed by a bondy node since reset

bondy_wamp_challenge_messages_total

counter

The total number of challenge messages routed by a bondy node since reset

bondy_wamp_error_messages_total

counter

The total number of error messages routed by a bondy node since reset

bondy_wamp_event_messages_total

counter

The total number of event messages routed by a bondy node since reset

bondy_wamp_goodbye_messages_total

counter

The total number of goodbye messages routed by a bondy node since reset

bondy_wamp_hello_messages_total

counter

The total number of hello messages routed by a bondy node since reset

bondy_wamp_interrupt_messages_total

counter

The total number of interrupt messages routed by a bondy node since reset

bondy_wamp_invocation_messages_total

counter

The total number of invocation messages routed by a bondy node since reset

bondy_wamp_message_bytes

histogram

A summary of the size of the wamp messages received by a bondy node

bondy_wamp_messages_total

counter

The total number of wamp messages routed by a bondy node since reset

bondy_wamp_publish_messages_total

counter

The total number of publish messages routed by a bondy node since reset

bondy_wamp_published_messages_total

counter

The total number of published messages routed by a bondy node since reset

bondy_wamp_register_messages_total

counter

The total number of register messages routed by a bondy node since reset

bondy_wamp_registered_messages_total

counter

The total number of registered messages routed by a bondy node since reset

bondy_wamp_result_messages_total

counter

The total number of result messages routed by a bondy node since reset

bondy_wamp_subscribe_messages_total

counter

The total number of subscribe messages routed by a bondy node since reset

bondy_wamp_subscribed_messages_total

counter

The total number of subscribed messages routed by a bondy node since reset

bondy_wamp_unregister_messages_total

counter

The total number of unregister messages routed by a bondy node since reset

bondy_wamp_unregistered_messages_total

counter

The total number of unregistered messages routed by a bondy node since reset

bondy_wamp_unsubscribe_messages_total

counter

The total number of unsubscribe messages routed by a bondy node since reset

bondy_wamp_unsubscribed_messages_total

counter

The total number of unsubscribed messages routed by a bondy node since reset

bondy_wamp_welcome_messages_total

counter

The total number of welcome messages routed by a bondy node since reset

bondy_wamp_yield_messages_total

counter

The total number of yield messages routed by a bondy node since reset

cowboy_early_errors_total

counter

cowboy_early_errors_total Total number of Cowboy early errors

cowboy_errors_total

counter

cowboy_errors_total Total number of Cowboy request errors

cowboy_protocol_upgrades_total

counter

cowboy_protocol_upgrades_total Total number of protocol upgrades

cowboy_receive_body_duration_seconds

histogram

cowboy_receive_body_duration_seconds Request body receiving duration

cowboy_request_duration_seconds

histogram

cowboy_request_duration_seconds Cowboy request duration

cowboy_requests_total

counter

cowboy_requests_total Total number of Cowboy requests

cowboy_spawned_processes_total

counter

cowboy_spawned_processes_total Total number of spawned processes

erlang_vm_allocators

gauge

erlang_vm_allocators Allocated (carriers_size) and used (blocks_size) memory for the different allocators in the VM

erlang_vm_atom_count

gauge

erlang_vm_atom_count The number of atom currently existing at the local node

erlang_vm_atom_limit

gauge

erlang_vm_atom_limit The maximum number of simultaneously existing atom at the local node

erlang_vm_dirty_cpu_schedulers

gauge

erlang_vm_dirty_cpu_schedulers The number of scheduler dirty CPU scheduler threads used by the emulator

erlang_vm_dirty_cpu_schedulers_online

gauge

erlang_vm_dirty_cpu_schedulers_online The number of dirty CPU scheduler threads online

erlang_vm_dirty_io_schedulers

gauge

erlang_vm_dirty_io_schedulers The number of scheduler dirty I/O scheduler threads used by the emulator

erlang_vm_dist_node_state

gauge

erlang_vm_dist_node_state The current state of the distribution link

erlang_vm_dist_port_input_bytes

gauge

erlang_vm_dist_port_input_bytes The total number of bytes read from the port

erlang_vm_dist_port_memory_bytes

gauge

erlang_vm_dist_port_memory_bytes The total number of bytes allocated for this port by the runtime system

erlang_vm_dist_port_output_bytes

gauge

erlang_vm_dist_port_output_bytes The total number of bytes written to the port

erlang_vm_dist_port_queue_size_bytes

gauge

erlang_vm_dist_port_queue_size_bytes The total number of bytes queued by the port using the ERTS driver queue implementation

erlang_vm_dist_proc_heap_size_words

gauge

erlang_vm_dist_proc_heap_size_words The size in words of the youngest heap generation of the process

erlang_vm_dist_proc_memory_bytes

gauge

erlang_vm_dist_proc_memory_bytes The size in bytes of the process

erlang_vm_dist_proc_message_queue_len

gauge

erlang_vm_dist_proc_message_queue_len The number of messages currently in the message queue of the process

erlang_vm_dist_proc_min_bin_vheap_size_words

gauge

erlang_vm_dist_proc_min_bin_vheap_size_words The minimum binary virtual heap size for the process

erlang_vm_dist_proc_min_heap_size_words

gauge

erlang_vm_dist_proc_min_heap_size_words The minimum heap size for the process

erlang_vm_dist_proc_reductions

gauge

erlang_vm_dist_proc_reductions The number of reductions executed by the process

erlang_vm_dist_proc_stack_size_words

gauge

erlang_vm_dist_proc_stack_size_words The stack size, in words, of the process

erlang_vm_dist_proc_status

gauge

erlang_vm_dist_proc_status The current status of the distribution process

erlang_vm_dist_proc_total_heap_size_words

gauge

erlang_vm_dist_proc_total_heap_size_words The total size, in words, of all heap fragments of the process

erlang_vm_dist_recv_avg_bytes

gauge

erlang_vm_dist_recv_avg_bytes Average size of packets, in bytes, received by the socket

erlang_vm_dist_recv_bytes

gauge

erlang_vm_dist_recv_bytes Number of bytes received by the socket

erlang_vm_dist_recv_cnt

gauge

erlang_vm_dist_recv_cnt Number of packets received by the socket

erlang_vm_dist_recv_dvi_bytes

gauge

erlang_vm_dist_recv_dvi_bytes Average packet size deviation, in bytes, received by the socket

erlang_vm_dist_recv_max_bytes

gauge

erlang_vm_dist_recv_max_bytes Size of the largest packet, in bytes, received by the socket

erlang_vm_dist_send_avg_bytes

gauge

erlang_vm_dist_send_avg_bytes Average size of packets, in bytes, sent from the socket

erlang_vm_dist_send_bytes

gauge

erlang_vm_dist_send_bytes Number of bytes sent from the socket

erlang_vm_dist_send_cnt

gauge

erlang_vm_dist_send_cnt Number of packets sent from the socket

erlang_vm_dist_send_max_bytes

gauge

erlang_vm_dist_send_max_bytes Size of the largest packet, in bytes, sent from the socket

erlang_vm_dist_send_pend_bytes

gauge

erlang_vm_dist_send_pend_bytes Number of bytes waiting to be sent by the socket

erlang_vm_ets_limit

gauge

erlang_vm_ets_limit The maximum number of ETS tables allowed

erlang_vm_logical_processors

gauge

erlang_vm_logical_processors The detected number of logical processors configured in the system

erlang_vm_logical_processors_available

gauge

erlang_vm_logical_processors_available The detected number of logical processors available to the Erlang runtime system

erlang_vm_logical_processors_online

gauge

erlang_vm_logical_processors_online The detected number of logical processors online on the system

erlang_vm_memory_atom_bytes_total

gauge

erlang_vm_memory_atom_bytes_total The total amount of memory currently allocated for atoms

erlang_vm_memory_bytes_total

gauge

erlang_vm_memory_bytes_total The total amount of memory currently allocated

erlang_vm_memory_dets_tables

gauge

erlang_vm_memory_dets_tables Erlang VM DETS Tables count

erlang_vm_memory_ets_tables

gauge

erlang_vm_memory_ets_tables Erlang VM ETS Tables count

erlang_vm_memory_processes_bytes_total

gauge

erlang_vm_memory_processes_bytes_total The total amount of memory currently allocated for the Erlang processes

erlang_vm_memory_system_bytes_total

gauge

erlang_vm_memory_system_bytes_total The total amount of memory currently allocated for the emulator that is not directly related to any Erlang process

erlang_vm_msacc_alloc_seconds_total

counter

erlang_vm_msacc_alloc_seconds_total Total time in seconds spent managing memory

erlang_vm_msacc_aux_seconds_total

counter

erlang_vm_msacc_aux_seconds_total Total time in seconds spent handling auxiliary jobs

erlang_vm_msacc_bif_seconds_total

counter

erlang_vm_msacc_bif_seconds_total Total time in seconds spent in BIFs

erlang_vm_msacc_busy_wait_seconds_total

counter

erlang_vm_msacc_busy_wait_seconds_total Total time in seconds spent busy waiting

erlang_vm_msacc_check_io_seconds_total

counter

erlang_vm_msacc_check_io_seconds_total Total time in seconds spent checking for new I/O events

erlang_vm_msacc_emulator_seconds_total

counter

erlang_vm_msacc_emulator_seconds_total Total time in seconds spent executing Erlang processes

erlang_vm_msacc_ets_seconds_total

counter

erlang_vm_msacc_ets_seconds_total Total time in seconds spent executing ETS BIFs

erlang_vm_msacc_gc_full_seconds_total

counter

erlang_vm_msacc_gc_full_seconds_total Total time in seconds spent doing fullsweep garbage collection

erlang_vm_msacc_gc_seconds_total

counter

erlang_vm_msacc_gc_seconds_total Total time in seconds spent doing garbage collection

erlang_vm_msacc_nif_seconds_total

counter

erlang_vm_msacc_nif_seconds_total Total time in seconds spent in NIFs

erlang_vm_msacc_other_seconds_total

counter

erlang_vm_msacc_other_seconds_total Total time in seconds spent doing unaccounted things

erlang_vm_msacc_port_seconds_total

counter

erlang_vm_msacc_port_seconds_total Total time in seconds spent executing ports

erlang_vm_msacc_send_seconds_total

counter

erlang_vm_msacc_send_seconds_total Total time in seconds spent sending messages (processes only)

erlang_vm_msacc_sleep_seconds_total

counter

erlang_vm_msacc_sleep_seconds_total Total time in seconds spent sleeping

erlang_vm_msacc_timers_seconds_total

counter

erlang_vm_msacc_timers_seconds_total Total time in seconds spent managing timers

erlang_vm_port_count

gauge

erlang_vm_port_count The number of ports currently existing at the local node

erlang_vm_port_limit

gauge

erlang_vm_port_limit The maximum number of simultaneously existing ports at the local node

erlang_vm_process_count

gauge

erlang_vm_process_count The number of processes currently existing at the local node

erlang_vm_process_limit

gauge

erlang_vm_process_limit The maximum number of simultaneously existing processes at the local node

erlang_vm_schedulers

gauge

erlang_vm_schedulers The number of scheduler threads used by the emulator

erlang_vm_schedulers_online

gauge

erlang_vm_schedulers_online The number of schedulers online

erlang_vm_smp_support

untyped

erlang_vm_smp_support 1 if the emulator has been compiled with SMP support, otherwise 0

erlang_vm_statistics_bytes_output_total

counter

erlang_vm_statistics_bytes_output_total Total number of bytes output to ports

erlang_vm_statistics_bytes_received_total

counter

erlang_vm_statistics_bytes_received_total Total number of bytes received through ports

erlang_vm_statistics_context_switches

counter

erlang_vm_statistics_context_switches Total number of context switches since the system started

erlang_vm_statistics_dirty_cpu_run_queue_length

gauge

erlang_vm_statistics_dirty_cpu_run_queue_length Length of the dirty CPU run-queue

erlang_vm_statistics_dirty_io_run_queue_length

gauge

erlang_vm_statistics_dirty_io_run_queue_length Length of the dirty IO run-queue

erlang_vm_statistics_garbage_collection_bytes_reclaimed

counter

erlang_vm_statistics_garbage_collection_bytes_reclaimed Garbage collection: bytes reclaimed

erlang_vm_statistics_garbage_collection_number_of_gcs

counter

erlang_vm_statistics_garbage_collection_number_of_gcs Garbage collection: number of GCs

erlang_vm_statistics_garbage_collection_words_reclaimed

counter

erlang_vm_statistics_garbage_collection_words_reclaimed Garbage collection: words reclaimed

erlang_vm_statistics_reductions_total

counter

erlang_vm_statistics_reductions_total Total reductions

erlang_vm_statistics_run_queues_length_total

gauge

erlang_vm_statistics_run_queues_length_total Length of normal run-queues

erlang_vm_statistics_runtime_milliseconds

counter

erlang_vm_statistics_runtime_milliseconds The sum of the runtime for all threads in the Erlang runtime system

erlang_vm_statistics_wallclock_time_milliseconds

counter

erlang_vm_statistics_wallclock_time_milliseconds Information about wall clock

erlang_vm_thread_pool_size

gauge

erlang_vm_thread_pool_size The number of async threads in the async thread pool used for asynchronous driver calls

erlang_vm_threads

untyped

erlang_vm_threads 1 if the emulator has been compiled with thread support, otherwise 0

erlang_vm_time_correction

untyped

erlang_vm_time_correction 1 if time correction is enabled, otherwise 0

erlang_vm_wordsize_bytes

gauge

erlang_vm_wordsize_bytes The size of Erlang term words in bytes

telemetry_scrape_duration_seconds

summary

telemetry_scrape_duration_seconds Scrape duration

telemetry_scrape_encoded_size_bytes

summary

telemetry_scrape_encoded_size_bytes Scrape size, encoded

telemetry_scrape_size_bytes

summary

telemetry_scrape_size_bytes Scrape size, not encoded