Skip to main content
Las analíticas requieren un plan Pro o Enterprise. La transmisión de analíticas solo está disponible en planes Enterprise.
Transmite los eventos de analíticas a Amazon S3 casi en tiempo real para enviarlos a tu data warehouse o a pipelines de analíticas posteriores sin esperar a las exportaciones CSV. Los administradores de la organización pueden agregar múltiples destinos, seleccionar qué categorías de eventos enviar y elegir desde qué deployments transmitir. La transmisión de analíticas utiliza un modelo de inclusión: no se transmite ningún evento hasta que selecciones al menos una categoría y un deployment. Las mismas selecciones de categoría y deployment se aplican a todos los destinos.

Agregar un destino

  1. Ve a la página de Streaming de tu dashboard.
  2. En la sección Analytics streaming, selecciona Configure.
  3. Selecciona Add destination.
  4. Ingresa una etiqueta opcional y luego proporciona el bucket de Amazon S3, la región de AWS, el access key ID y la secret access key. Opcionalmente, ingresa un prefijo que Mintlify añadirá al principio de cada clave de objeto.
  5. Selecciona Add destination.
Crea un usuario de AWS Identity and Access Management (IAM) con una access key cuya política permita escribir en el bucket de destino. Mintlify no admite la asunción de roles ni credenciales temporales que requieran un token de sesión. Como mínimo, otorga s3:PutObject sobre el bucket y el prefijo de clave que planeas usar. Por ejemplo:
Usa el access key ID y la secret access key de ese usuario IAM al agregar el destino. El prefijo de clave es opcional. Mintlify lo añade al principio de cada clave de objeto.
Para dejar de transmitir a un destino, abre la configuración de streaming y selecciona el ícono de eliminar junto al destino.

Selecciona las categorías transmitidas

  1. Ve a la página de Streaming de tu dashboard.
  2. En la sección Analytics streaming, selecciona Configure.
  3. En Streamed categories, selecciona las categorías que quieres enviar. Los ejemplos resumen cada categoría. Usa el valor eventType transmitido para identificar el evento exacto.
  4. Selecciona Save changes.

Selecciona los deployments transmitidos

Selecciona cuáles de los deployments de tu organización envían eventos. El dashboard lista cada deployment por subdominio. Si creas un deployment, regresa a la configuración de streaming y selecciónalo. Los nuevos deployments no comienzan a transmitir eventos automáticamente.
  1. Ve a la página de Streaming de tu dashboard.
  2. En la sección Analytics streaming, selecciona Configure.
  3. En Streamed deployments, selecciona los deployments desde los que quieres enviar eventos.
  4. Selecciona Save changes.
No se transmite ningún evento hasta que selecciones al menos una categoría y un deployment.

Comprende los datos transmitidos

Mintlify escribe objetos JSON delimitados por saltos de línea (.jsonl) en tu bucket. Mintlify genera los nombres de objeto a partir de marcas de tiempo UTC. Si configuras un prefijo de clave, Mintlify escribe los objetos bajo ese prefijo. Cada línea contiene un envoltorio de evento con un eventType y un payload. El eventType es el nombre del evento, como docs.content.view. El payload contiene el evento de analíticas como un objeto JSON o como una cadena codificada en JSON. Si payload es una cadena, parséala como JSON antes de cargarla en tu warehouse.
El payload del evento contiene los siguientes campos: Los cambios de configuración pueden tardar hasta un minuto en aplicarse.
Los eventos transmitidos pueden contener datos personales, incluidas direcciones IP, identificadores de usuarios y sesiones, consultas y respuestas del assistant, y comentarios o información de contacto de feedback. Aplica los controles de acceso, políticas de retención y otros requisitos de manejo de datos apropiados para tu organización.