Configura el gateway e instrumentación

Conecta un recolector local con el gateway de DDOSCOM Eyenode para enviar métricas mediante OAuth 2.0 y OTLP/HTTP. Elige el agente que ya operas; ambos usan el mismo contrato de gateway.

Antes de empezar

Necesitas un endpoint Prometheus accesible desde el recolector, un cliente OAuth 2.0 habilitado para el gateway y acceso seguro a variables de entorno. No agregues secretos al repositorio ni a archivos de configuración compartidos.

Variables del gateway

Entrega estos valores a través de tu gestor de secretos, sistema de despliegue o un archivo .env local que no se versiona:

OTEL_GATEWAY_ENDPOINT=https://otel-gateway.ddoscom.tech
OTEL_GATEWAY_OAUTH_TOKEN_URL=https://auth.ddoscom.tech/application/o/token/
OTEL_GATEWAY_OAUTH_CLIENT_ID=eyenode-gateway

# Usa base64(username:app_password). No uses el client secret del proveedor OAuth.
OTEL_GATEWAY_OAUTH_CLIENT_SECRET=base64-client-username-and-app-password
OTEL_GATEWAY_OAUTH_SCOPE=openid

Obtén OTEL_GATEWAY_OAUTH_CLIENT_SECRET desde el apartado Secrets del Dashboard de Eyenode. Es sensible: rótalo según la política de tu organización y evita imprimirlo en logs, terminales compartidas o tickets.

Elige tu guía

1. OpenTelemetry Collector para configuraciones YAML de OTel.
2. Grafana Alloy para configuraciones Alloy con componentes Prometheus y OTel.
3. Solución de problemas del gateway si la autenticación, el scrape o la entrega no funcionan como esperas.

[!NOTE] Las configuraciones iniciales habilitan solo el pipeline de métricas. Agrega pipelines independientes cuando estés listo para enviar logs o trazas.