Tailscale client metrics

You can expose and collect Tailscale client metrics for use with monitoring systems such as Prometheus or Grafana for your Tailscale network (known as a tailnet). These metrics provide insights into client behavior, health, and performance. For example, you can monitor information about client connectivity to subnet routers configured in your tailnet.

Available metrics

You can collect the following metrics from the Tailscale clients in your tailnet:

Subnet router

Use the metrics in this section to collect Tailscale client information related to subnet routes.

tailscaled_advertised_routes

• The metric type is gauge.
• Displays the number of routes advertised by the client.
• Includes routes that are not approved.
• Does not include exit nodes.

tailscaled_approved_routes

• The metric type is gauge.
• Displays number of advertised routes that have been approved by an administrator.

Peer relay servers

Use the metrics in this section to collect information about the local peer relay instance.

tailscaled_peer_relay_forwarded_packets_total

• The metric type is counter.
• Displays the number of packets forwarded by the local peer relay instance.
• Labels:
  • transport_in: The transport protocol used for incoming packets. Possible values are udp4 for UDP over IPv4 and udp6 for UDP over IPv6.
  • transport_out: The transport protocol used for outgoing packets. Possible values are udp4 for UDP over IPv4 and udp6 for UDP over IPv6.

tailscaled_peer_relay_forwarded_bytes_total