Solución de problemas del gateway

Sigue este orden para aislar un problema sin cambiar varios componentes a la vez: primero la fuente de métricas, después OAuth 2.0, luego el exportador y por último la visualización en Eyenode.

Comprobación rápida

1. Desde el proceso del agente, confirma que node_exporter:9100/metrics responde.
2. Comprueba que las cuatro variables OTEL_GATEWAY_* están disponibles para el proceso, sin imprimir su secreto.
3. Revisa los logs de scrape y exportación. En OpenTelemetry Collector, confirma primero las métricas del exportador debug.
4. Confirma el endpoint HTTPS del gateway y valida en Eyenode el tenant y rango de tiempo seleccionados.

Problemas frecuentes

Síntoma	Qué revisar	Siguiente acción
401 o falla al obtener token	URL de token, client ID, secreto codificado como base64(username:app_password) y scope openid.	Corrige la variable afectada, reinicia el agente y revisa los logs de autenticación.
No hay métricas locales	Conectividad, DNS, permisos de red y la ruta /metrics de la fuente.	Valida la fuente desde el mismo entorno donde corre el agente.
Hay métricas en debug, pero no en Eyenode	OTEL_GATEWAY_ENDPOINT, conectividad HTTPS y logs del exportador OTLP/HTTP.	Revisa la URL, la red de salida y el error exacto del exportador.
El Collector no reconoce oauth2client	Distribución instalada.	Usa OpenTelemetry Collector Contrib o una distribución que incluya esa extensión.
Alloy no hace scrape	Target, intervalo, DNS y red de Alloy al endpoint Prometheus.	Corrige el bloque prometheus.scrape y vuelve a revisar los logs.

Reúne evidencia útil

Comparte únicamente mensajes de error y marcas de tiempo; elimina tokens, secretos y cabeceras de autorización. Indica qué guía seguiste: OpenTelemetry Collector o Grafana Alloy.