Teleport integration metrics

The official Datadog integration for monitoring Teleport. It collects 211 metrics.

Definitions as of 2026-08-05

Official summary

Collect key metrics to monitor the health of your Teleport instance.

Metric types

count (occurrences in the interval): 182
gauge (value at a point in time): 29

Metrics

Descriptions are the official definitions, unedited.

Metric	Type	Unit
`teleport.auth.audit_log.emit_events`Number of audit events emitted	count	-
`teleport.auth.audit_log.failed_disk_monitoring`Number of times disk monitoring failed.	count	-
`teleport.auth.audit_log.failed_emit_events`Number of times emitting audit event failed.	count	-
`teleport.auth.audit_log.parquetlog_age_oldest_processed_message`Number of age of oldest event in Parquet-format audit log.	gauge	-
`teleport.auth.audit_log.parquetlog_batch_count`Total number of events in single batch in Parquet-format audit log.	count	-
`teleport.auth.audit_log.parquetlog_batch_processing_seconds.bucket`Duration of processing single batch of events in the Parquet-format audit log.	count	second
`teleport.auth.audit_log.parquetlog_batch_processing_seconds.count`Duration of processing single batch of events in the Parquet-format audit log.	count	second
`teleport.auth.audit_log.parquetlog_batch_processing_seconds.sum`Duration of processing single batch of events in the Parquet-format audit log.	count	second
`teleport.auth.audit_log.parquetlog_batch_size.bucket`Overall size of events in single batch in Parquet-format audit log.	count	-
`teleport.auth.audit_log.parquetlog_batch_size.count`Overall size of events in single batch in Parquet-format audit log.	count	-
`teleport.auth.audit_log.parquetlog_batch_size.sum`Overall size of events in single batch in Parquet-format audit log.	count	-
`teleport.auth.audit_log.parquetlog_delete_events_seconds.bucket`Duration of deletion events from SQS in Parquet-format audit log.	count	second
`teleport.auth.audit_log.parquetlog_delete_events_seconds.count`Duration of deletion events from SQS in Parquet-format audit log.	count	second
`teleport.auth.audit_log.parquetlog_delete_events_seconds.sum`Duration of deletion events from SQS in Parquet-format audit log.	count	second
`teleport.auth.audit_log.parquetlog_errors_from_collect_count`Number of collect failures in Parquet-format audit log.	count	-
`teleport.auth.audit_log.parquetlog_last_processed_timestamp`Number of last processing time in Parquet-format audit log.	gauge	-
`teleport.auth.audit_log.parquetlog_s3_flush_seconds.bucket`Duration of flushing parquet files to S3 in Parquet-format audit log.	count	second
`teleport.auth.audit_log.parquetlog_s3_flush_seconds.count`Duration of flushing parquet files to S3 in Parquet-format audit log.	count	second
`teleport.auth.audit_log.parquetlog_s3_flush_seconds.sum`Duration of flushing parquet files to S3 in Parquet-format audit log.	count	second
`teleport.auth.audit_log.percentage_disk_space_used`Percentage disk space used.	gauge	-
`teleport.auth.audit_log.server_open_files`Number of open audit files	gauge	-
`teleport.auth.backend.dynamo_requests`Total number of requests to the DYNAMO API.	count	-
`teleport.auth.backend.dynamo_requests_seconds.bucket`Latency of DynamoDB API requests.	count	second
`teleport.auth.backend.dynamo_requests_seconds.count`Latency of DynamoDB API requests.	count	second
`teleport.auth.backend.dynamo_requests_seconds.sum`Latency of DynamoDB API requests.	count	second
`teleport.auth.backend.etcd_backend_batch_read_requests`Number of read requests to the etcd database.	count	-
`teleport.auth.backend.etcd_backend_batch_read_seconds.bucket`Latency for etcd read operations.	count	second
`teleport.auth.backend.etcd_backend_batch_read_seconds.count`Latency for etcd read operations.	count	second
`teleport.auth.backend.etcd_backend_batch_read_seconds.sum`Latency for etcd read operations.	count	second
`teleport.auth.backend.etcd_backend_read_requests`Number of read requests to the etcd database.	count	-
`teleport.auth.backend.etcd_backend_read_seconds.bucket`Latency for etcd read operations.	count	second
`teleport.auth.backend.etcd_backend_read_seconds.count`Latency for etcd read operations.	count	second
`teleport.auth.backend.etcd_backend_read_seconds.sum`Latency for etcd read operations.	count	second
`teleport.auth.backend.etcd_backend_tx_requests`Number of transaction requests to the database.	count	-
`teleport.auth.backend.etcd_backend_tx_seconds.bucket`Latency for etcd transaction operations.	count	second
`teleport.auth.backend.etcd_backend_tx_seconds.count`Latency for etcd transaction operations.	count	second
`teleport.auth.backend.etcd_backend_tx_seconds.sum`Latency for etcd transaction operations.	count	second
`teleport.auth.backend.etcd_backend_write_requests`Number of write requests to the database.	count	-
`teleport.auth.backend.etcd_backend_write_seconds.bucket`Latency for etcd write operations.	count	second
`teleport.auth.backend.etcd_backend_write_seconds.count`Latency for etcd write operations.	count	second
`teleport.auth.backend.etcd_backend_write_seconds.sum`Latency for etcd write operations.	count	second
`teleport.auth.backend.etcd_teleport_etcd_event_backpressure`Total number of times event processing encountered backpressure.	count	-
`teleport.auth.backend.etcd_teleport_etcd_events`Total number of etcd events processed.	count	-
`teleport.auth.backend.firestore_events_backend_batch_read_requests`Number of batch read requests to Cloud Firestore events.	count	-
`teleport.auth.backend.firestore_events_backend_batch_read_seconds.bucket`Latency for Cloud Firestore events batch read operations.	count	second
`teleport.auth.backend.firestore_events_backend_batch_read_seconds.count`Latency for Cloud Firestore events batch read operations.	count	second
`teleport.auth.backend.firestore_events_backend_batch_read_seconds.sum`Latency for Cloud Firestore events batch read operations.	count	second
`teleport.auth.backend.firestore_events_backend_batch_write_requests`Number of batch write requests to Cloud Firestore events.	count	-
`teleport.auth.backend.firestore_events_backend_batch_write_seconds.bucket`Latency for Cloud Firestore events batch write operations.	count	second
`teleport.auth.backend.firestore_events_backend_batch_write_seconds.count`Latency for Cloud Firestore events batch write operations.	count	second
`teleport.auth.backend.firestore_events_backend_batch_write_seconds.sum`Latency for Cloud Firestore events batch write operations.	count	second
`teleport.auth.backend.firestore_events_backend_write_requests`Number of write requests to Cloud Firestore events.	count	-
`teleport.auth.backend.firestore_events_backend_write_seconds.bucket`Latency for Cloud Firestore events write operations.	count	second
`teleport.auth.backend.firestore_events_backend_write_seconds.count`Latency for Cloud Firestore events write operations.	count	second
`teleport.auth.backend.firestore_events_backend_write_seconds.sum`Latency for Cloud Firestore events write operations.	count	second
`teleport.auth.backend.gcs_event_storage_downloads`Number of downloads from the GCS backend.	count	-
`teleport.auth.backend.gcs_event_storage_downloads_seconds.bucket`Latency for GCS download operations.	count	second
`teleport.auth.backend.gcs_event_storage_downloads_seconds.count`Latency for GCS download operations.	count	second
`teleport.auth.backend.gcs_event_storage_downloads_seconds.sum`Latency for GCS download operations.	count	second
`teleport.auth.backend.gcs_event_storage_uploads`Number of uploads to the GCS backend.	count	-
`teleport.auth.backend.gcs_event_storage_uploads_seconds.bucket`Latency for GCS upload operations.	count	second
`teleport.auth.backend.gcs_event_storage_uploads_seconds.count`Latency for GCS upload operations.	count	second
`teleport.auth.backend.gcs_event_storage_uploads_seconds.sum`Latency for GCS upload operations.	count	second
`teleport.auth.backend.s3_requests`Total number of requests to the S3 API.	count	-
`teleport.auth.backend.s3_requests_seconds.bucket`Request latency for the S3 API.	count	second
`teleport.auth.backend.s3_requests_seconds.count`Total number of requests to the S3 API.	count	second
`teleport.auth.backend.s3_requests_seconds.sum`Total number of requests to the S3 API grouped by result.	count	second
`teleport.auth.cache.backend_batch_read_requests`Number of read requests to the backend	count	-
`teleport.auth.cache.backend_batch_read_seconds.bucket`Latency for batch read operations	count	second
`teleport.auth.cache.backend_batch_read_seconds.count`Latency for batch read operations	count	second
`teleport.auth.cache.backend_batch_read_seconds.sum`Latency for batch read operations	count	second
`teleport.auth.cache.backend_batch_write_requests`Number of batch write requests to the backend	count	-
`teleport.auth.cache.backend_batch_write_seconds.bucket`Latency for backend batch write operations	count	second
`teleport.auth.cache.backend_batch_write_seconds.count`Latency for backend batch write operations	count	second
`teleport.auth.cache.backend_batch_write_seconds.sum`Latency for backend batch write operations	count	second
`teleport.auth.cache.backend_read_requests`Number of read requests to the backend	count	-
`teleport.auth.cache.backend_read_seconds.bucket`Latency for read operations	count	second
`teleport.auth.cache.backend_read_seconds.count`Latency for read operations	count	second
`teleport.auth.cache.backend_read_seconds.sum`Latency for read operations	count	second
`teleport.auth.cache.backend_requests`Number of requests to the backend (reads, writes, and keepalives)	count	-
`teleport.auth.cache.backend_write_requests`Number of write requests to the backend	count	-
`teleport.auth.cache.backend_write_seconds.bucket`Latency for backend write operations	count	second
`teleport.auth.cache.backend_write_seconds.count`Latency for backend write operations	count	second
`teleport.auth.cache.backend_write_seconds.sum`Latency for backend write operations	count	second
`teleport.auth.cache.watcher_event_sizes.bucket`Overall size of events emitted	count	-
`teleport.auth.cache.watcher_event_sizes.count`Overall size of events emitted	count	-
`teleport.auth.cache.watcher_event_sizes.sum`Overall size of events emitted	count	-
`teleport.auth.cache.watcher_events.bucket`Per resources size of events emitted	count	-
`teleport.auth.cache.watcher_events.count`Per resources size of events emitted	count	-
`teleport.auth.cache.watcher_events.sum`Per resources size of events emitted	count	-
`teleport.auth.cluster_name_not_found`Number of times a cluster name was not found	count	-
`teleport.auth.connected_resources`Number and type of resources connected via keepalives.	gauge	-
`teleport.auth.generate_requests`Number of current generate requests for server keys	gauge	-
`teleport.auth.generate_requests_throttled`Number of throttled requests to generate new server keys	count	-
`teleport.auth.generate_seconds.bucket`Latency for generate requests for server keys	count	second
`teleport.auth.generate_seconds.count`Latency for generate requests for server keys	count	second
`teleport.auth.generate_seconds.sum`Latency for generate requests for server keys	count	second
`teleport.auth.grpc_server_handled`Total number of RPCs completed on the server, regardless of success or failure.	count	-
`teleport.auth.grpc_server_msg_received`Total number of RPC stream messages received on the server.	count	-
`teleport.auth.grpc_server_msg_sent`Total number of gRPC stream messages sent by the server.	count	-
`teleport.auth.grpc_server_started`Total number of RPCs started on the server.	count	-
`teleport.auth.heartbeat_connections_received`Number of times auth received a heartbeat connection.	count	-
`teleport.auth.migrations`Tracks for each migration if it is active (1) or not (0).	gauge	-
`teleport.auth.registered_servers`The number of Teleport services that are connected to an Auth Service instance grouped by version.	gauge	-
`teleport.auth.registered_servers_by_install_methods`The number of Teleport services that are connected to an Auth Service instance grouped by install methods.	gauge	-
`teleport.auth.roles`Number of roles that exist in the cluster.	gauge	-
`teleport.auth.user_login`Number of user logins.	count	-
`teleport.bpf.lost_command_events`Number of lost command events.	count	-
`teleport.bpf.lost_disk_events`Number of lost disk events.	count	-
`teleport.bpf.lost_network_events`Number of lost network events.	count	-
`teleport.common.certificate_mismatch`Number of times there was a certificate mismatch	count	-
`teleport.common.process_state`State of the teleport process: 0 - ok, 1 - recovering, 2 - degraded, 3 - starting	gauge	-
`teleport.common.rx`Number of bytes received.	count	byte
`teleport.common.server_interactive_sessions_total`Number of active sessions to this host	gauge	-
`teleport.common.teleport_build_info`Provides build information of Teleport including gitref (git describe --long --tags), Go version, and Teleport version. The value of this gauge will always be 1.	gauge	-
`teleport.common.teleport_cache_events`Number of events received by a Teleport service cache. Teleport's Auth Service, Proxy Service, and other services cache incoming events related to their service.	count	-
`teleport.common.teleport_cache_stale_events`Number of stale events received by a Teleport service cache. A high percentage of stale events can indicate a degraded backend.	count	-
`teleport.common.tx`Number of bytes transmitted.	count	byte
`teleport.db.active_connections_total`Number of active DB connections	gauge	-
`teleport.db.connection_durations_seconds.bucket`Duration of DB connection	count	second
`teleport.db.connection_durations_seconds.count`Duration of DB connection	count	second
`teleport.db.connection_durations_seconds.sum`Duration of DB connection	count	second
`teleport.db.connection_setup_time_seconds.bucket`Initial time to setup DB connection, before any requests are handled	count	second
`teleport.db.connection_setup_time_seconds.count`Initial time to setup DB connection, before any requests are handled	count	second
`teleport.db.connection_setup_time_seconds.sum`Initial time to setup DB connection, before any requests are handled	count	second
`teleport.db.errors`Number of synthetic DB errors sent to the client	count	-
`teleport.db.initialized_connections`Number of initialized DB connections	count	-
`teleport.db.messages_from_client`Number of messages (packets) received from the DB client	count	-
`teleport.db.messages_from_server`Number of messages (packets) received from the DB server	count	-
`teleport.db.method_call_count`Number of times a DB method was called	count	-
`teleport.db.method_call_latency_seconds.bucket`Call latency for a DB method calls	count	second
`teleport.db.method_call_latency_seconds.count`Call latency for a DB method calls	count	second
`teleport.db.method_call_latency_seconds.sum`Call latency for a DB method calls	count	second
`teleport.kubernetes.client_first_byte_response_duration_seconds.bucket`Teleport Kubernetes Service Latency distribution of time to receive the first response byte from the upstream server.	count	second
`teleport.kubernetes.client_first_byte_response_duration_seconds.count`Teleport Kubernetes Service Latency distribution of time to receive the first response byte from the upstream server.	count	second
`teleport.kubernetes.client_first_byte_response_duration_seconds.sum`Teleport Kubernetes Service Latency distribution of time to receive the first response byte from the upstream server.	count	second
`teleport.kubernetes.client_got_conn_duration_seconds.bucket`Teleport Kubernetes Service Latency distribution of time to dial to the upstream server - using reversetunnel or direct dialer.	count	second
`teleport.kubernetes.client_got_conn_duration_seconds.count`Teleport Kubernetes Service Latency distribution of time to dial to the upstream server - using reversetunnel or direct dialer.	count	second
`teleport.kubernetes.client_got_conn_duration_seconds.sum`Teleport Kubernetes Service Latency distribution of time to dial to the upstream server - using reversetunnel or direct dialer.	count	second
`teleport.kubernetes.client_in_flight_requests`Teleport Kubernetes Service In-flight requests waiting for the upstream response.	gauge	-
`teleport.kubernetes.client_request_duration_seconds.bucket`Teleport Kubernetes Service Latency distribution of the upstream request time.	count	second
`teleport.kubernetes.client_request_duration_seconds.count`Teleport Kubernetes Service Latency distribution of the upstream request time.	count	second
`teleport.kubernetes.client_request_duration_seconds.sum`Teleport Kubernetes Service Latency distribution of the upstream request time.	count	second
`teleport.kubernetes.client_requests`Teleport Kubernetes Service Total number of requests sent to the upstream teleport proxy, kube_service or Kubernetes Cluster servers.	count	-
`teleport.kubernetes.client_tls_duration_seconds.bucket`Teleport Kubernetes Service Latency distribution of TLS handshakes.	count	second
`teleport.kubernetes.client_tls_duration_seconds.count`Teleport Kubernetes Service Latency distribution of TLS handshakes.	count	second
`teleport.kubernetes.client_tls_duration_seconds.sum`Teleport Kubernetes Service Latency distribution of TLS handshakes.	count	second
`teleport.kubernetes.server_api_requests`Total number of requests handled by the server.	count	-
`teleport.kubernetes.server_exec_in_flight_sessions`Number of active kubectl exec sessions.	gauge	-
`teleport.kubernetes.server_exec_sessions`Total number of kubectl exec sessions.	count	-
`teleport.kubernetes.server_in_flight_requests`In-flight requests currently handled by the server.	gauge	-
`teleport.kubernetes.server_join_in_flight_sessions`Number of active joining sessions.	gauge	-
`teleport.kubernetes.server_join_sessions`Total number of joining sessions.	count	-
`teleport.kubernetes.server_portforward_in_flight_sessions`Number of active kubectl portforward sessions.	gauge	-
`teleport.kubernetes.server_portforward_sessions`Total number of kubectl portforward sessions.	count	-
`teleport.kubernetes.server_request_duration_seconds.bucket`Latency distribution of the total request time.	count	second
`teleport.kubernetes.server_request_duration_seconds.count`Latency distribution of the total request time.	count	second
`teleport.kubernetes.server_request_duration_seconds.sum`Latency distribution of the total request time.	count	second
`teleport.kubernetes.server_response_size_bytes.bucket`Distribution of the response size.	count	byte
`teleport.kubernetes.server_response_size_bytes.count`Distribution of the response size.	count	byte
`teleport.kubernetes.server_response_size_bytes.sum`Distribution of the response size.	count	byte
`teleport.prom.http_metric_handler_requests`Total number of scrapes by HTTP status code.	count	-
`teleport.prom.http_metric_handler_requests_in_flight`Current number of scrapes being served.	gauge	-
`teleport.proxy.connection_limit_exceeded`Number of times the proxy connection limit was exceeded	count	-
`teleport.proxy.failed_connect_to_node_attempts`Number of failed SSH connection attempts to a node. Use with `teleport_connect_to_node_attempts_total` to get the failure rate.	count	-
`teleport.proxy.failed_login_attempts`Number of times there was a failed login	count	-
`teleport.proxy.grpc_client_handled`Total number of RPCs completed on the client, regardless of success or failure.	count	-
`teleport.proxy.grpc_client_msg_received`Total number of RPC stream messages received on the client.	count	-
`teleport.proxy.grpc_client_msg_sent`Total number of gRPC stream messages sent by the client.	count	-
`teleport.proxy.grpc_client_started`Total number of RPCs started on the client.	count	-
`teleport.proxy.missing_ssh_tunnels`Number of missing SSH tunnels	gauge	-
`teleport.proxy.peer_client_dial_error`Total number of errors encountered dialling peer Proxy Service instances.	count	-
`teleport.proxy.peer_client_message_received_size.bucket`Size of messages received by the client.	count	-
`teleport.proxy.peer_client_message_received_size.count`Size of messages received by the client.	count	-
`teleport.proxy.peer_client_message_received_size.sum`Size of messages received by the client.	count	-
`teleport.proxy.peer_client_message_sent_size.bucket`Size of messages sent by the client.	count	-
`teleport.proxy.peer_client_message_sent_size.count`Size of messages sent by the client.	count	-
`teleport.proxy.peer_client_message_sent_size.sum`Size of messages sent by the client.	count	-
`teleport.proxy.peer_client_rpc`Number of current client RPC requests.	gauge	-
`teleport.proxy.peer_client_rpc_duration_seconds.bucket`Duration in seconds of RPCs sent by the client.	count	second
`teleport.proxy.peer_client_rpc_duration_seconds.count`Duration in seconds of RPCs sent by the client.	count	second
`teleport.proxy.peer_client_rpc_duration_seconds.sum`Duration in seconds of RPCs sent by the client.	count	second
`teleport.proxy.peer_server_connections`Number of currently opened connection to proxy Proxy Service instances.	gauge	-
`teleport.proxy.peer_server_message_received_size.bucket`Size of messages received by the server.	count	-
`teleport.proxy.peer_server_message_received_size.count`Size of messages received by the server.	count	-
`teleport.proxy.peer_server_message_received_size.sum`Size of messages received by the server.	count	-
`teleport.proxy.peer_server_message_sent_size.bucket`Size of messages sent by the server.	count	-
`teleport.proxy.peer_server_message_sent_size.count`Size of messages sent by the server.	count	-
`teleport.proxy.peer_server_message_sent_size.sum`Size of messages sent by the server.	count	-
`teleport.proxy.peer_server_rpc`Number of current server RPC requests.	gauge	-
`teleport.proxy.peer_server_rpc_duration_seconds.bucket`Duration in seconds of RPCs sent by the server.	count	second
`teleport.proxy.peer_server_rpc_duration_seconds.count`Duration in seconds of RPCs sent by the server.	count	second
`teleport.proxy.peer_server_rpc_duration_seconds.sum`Duration in seconds of RPCs sent by the server.	count	second
`teleport.proxy.remote_clusters`Number of inbound connections from leaf clusters.	gauge	-
`teleport.proxy.ssh_sessions_total`Number of active sessions through this proxy	gauge	-
`teleport.proxy.teleport_connect_to_node_attempts`Number of SSH connection attempts to a node. Use with `failed_connect_to_node_attempts_total` to get the failure rate.	count	-
`teleport.proxy.teleport_proxy_db_active_connections_total`Number of currently active connections to DB service from Proxy service.	gauge	-
`teleport.proxy.teleport_proxy_db_attempted_servers_total.bucket`Number of servers processed during connection attempt to the DB service from Proxy service.	count	-
`teleport.proxy.teleport_proxy_db_attempted_servers_total.count`Number of servers processed during connection attempt to the DB service from Proxy service.	count	-
`teleport.proxy.teleport_proxy_db_attempted_servers_total.sum`Number of servers processed during connection attempt to the DB service from Proxy service.	count	-
`teleport.proxy.teleport_proxy_db_connection_dial_attempts`Number of dial attempts from Proxy to DB service made.	count	-
`teleport.proxy.teleport_proxy_db_connection_dial_failures`Number of failed dial attempts from Proxy to DB service made.	count	-
`teleport.proxy.teleport_proxy_db_connection_setup_time_seconds.bucket`Time to establish connection to DB service from Proxy service.	count	second
`teleport.proxy.teleport_proxy_db_connection_setup_time_seconds.count`Time to establish connection to DB service from Proxy service.	count	second
`teleport.proxy.teleport_proxy_db_connection_setup_time_seconds.sum`Time to establish connection to DB service from Proxy service.	count	second
`teleport.proxy.teleport_proxy_db_connection_tls_config_time_seconds.bucket`Time to fetch TLS configuration for the connection to DB service from Proxy service.	count	second
`teleport.proxy.teleport_proxy_db_connection_tls_config_time_seconds.count`Time to fetch TLS configuration for the connection to DB service from Proxy service.	count	second
`teleport.proxy.teleport_proxy_db_connection_tls_config_time_seconds.sum`Time to fetch TLS configuration for the connection to DB service from Proxy service.	count	second
`teleport.proxy.teleport_reverse_tunnels_connected`Number of reverse SSH tunnels connected to the Teleport Proxy Service by Teleport instances.	gauge	-
`teleport.proxy.trusted_clusters`Number of outbound connections to leaf clusters.	gauge	-
`teleport.ssh.user_max_concurrent_sessions_hit`Number of times a user exceeded their max concurrent ssh connections	count	-

Official documentation

Official documentation for the Teleport integration

Metric names and descriptions are the official Datadog integration definitions (Copyright Datadog, Inc., BSD-3-Clause), reproduced unedited. The full license terms are on the About page.

Official summary

Metric types

Metrics

Official documentation

Related products

Other Security integrations