Telemetría

Cuando ejecutas un nodo en una red de Aptos, tu nodo enviará datos de telemetría a Aptos Labs. Todos los tipos de nodos (ej., validators, VFNs y PFNs) envían datos de telemetría. Esto también ocurre para otros binarios (ej., el CLI de Aptos). Si prefieres no enviar telemetría, puedes deshabilitar la telemetría usando las instrucciones abajo.

Telemetría de nodo

Las categorías de información recolectadas por la telemetría de nodo Aptos, para el binario aptos-node, se listan abajo:

Métricas centrales: Las métricas centrales son aquellas emitidas por los componentes centrales del binario aptos-node. Estas incluyen, sincronización de estado, consenso, mempool y almacenamiento. Puedes ver la lista completa de métricas centrales, aquí.
Información de construcción: Información de construcción de Rust, incluyendo las versiones de Rust, cargo, la arquitectura objetivo y la etiqueta de construcción también se recolectan. Puedes ver la lista completa de información de construcción, aquí.
Información del sistema: La información del sistema también es recolectada por la telemetría del nodo. Esto incluye información de recursos (ej., especificaciones de CPU, RAM, disco y red) así como información del sistema operativo. Puedes ver la lista completa de información del sistema, aquí.
Métricas de red: Las métricas de red también son recolectadas por la telemetría del nodo. Estas incluyen información de red como el número de pares conectados, el número de mensajes entrantes y salientes, y el tamaño de mensajes enviados y recibidos. Puedes ver la lista completa de métricas de red, aquí.
Métricas de Prometheus: Las métricas de Prometheus también son recolectadas por la telemetría del nodo. Estas incluyen métricas de tiempo de ejecución para todos los componentes del binario aptos-node. Puedes ver la lista completa de métricas de Prometheus visitando el endpoint de métricas en tu nodo usando el servicio de inspección de nodos.
Logs del nodo: Los logs de nivel warn y superior también son recolectados por la telemetría del nodo. Estos se usan para monitorear la salud de la red. Puedes identificar estos logs filtrando los logs para el binario aptos-node, localmente.

Telemetría del CLI

Las categorías de información recolectadas por la telemetría del CLI de Aptos, para el CLI aptos, se listan abajo:

Métricas de comandos: Las métricas de comandos son aquellas emitidas por el CLI cuando se ejecuta un comando. Estas incluyen el comando mismo, la latencia del comando, y el éxito o falla del comando. Puedes ver la lista completa de métricas del CLI, aquí.
Información de construcción: Información de construcción de Rust, incluyendo las versiones de Rust, cargo, la arquitectura objetivo y la etiqueta de construcción también se recolectan para el CLI. Puedes ver la lista completa de información de construcción, aquí.

Deshabilitar telemetría

En macOS y Linux, puedes establecer la variable de entorno APTOS_DISABLE_TELEMETRY para deshabilitar las métricas enviadas por tanto el nodo Aptos como la herramienta CLI de Aptos. Para deshabilitar toda la telemetría, establece el entorno APTOS_DISABLE_TELEMETRY a true:

export APTOS_DISABLE_TELEMETRY=true

El comando anterior solo deshabilita la telemetría para una sola sesión en la terminal actual donde ejecutas el comando. Para deshabilitarla permanentemente a través de todas las terminales e invocaciones de binarios Aptos, inclúyela en tu perfil de inicio. Por ejemplo:

echo "export APTOS_DISABLE_TELEMETRY=true" >> ~/.profile
source ~/.profile

Configurar telemetría

También puedes configurar la telemetría para deshabilitar métricas específicas de telemetría y recolecciones. La lista de variables de entorno abajo muestra las variables que puedes establecer para configurar telemetría para nodos Aptos y el CLI:

APTOS_DISABLE_TELEMETRY: Esto deshabilita toda la emisión de telemetría, incluyendo enviar telemetría al servicio Google Analytics (GA4).
APTOS_FORCE_ENABLE_TELEMETRY: Esto anula la verificación de ID de cadena y fuerza al nodo Aptos a enviar telemetría independientemente de si el servicio remoto la acepta o no.
APTOS_DISABLE_TELEMETRY_PUSH_METRICS: Esto deshabilita enviar métricas de Prometheus.
APTOS_DISABLE_TELEMETRY_PUSH_LOGS: Esto deshabilita enviar logs.
APTOS_DISABLE_TELEMETRY_PUSH_EVENTS: Esto deshabilita enviar eventos personalizados.
APTOS_DISABLE_LOG_ENV_POLLING: Esto deshabilita la capacidad dinámica de enviar logs verbosos.
APTOS_DISABLE_PROMETHEUS_NODE_METRICS: Esto deshabilita enviar las métricas de recursos del nodo Aptos como CPU del sistema, memoria, etc.