Historial de registros
Usa el historial de registros en Fetch Hive cuando quieras revisar ejecuciones individuales de prompts, workflows o agentes e inspeccionar lo que pasó durante una solicitud.Visión general
Fetch Hive te ofrece vistas de registros separadas para prompts, workflows, agentes y procesamiento de bases de conocimientos. Cada vista comienza con una tabla de ejecuciones y luego te permite abrir una hoja de detalles para una inspección más profunda de la traza y a nivel de ejecución. Estas vistas de registros son para investigación a nivel de recurso. Si quieres comenzar desde un usuario final rastreado y luego abrir sus ejecuciones, consulta Filtrado y exploración.¿Cómo abro los registros de prompts, workflows o agentes?
Abre una de estas secciones en la barra lateral principal:- Prompts
- Workflows
- Agents
- Knowledge Bases
req_... en la búsqueda global y elige Go to request para abrir directamente la página de detalles de la solicitud.
¿Cómo filtro los registros?
Las tres páginas de registros usan el control de rango de fechas en el encabezado, la paginación y los controles de visibilidad de columnas en la tabla. Cada página de registros también tiene su propio conjunto de filtros:- Los registros de Prompts admiten Provider, Model, API keys y Prompt
- Los registros de Workflows admiten API keys, Workflow (workflows del dashboard y despliegues de workflows), navegación por origen y Delivery
- Los registros de Agents admiten Provider, Model, API keys y navegación por origen
- Los registros de Knowledge Base admiten Knowledge Base, API keys y Type
Qué se rastrea
Las tablas de registros muestran los principales campos de ejecución que usas durante la depuración y el monitoreo. Según el tipo de recurso, Fetch Hive muestra combinaciones de:- Tiempo de terminación o ejecución
- Nombre del recurso
- Detalles del proveedor o del modelo
- Uso de herramientas
- Estado
- Costo total
- Total de tokens
- Duración
- Clave de API
- Colaborador
¿Cómo interpreto una hoja de detalles de ejecución?
Haz clic en una fila en la tabla de registros para abrir la hoja de detalles correspondiente. La hoja comienza con un encabezado que muestra el ID de la solicitud o ejecución, el estado actual y cualquier insignia de despliegue activo cuando esa ejecución provino de un despliegue. Debajo, Fetch Hive muestra una franja de resumen con los detalles más importantes a nivel de ejecución, como duración, costo, tokens, conteo de herramientas, propietario o tipo de cargo, según el tipo de ejecución. En el lado derecho de la hoja, Fetch Hive muestra el contenido detallado para la ejecución o el span seleccionado. Esto puede incluir el contenido de la respuesta, los detalles de la solicitud, las entradas, los metadatos y las secciones de salida. Para los spans de prompts, prompts en workflows y agentes respaldados por modelos, el panel de detalles muestra la razón de parada del modelo cuando el proveedor informa una. Esto ayuda a distinguir una parada normal de los límites de tokens, secuencias de parada, uso de herramientas o filtrado de contenido. Si un stream del proveedor se corta a mitad de la respuesta, Fetch Hive marca la ejecución como fallida y conserva la respuesta parcial más el error del proveedor en el detalle del registro.Trazas
Cuando una ejecución tiene una traza, Fetch Hive muestra un panel en cascada en el lado izquierdo de la hoja de detalles. Usa este panel para moverte por la ejecución paso a paso. Seleccionar un span actualiza el panel de detalles para que puedas inspeccionar el cronometraje y los detalles de carga útil de ese span. Algunas fases reportadas por el proveedor no incluyen límites reales de tiempo; Fetch Hive las muestra como marcadores estructurales con cronometraje no disponible en lugar de tratarlas como trabajo del proveedor con duración cero. Los detalles del span pueden incluir:- Duración
- Porcentaje del tiempo total de la ejecución
- Marcas de tiempo de inicio y finalización
- Clave de API
- Usuario
- Metadatos
- Salida
child_request_id para que las ejecuciones secundarias anidadas puedan abrirse individualmente y reconciliarse de vuelta en la traza principal incluso cuando la secundaria termina tarde o falla después de un trabajo parcial.
OpenTelemetry no es la fuente de verdad para esta vista de traza orientada al cliente. OTel es una capa de correlación interna que ayuda a ingeniería a seguir una solicitud a través de Rails, Sidekiq, Rust, Redis, SQL y HTTP saliente. Las filas de traza de Fetch Hive y Analytics V3 siguen usando los datos de traza del producto.
Notas
- Los registros de prompts y workflows admiten el cambio de Source, pero los registros de agentes no exponen esa navegación.
- Los registros de workflows actualizan las filas en ejecución a medida que cambia el estado, y una fila de workflow en ejecución no abre la hoja de detalles hasta que la ejecución ya no esté corriendo.
- La cascada de traza aparece cuando la ejecución tiene datos de traza disponibles.
- También puedes abrir estas mismas hojas de detalles desde la sección Users después de profundizar en un usuario final rastreado.