Skip to content

Exportar la telemetría a tu backend de observabilidad

Agrega un destino OTLP que reciba las trazas y métricas propias de tu tenant, en Datadog, Dynatrace, Instana o cualquier backend compatible con OTLP.

Quién puede hacerlo

Un administrador del tenant, o un superadministrador de plataforma que trabaja dentro de tu tenant. La consola habilita Agregar destino y los controles de cada fila solo para quien tiene el permiso para gestionar los destinos de observabilidad del tenant.

Antes de empezar

  • La exportación de observabilidad por tenant solo existe en los despliegues SaaS. En cualquier otro despliegue, el panel lo indica y no ofrece nada que configurar.
  • La edición de tu tenant incluye la exportación de observabilidad. Hasta que agregues un destino, tu telemetría sigue llegando a los backends propios del despliegue.
  • Ten listos el endpoint OTLP del backend (una URL https en una dirección pública) y su clave de API.
  • Un tenant tiene como máximo cinco destinos.

Pasos

  1. Abre Configuración y selecciona la pestaña Integraciones.
  2. En la fila Exportación de observabilidad, selecciona Gestionar.
  3. Selecciona Agregar destino. En el diálogo:
    1. Nombre: único entre los destinos de tu tenant.
    2. Proveedor: la familia del backend. Define la forma del endpoint y de los encabezados.
    3. Endpoint OTLP: la URL https del backend.
    4. Clave de API: de solo escritura; se sella y no se vuelve a mostrar nunca.
    5. Señales a exportar: trazas, métricas o ambas. Se necesita al menos una.
    6. Enviar telemetría a este destino: déjalo activado para empezar a exportar de inmediato.
  4. Selecciona Guardar.

Para reemplazar la clave más adelante, selecciona Rotar clave en la fila, escribe la clave nueva y selecciona Rotar clave en el diálogo. Usa Editar, Deshabilitar o Eliminar para los demás cambios.

Qué ves cuando funcionó

La consola confirma que se creó el destino y lo lista en el panel con su proveedor, su endpoint y sus señales. La clave solo se muestra enmascarada. La telemetría de tu tenant, y solo la de tu tenant, se exporta a ese destino.

Si falla

Qué ves Causa Qué hacer
"Selecciona al menos una señal y proporciona un endpoint https válido." No hay ninguna señal seleccionada, o el endpoint no es una URL https Corrige el formulario
Se rechaza el endpoint por no ser un destino permitido Resuelve a una dirección privada, de loopback o de metadatos de la nube Usa el endpoint público del backend
Agregar destino no está disponible: "Se alcanzó el número máximo de destinos para este tenant." El tenant ya tiene cinco destinos Elimina uno que ya no uses
Se rechaza el nombre porque ya está en uso Otro destino de tu tenant tiene ese nombre Elige otro nombre
La fila indica que la exportación de observabilidad está incluida en una edición superior Tu edición no la incluye Contacta a tu gestor de cuenta
Guardar falla porque la custodia de secretos no está disponible La plataforma no pudo sellar la clave Vuelve a intentarlo más tarde; no se guardó nada, y en una rotación se conserva la clave anterior

Una persona que trabaja dentro de tu tenant con acceso de soporte no puede cambiar tus destinos de observabilidad.

Sin la consola

Superficie Cómo
API POST /api/v3/admin/tenants/{tenantId}/observability-backends (operación createObservabilityBackend)
API PUT /api/v3/admin/tenants/{tenantId}/observability-backends/{name} (operación replaceObservabilityBackend)
API PATCH /api/v3/admin/tenants/{tenantId}/observability-backends/{name}/credential (operación updateObservabilityBackendCredential)
API DELETE /api/v3/admin/tenants/{tenantId}/observability-backends/{name} (operación deleteObservabilityBackend)

Relacionado