Informes
Usa la descripción general de Radar y los informes guardados de Explorar para detectar patrones en los eventos y las respuestas de las mediciones, y conservar el cálculo que sustenta un análisis recurrente.
Los informes permiten pasar de una traducción individual a la identificación de un patrón. Un equipo puede descubrir qué idiomas concentran la mayor parte del trabajo registrado, qué respuestas de una medición cambiaron o dónde una regla falla de forma recurrente. La siguiente acción depende de lo que cuente el informe: más eventos, menos respuestas aprobadas y más tokens describen situaciones distintas.
Radar tiene dos pantallas de informes. Radar → Descripción general resume el mes actual: la puntuación promedio, las palabras generadas, los eventos de hoy y los valores que las mediciones calcularon para esos eventos. Radar → Explorar permite graficar eventos y respuestas de aprobación o rechazo o con puntuación numérica, y guardar esos gráficos como informes para la organización. Abre una respuesta individual en Resultados para revisar su texto y explicación. Las clasificaciones de patrones de edición quedan fuera de estos informes y de las listas de resultados; usa la tasa y la distancia de edición para localizar cambios y luego lee los textos comparados.
Pasa el cursor sobre el nombre de una tarjeta en la descripción general para ver qué cuenta. Las tarjetas de puntuación, palabras, eventos y Mediciones de hoy, así como Explorar, requieren el derecho de informes, disponible con el plan Enterprise; si no lo tienes, indican que los informes no están disponibles en tu plan.
Elige un informe según la pregunta que quieras responder #
| Pregunta | Dónde consultar |
|---|---|
| ¿Cuánto generó Lingo.dev este mes? | Palabras generadas en la descripción general; consulta Carga de trabajo de traducción. |
| ¿Cuánta actividad registró cada idioma, motor o proveedor? | Eventos en Explorar; consulta Carga de trabajo de traducción. |
| ¿Dónde modificaron los commits del repositorio el contenido localizado? | Los eventos de GitHub en Radar → Registros; consulta Cambios del repositorio. |
| ¿Cómo cambiaron las respuestas de las mediciones a lo largo del mes? | El panel de puntuación de la descripción general; consulta Resultados de evaluación. |
| ¿Qué respondió una medición, por idioma o motor? | Un informe de Mediciones en Explorar; consulta Resultados de evaluación. |
| ¿Con qué regularidad se respetaron las reglas o los términos? | Un informe de Puntuación de cumplimiento de reglas o del glosario, con explicaciones individuales en Resultados; consulta Resultados de evaluación. |
Las series de tokens y costos de modelos del período de la cuenta están en Configuración → Uso, no en Radar; encontrarás su explicación en Uso.
Crea un informe en Explorar #
- Abre Radar → Explorar. Selecciona Nuevo informe o abre Ejemplos y elige un informe basado en tus datos para ajustarlo.
- Para hacer seguimiento de una medición numérica o de aprobación o rechazo, selecciónala en Preajuste. El informe pasa a mostrar sus respuestas por semana durante los últimos 90 días: Puntuación con Promedio para una medición de 0 a 100, o Valor booleano con Promedio para una de aprobación o rechazo. Un preajuste reemplaza todo el informe, y el selector solo muestra su nombre mientras el informe siga coincidiendo con él.
- En Datos, selecciona Agregar datos, elige qué contar o calcular y luego cómo hacerlo: Conteo o Valores únicos para un campo, Suma o Promedio para Puntuación, y Promedio para Valor booleano. Cada serie lee eventos o respuestas de mediciones según los datos elegidos.
- En Filtros, selecciona Agregar filtro, elige un campo y usa es cualquiera de, no es ninguno de o está vacío. La lista de valores de un filtro ofrece los valores más comunes de todo el historial registrado, no solo del rango seleccionado.
- En Agrupar por, elige un Desglose opcional y usa Luego por para agregar otro. Desglose solo ofrece campos presentes en todas las series del informe.
- Encima del gráfico, elige un Rango de fechas y la granularidad de Tiempo —Día, Semana, Mes, Año o Total— y, en Gráfico, elige cómo representarlo. Luego selecciona Guardar informe.
Cada opción de Datos, Filtros y Desglose indica debajo de su nombre qué contiene, y cada tipo de evento disponible como valor de filtro explica qué significa. El nombre sugerido de un informe refleja lo que muestra y comienza con la medición que sigue, como MQM · Score per week. El título del gráfico usa los nombres asignados por el selector de Datos.
Elige entre Gráfico de líneas, Gráfico de barras, Número, Barras horizontales, Gráfico circular, Mapa de calor, Gráfico de dispersión y Gráfico de puntos según los datos y la agrupación seleccionados. En un gráfico temporal, Arrastrar para ampliar reduce el rango a períodos completos; Restablecer zoom vuelve al rango guardado.
Los rangos de fechas son Últimos 7 días, Últimos 30 días, Últimos 90 días, Últimos 12 meses, que abarca 365 días, y Todo el período, que comienza el primer día con datos. Cada rango termina al final del día de hoy, por lo que incluye hoy aunque aún no haya terminado. Los días, las semanas y los meses se delimitan según la zona horaria de la organización, definida en Configuración → General; las semanas empiezan el lunes. Los eventos y las respuestas se ubican según la hora del evento, no según la hora en que se calculó la respuesta.
Un desglose limita los grupos que se muestran a la vez. Los gráficos temporales muestran los 5 principales más Otros. Un solo desglose sin tiempo muestra los 10 principales más Otros, o comienza con 50 grupos para Barras horizontales, Mapa de calor, Gráfico de puntos y Gráfico de dispersión; Mostrar más agrega otros 50. Un segundo desglose muestra las 100 combinaciones principales. Los registros sin ese campo aparecen como Sin definir. Ordenar ofrece De mayor a menor y De menor a mayor cuando hay un solo desglose sin tiempo.
Para las series de eventos, Filtros y Desglose ofrecen Tipo de evento, Idioma de destino, Idioma de origen, Motor y Proveedor. Las series de mediciones también ofrecen Medición, Tipo de valor, No aplicable, Decidido por y Modelo evaluador. Un informe que incluya series de eventos y de mediciones puede agruparse por los campos que ambas comparten.
Conserva y comparte informes #
Un informe guardado conserva su nombre y definición: series, filtros, agrupación, gráfico y rango de fechas. No almacena datos. Al abrirlo, la consulta se ejecuta de nuevo, por lo que el mismo informe puede mostrar valores distintos más adelante. Todos los miembros de la organización pueden ver sus informes y cambiar el nombre, sobrescribir o eliminar cualquiera de ellos; un informe eliminado no se puede restaurar.
Después de modificar un informe guardado, selecciona Guardar para sobrescribirlo, Guardar como nuevo para conservar el original o Descartar. Descargar CSV exporta la tabla que aparece debajo del gráfico tal como se muestra, incluidos los porcentajes con formato, — para los valores faltantes y el grupo Otros. Los grupos ocultos por el límite del desglose no se incluyen en el archivo.
Explica cómo se calcula la cifra principal #
Promediar porcentajes y combinar observaciones puede dar resultados distintos. Considera este ejemplo: un día hay 1 respuesta aprobada de 1 respuesta y otro día hay 0 aprobadas de 9 respuestas. El promedio de los porcentajes diarios es 50%, pero la población combinada tiene 1 respuesta aprobada de 10: 10%.
Radar usa ambos cálculos en distintos lugares:
| Visualización | Cálculo |
|---|---|
| Panel de puntuación de la descripción general | Para cada día, se combinan las respuestas de ese día. La cifra principal del mes promedia los días que tienen puntuación, sin ponderarlos por la cantidad de respuestas. |
| Variación de la puntuación de la descripción general | El promedio diario del mes hasta hoy menos el de los mismos días del mes anterior, expresado en puntos. |
| Palabras generadas | La suma de palabras del mes, comparada con las mismas fechas del mes anterior, indicadas en la tarjeta, como vs Oct 1 – 2. |
| Gráfico de Número de Explorar | Un valor combinado de todo el rango. La variación se calcula respecto del período de igual duración inmediatamente anterior: puntos para porcentajes, variación relativa para conteos y — cuando el valor anterior no existe o es cero. |
| Puntuación → Promedio de Explorar | El promedio de las respuestas numéricas de 0 a 100 que no son N/A. |
| Valor booleano → Promedio de Explorar | Las respuestas aprobadas divididas entre las respuestas de aprobación o rechazo que no son N/A. Las respuestas en una escala de 0 a 100 no se incluyen en el denominador. |
Para obtener una proporción de la población combinada, consulta un valor combinado —un gráfico de Número de Explorar o el totals de la respuesta de la consulta que aparece más abajo— en lugar de promediar los puntos del gráfico. Los días con valores nulos se excluyen del promedio de la descripción general, y un mes sin respuestas puntuadas muestra — en lugar de cero.
Las poblaciones vacías requieren el mismo cuidado. Un valor nulo, un cero en pantalla y la ausencia de filas observadas pueden representar estados distintos. Los totales de respuestas no permiten identificar traducciones elegibles que nunca se seleccionaron o completaron. Usa Resultados para informar la finalización y la cobertura de respuestas con resultado definido junto con las tasas de aprobación.
Investiga el patrón detrás de la cifra #
Ante una variación en la puntuación, revisa ejemplos de la misma medición y luego compara la combinación de contenidos, los idiomas, el muestreo y las pautas. Un promedio general puede cambiar porque un idioma difícil recibió más trabajo o porque otra medición empezó a generar respuestas. Una clasificación basada en observaciones puede sugerir una comparación controlada de modelos; no demuestra que el modelo haya causado la diferencia.
Para analizar la actividad de edición, consulta la tasa y la distancia de edición en conjunto y verifica la correspondencia entre el borrador y el texto de destino. Menos ediciones pueden reflejar mejores borradores, menos revisión o una política de aceptación distinta. Las respuestas sobre patrones de edición son estructuradas y no se incluyen en las medidas de puntuación o tasa de aprobación. El ahorro de tiempo requiere evidencia independiente.
Para investigar problemas operativos, consulta Ejecuciones y Solicitudes. Distingue entre etapas ausentes, omitidas, fallidas y completadas. Completar la traducción, escribirla en el destino y publicar el resultado son hitos distintos. Los registros individuales ayudan a investigar, pero no proporcionan un historial agregado completo de las transiciones de estado.
Los hallazgos de integridad estructural también requieren una interpretación propia. Compara las claves faltantes, las claves adicionales, los marcadores de posición y el resultado reparado con el contrato esperado. La ausencia de campos de integridad no demuestra que la comprobación haya sido exitosa, y una falla estructural no equivale a una afirmación modificada.
Interpreta las marcas de tiempo de los eventos y de la ingesta según el significado real de los tiempos en el origen. Las aprobaciones de Crowdin conservan la hora de creación de la sugerencia, por lo que la diferencia puede incluir tiempo previo a la aprobación, no solo la demora de recopilación. Eventos explica cómo afecta esto a los filtros de fecha. La duración del evaluador describe otro intervalo. Al calcular conteos o resúmenes de demoras, mantén separados los eventos de cadenas del proveedor y los eventos de solicitudes o de idiomas de trabajos.
Compara el gasto y el tiempo del mismo trabajo #
Indica claramente la unidad de contabilización: solicitud, paso, respuesta de medición o período de la cuenta. Varias respuestas de mediciones pueden corresponder a una sola solicitud de generación, por lo que asignar su costo completo a cada respuesta duplica el gasto. Los totales de tokens representan carga de trabajo, no dinero, y los campos de eventos con cero como valor predeterminado no demuestran que el costo de generación sea cero.
La duración de una solicitud abarca menos que el tiempo total de un trabajo que incluye esperas en cola o de revisión. El costo registrado por respuesta con resultado definido puede describir el rendimiento de la medición, pero no demuestra cuánto esfuerzo humano se ahorró. Costos detalla los límites de contabilización necesarios.
Conserva un análisis recurrente #
Un informe guardado de Explorar conserva la definición de la pregunta, pero no el razonamiento que la acompaña ni los valores que mostró. Guarda esa información junto con el análisis del equipo: la decisión que orienta, la población de origen, la unidad, las medidas, los desgloses, los filtros, el intervalo, la zona horaria, la granularidad temporal, el orden y el tratamiento de los grupos que quedan fuera de los N principales mostrados. Conserva tanto los ID de las mediciones como sus nombres, ya que estos pueden cambiar.
Para cada proporción, identifica el numerador y el denominador. La participación de un idioma usa todos los grupos que quedan después de aplicar los filtros, antes de ocultar los más pequeños. Una tasa de aprobación de calidad usa respuestas con resultado definido bajo un mismo criterio e informa la cobertura por separado. El crecimiento entre períodos se calcula dividiendo la diferencia entre el valor del período anterior y no está definido cuando ese valor anterior es cero.
Conserva el resultado observado o la fecha de consulta junto con la especificación. Un informe guardado o una consulta en vivo puede devolver datos distintos más adelante, por ejemplo, después de que una evaluación histórica reemplace las respuestas de su intervalo. Un CSV descargado registra lo que el informe mostraba en ese momento.
Por último, pon a prueba la medición que sustenta el informe. Validar los hallazgos de calidad examina si las alertas están justificadas; diseño de mediciones examina las falsas alarmas, los errores no detectados y la cobertura. La coincidencia entre dos modelos evaluadores, por sí sola, no demuestra que el resultado sea correcto.
Consulta valores combinados de los informes #
Envía JSON con Content-Type: application/json a https://api.lingo.dev y autentícate con un X-API-Key del lado del servidor para la organización correspondiente o con una credencial de portador aceptada. Estas operaciones requieren pertenecer a la organización y tener el derecho de informes; no exigen el rol de Propietario para la sola consulta de análisis. Reemplaza :orgId por el ID de la organización y mantén las credenciales fuera del código del cliente y de las especificaciones de informes guardados.
| Ruta POST | Medidas para solicitar y leer de totals |
|---|---|
/v2/organizations/:orgId/analytics/measurement-scores | averageScore, reviews, scored |
Para obtener una puntuación de todo el período, usa este cuerpo con la operación de puntuaciones de mediciones y reemplaza el intervalo de ejemplo:
{
"measures": ["averageScore", "reviews", "scored"],
"time": {
"axis": "createdAt",
"from": "2026-10-01T00:00:00.000Z",
"to": "2026-11-01T00:00:00.000Z"
}
}Lee totals.averageScore junto con totals.reviews y totals.scored. averageScore usa una escala de 0 a 1; reviews cuenta todas las respuestas, incluidas las N/A, y scored cuenta las que tienen un resultado definido. Al omitir dimensiones, se solicita la población combinada; las respuestas agrupadas también calculan totales combinados independientemente de sus filas. El eje createdAt corresponde a la hora del evento.
Los filtros admitidos reducen la población: por ejemplo, filters: {"reviewerId":"…"} selecciona una medición por su ID, y engineId, sourceLocale y targetLocale seleccionan motores e idiomas. Usa ID reales de las lecturas de mediciones. Estas operaciones usan consultas declaradas, no SQL arbitrario. El servidor proporciona la zona horaria de la organización y rechaza un timezone enviado por quien realiza la llamada; conserva esa zona horaria junto con los límites explícitos del intervalo. Una consulta ejecutada más adelante puede devolver datos distintos, así que guarda los totales observados y la fecha de consulta junto con el cálculo.
Las series de Explorar usan /analytics/events y /analytics/measurement-answers con la misma estructura de solicitud sobre un eje eventAt; devuelven filas sin totals. Los informes guardados están disponibles en GET y POST /v2/organizations/:orgId/reports, así como en GET, PATCH y DELETE /v2/reports/:id.