Reporty
V přehledu Radaru a uložených reportech z části Prozkoumat odhalte vzorce v událostech a odpovědích měření a uchovejte si výpočet, na kterém stojí opakovaná analýza.
Reporty pomáhají přejít od jednotlivých překladů k opakujícím se vzorcům. Tým díky nim zjistí, na které jazyky připadá nejvíce zaznamenané práce, u kterého měření se změnily odpovědi nebo kde opakovaně selhává pravidlo. Další postup závisí na tom, co report počítá: více událostí, méně vyhovujících odpovědí a více tokenů vypovídají o různých situacích.
Radar nabízí dvě obrazovky s reporty. Radar → Přehled shrnuje aktuální měsíc: průměrné skóre, počet vygenerovaných slov, dnešní události a hodnoty, které pro ně měření vypočítala. Radar → Prozkoumat zobrazuje v grafech události a odpovědi typu vyhovuje/nevyhovuje nebo odpovědi s číselným skóre a ukládá tyto grafy jako reporty organizace. Jednotlivou odpověď otevřete ve Výsledcích, kde si můžete prohlédnout její text a vysvětlení. Klasifikace vzorců úprav nejsou součástí těchto reportů ani seznamů výsledků; změny vyhledejte pomocí míry úprav a editační vzdálenosti a poté si přečtěte porovnávaný text.
Když v přehledu najedete kurzorem na název dlaždice, uvidíte, co počítá. Dlaždice se skóre, slovy a událostmi i dlaždice Dnešní měření v přehledu vyžadují stejně jako část Prozkoumat oprávnění k reportům. To vyžaduje plán Enterprise; bez něj se zobrazuje zpráva, že váš plán reporty nezahrnuje.
Vyberte report podle otázky #
| Otázka | Kde hledat |
|---|---|
| Kolik toho Lingo.dev tento měsíc vygenerovalo? | Vygenerovaná slova v přehledu; viz Objem překladů. |
| Jaký objem aktivity připadal na jednotlivé jazyky, engine nebo poskytovatele? | Události v části Prozkoumat; viz Objem překladů. |
| Kde commity v repozitáři změnily lokalizovaný obsah? | Události GitHub v části Radar → Protokoly; viz Změny v repozitáři. |
| Jak se během měsíce měnily odpovědi měření? | Panel skóre v přehledu; viz Výsledky hodnocení. |
| Jaké odpovědi poskytlo konkrétní měření v rozdělení podle jazyka nebo engine? | Report Měření v části Prozkoumat; viz Výsledky hodnocení. |
| Jak důsledně byla dodržována pravidla nebo terminologie? | Report Skóre pro dodržování pravidel nebo glosáře s jednotlivými vysvětleními ve Výsledcích; viz Výsledky hodnocení. |
Datové řady tokenů a nákladů na modely za zúčtovací období účtu najdete v části Nastavení → Spotřeba, nikoli v Radaru. Podrobnosti uvádí část Spotřeba.
Vytvořte report v části Prozkoumat #
- Otevřete Radar → Prozkoumat. Vyberte Nový report, nebo otevřete Příklady a zvolte report vytvořený z vašich dat, který chcete upravit.
- Chcete-li sledovat jedno číselné měření nebo měření typu vyhovuje/nevyhovuje, vyberte ho v části Předvolba. Report pak zobrazí odpovědi tohoto měření po týdnech za posledních 90 dní: Skóre s agregací Průměr pro měření na škále 0 až 100 nebo Logická hodnota s agregací Průměr pro měření typu vyhovuje/nevyhovuje. Předvolba nahradí celý report a její název se ve výběru zobrazuje jen do chvíle, kdy jí report přestane odpovídat.
- V části Data vyberte Přidat data a zvolte, co chcete počítat nebo vypočítat a jakým způsobem: Počet nebo Unikátní pro pole, Součet nebo Průměr pro Skóre a Průměr pro Logickou hodnotu. Každá řada podle zvolených dat načítá buď události, nebo odpovědi měření.
- V části Filtry vyberte Přidat filtr, zvolte pole a použijte je jedna z hodnot, není žádná z hodnot nebo je prázdné. Seznam hodnot filtru nabízí nejčastější hodnoty z celé zaznamenané historie, nejen z vybraného období.
- V části Seskupit podle zvolte nepovinné Rozdělení a pomocí Dále podle případně přidejte druhé. Rozdělení nabízí pouze pole společná všem řadám v reportu.
- Nad grafem zvolte Časové období a v nabídce Čas vyberte časovou jednotku — Den, Týden, Měsíc, Rok nebo Celkem. V části Graf zvolte způsob zobrazení. Poté vyberte Uložit report.
Každá možnost v částech Data, Filtry a Rozdělení má pod názvem popis svého obsahu. Každý typ události nabízený jako hodnota filtru má také vysvětlení svého významu. Navržený název reportu vychází z toho, co report zobrazuje, a začíná názvem sledovaného měření, například MQM · Score per week. Název grafu používá názvy z nabídky Data.
Podle vybraných dat a seskupení zvolte spojnicový graf, sloupcový graf, číslo, vodorovné sloupce, výsečový graf, teplotní mapu, bodový graf nebo tečkový graf. V časovém grafu možnost Přiblížit tažením zúží rozsah na celá období; Obnovit přiblížení vás vrátí k uloženému rozsahu.
Na výběr jsou období Posledních 7 dní, Posledních 30 dní, Posledních 90 dní, Posledních 12 měsíců, které zahrnuje 365 dní, a Celé období, které začíná prvním dnem s daty. Každé období končí na konci dnešního dne, takže zahrnuje i dnešek, přestože ještě probíhá. Hranice dnů, týdnů a měsíců se řídí časovým pásmem organizace nastaveným v části Nastavení → Obecné; týdny začínají v pondělí. Události a odpovědi se zařazují podle času události, nikoli podle času výpočtu odpovědi.
Rozdělení omezuje počet skupin zobrazených najednou. Časové grafy zobrazují prvních 5 a skupinu Ostatní. Při jednom rozdělení bez časové osy se zobrazuje prvních 10 a skupina Ostatní; vodorovné sloupce, teplotní mapa, tečkový graf a bodový graf začínají s 50 skupinami. Možnost Zobrazit více přidá dalších 50. Druhé rozdělení omezuje zobrazení na prvních 100 kombinací. Záznamy bez daného pole se zobrazují jako Nenastaveno. Nabídka Řazení umožňuje při jednom rozdělení bez časové osy zvolit Od nejvyššího nebo Od nejnižšího.
U řad událostí nabízejí Filtry a Rozdělení pole Typ události, Cílový jazyk, Zdrojový jazyk, Engine a Poskytovatel. Řady měření navíc nabízejí Měření, Druh hodnoty, Nelze použít, Rozhodl a Hodnoticí model. Report obsahující řady událostí i měření lze seskupit podle jejich společných polí.
Ukládejte a sdílejte reporty #
Uložený report uchovává svůj název a definici: řady, filtry, seskupení, graf a časové období. Samotná data neukládá. Při otevření se dotaz spustí znovu, takže stejný report může později zobrazit jiné hodnoty. Každý člen organizace vidí všechny její reporty a může kterýkoli z nich přejmenovat, přepsat nebo smazat. Smazaný report nelze obnovit.
Po změně uloženého reportu vyberte Uložit, chcete-li ho přepsat, Uložit jako nový, chcete-li zachovat původní, nebo Zahodit. Možnost Stáhnout CSV exportuje tabulku pod grafem přesně tak, jak se zobrazuje, včetně formátovaných procent, znaku — pro chybějící hodnoty a skupiny Ostatní. Skupiny skryté limitem rozdělení soubor neobsahuje.
Vysvětlete výpočet hlavního údaje #
Průměrování procent a sloučení pozorování mohou vést k různým výsledkům. Představte si den s 1 vyhovující odpovědí z 1 a další den s 0 vyhovujícími odpověďmi z 9. Průměr denních procent je 50 %, ale ve sloučeném souboru je 1 vyhovující odpověď z 10: 10 %.
Radar používá na různých místech oba výpočty:
| Zobrazení | Výpočet |
|---|---|
| Panel skóre v přehledu | Pro každý den se sloučí odpovědi z daného dne. Hlavní měsíční údaj je průměrem skóre za dny, které ho mají, bez vážení podle počtu odpovědí. |
| Změna skóre v přehledu | Průměr denních hodnot od začátku měsíce do dneška minus průměr za stejné dny předchozího měsíce, vyjádřený v bodech. |
| Vygenerovaná slova | Součet slov za měsíc ve srovnání se stejnými daty předchozího měsíce uvedenými na dlaždici, například vs Oct 1 – 2. |
| Graf Číslo v části Prozkoumat | Jedna hodnota vypočtená ze sloučených dat za celé období. Její změna se vztahuje k bezprostředně předcházejícímu období stejné délky: u procent se uvádí v bodech, u počtů jako relativní změna. Pokud předchozí hodnota chybí nebo je nulová, zobrazuje se —. |
| Skóre → Průměr v části Prozkoumat | Průměr číselných odpovědí na škále 0–100, které nejsou N/A. |
| Logická hodnota → Průměr v části Prozkoumat | Počet vyhovujících odpovědí dělený počtem odpovědí typu vyhovuje/nevyhovuje, které nejsou N/A. Odpovědi na škále 0–100 se do jmenovatele nezahrnují. |
Pro poměr za celý sloučený soubor použijte hodnotu vypočtenou ze sloučených dat — graf Číslo v části Prozkoumat nebo totals v odpovědi na dotaz níže — místo průměrování bodů grafu. Dny s hodnotou null se do průměru v přehledu nezahrnují a u měsíce bez jediné odpovědi se skóre se zobrazuje — místo nuly.
Stejnou pozornost vyžadují i prázdné datové soubory. Hodnota null, zobrazená nula a absence zaznamenaných řádků mohou představovat různé stavy. Ze souhrnných počtů odpovědí nelze určit způsobilé překlady, které nikdy nebyly vybrány nebo dokončeny. Pomocí Výsledků uvádějte vedle míry úspěšnosti také dokončení a pokrytí jednoznačnými odpověďmi.
Prozkoumejte vzorce, které stojí za čísly #
Při změně skóre si prohlédněte příklady ze stejného měření a poté porovnejte skladbu obsahu, jazyky, výběr vzorků a pokyny. Celkový průměr se může posunout proto, že na náročný jazyk připadlo více práce nebo že začalo poskytovat odpovědi další měření. Pořadí založené na pozorování může být podnětem ke kontrolovanému porovnání modelů; nedokazuje však, že rozdíl způsobil model.
Při sledování úprav posuzujte míru úprav a editační vzdálenost společně a ověřte spárování návrhu s cílovým textem. Méně úprav může znamenat lepší návrhy, méně kontroly nebo jiná pravidla přijímání. Odpovědi týkající se vzorců úprav jsou strukturované a nezahrnují se do ukazatelů skóre ani míry úspěšnosti. Úsporu času je třeba doložit samostatně.
Při provozních problémech sledujte Spuštění a Požadavky. Rozlišujte chybějící, přeskočené, neúspěšné a dokončené fáze. Dokončení překladu, zápis zpět do cílového systému a publikovaný výstup jsou různé milníky. Jednotlivé záznamy pomáhají při zkoumání problémů, ale neposkytují úplnou souhrnnou historii přechodů mezi stavy.
Samostatně je třeba interpretovat i zjištění o strukturální integritě. Porovnejte chybějící klíče, nadbytečné klíče, zástupné symboly a opravený výstup s očekávanou specifikací. Chybějící pole integrity nedokládají úspěšnou kontrolu a strukturální chyba není totéž co změna tvrzení.
Časová razítka událostí a příjmu dat interpretujte podle toho, co skutečně znamenají ve zdroji. Schválení v Crowdin zachovávají čas vytvoření návrhu, takže rozdíl může zahrnovat i dobu před schválením, nejen zpoždění sběru dat. Důsledky pro filtrování podle data vysvětluje část Události. Doba běhu hodnoticího modelu popisuje jiný interval. Při výpočtu počtů nebo souhrnných údajů o zpoždění oddělujte události řetězců poskytovatele od událostí požadavků nebo událostí pro jednotlivé jazyky úloh.
Porovnávejte náklady a čas u stejné práce #
Vždy jasně uveďte jednotku účtování: požadavek, krok, odpověď měření nebo zúčtovací období účtu. K jednomu požadavku na generování se může vztahovat několik odpovědí měření. Pokud ke každé přiřadíte plné náklady požadavku, započítáte stejné výdaje vícekrát. Celkové počty tokenů vyjadřují objem práce, nikoli peníze, a pole událostí s výchozí nulovou hodnotou nedokazují nulové náklady na generování.
Doba trvání požadavku zachycuje užší interval než celková doba úlohy včetně čekání ve frontě nebo na kontrolu. Zaznamenané náklady na jednu jednoznačnou odpověď mohou popsat výtěžnost měření, ale nemohou prokázat úsporu lidské práce. Potřebné hranice pro účtování nákladů uvádí část Náklady.
Uchovejte opakovanou analýzu #
Uložený report v části Prozkoumat uchovává definici otázky, nikoli však související úvahy ani hodnoty, které zobrazoval. Ty si uchovejte spolu s týmovou analýzou: rozhodnutí, které analýza podporuje, zdrojový datový soubor, jednotku, ukazatele, rozdělení, filtry, interval, časové pásmo, časovou jednotku, řazení a způsob zacházení se skupinami mimo zobrazených prvních N. Uchovávejte ID měření i jejich názvy, protože názvy se mohou měnit.
U každého poměru pojmenujte čitatele a jmenovatele. Podíl jazyka se počítá ze všech skupin, které zůstaly po filtrování, ještě před skrytím menších skupin. Míra úspěšnosti při hodnocení kvality vychází z jednoznačných odpovědí podle jednoho kritéria a pokrytí uvádí samostatně. Růst mezi obdobími se počítá jako rozdíl dělený hodnotou předchozího období; pokud je předchozí hodnota nulová, není definován.
Spolu se specifikací uchovávejte zjištěný výsledek nebo datum načtení. Uložený report nebo živý dotaz může později vrátit jiná data, například poté, co historické hodnocení nahradí odpovědi ve svém intervalu. Stažený soubor CSV zachycuje to, co report zobrazoval v daný okamžik.
Nakonec otestujte měření, ze kterého report vychází. Část Ověřte zjištění o kvalitě zkoumá, zda jsou označené problémy oprávněné; část Návrh měření se zabývá falešnými poplachy, přehlédnutými chybami a pokrytím. Samotná shoda dvou hodnoticích modelů správnost neprokazuje.
Získejte dotazem hodnoty reportu ze sloučených dat #
Odešlete JSON s Content-Type: application/json na https://api.lingo.dev a k ověření použijte serverový X-API-Key pro příslušnou organizaci nebo přijímaný přihlašovací údaj typu bearer. Tyto operace vyžadují členství v organizaci a oprávnění k reportům; pro samotné čtení analytických dat není nutná role Vlastník. Nahraďte :orgId ID organizace a přihlašovací údaje neukládejte do klientského kódu ani do uložených specifikací reportů.
| Cesta POST | Ukazatele k vyžádání a načtení z totals |
|---|---|
/v2/organizations/:orgId/analytics/measurement-scores | averageScore, reviews, scored |
Chcete-li získat skóre za celé období, použijte toto tělo požadavku s operací measurement-scores a nahraďte ukázkový interval:
{
"measures": ["averageScore", "reviews", "scored"],
"time": {
"axis": "createdAt",
"from": "2026-10-01T00:00:00.000Z",
"to": "2026-11-01T00:00:00.000Z"
}
}Hodnotu totals.averageScore čtěte společně s totals.reviews a totals.scored. averageScore je na škále 0–1; reviews počítá všechny odpovědi včetně N/A a scored počítá odpovědi s jednoznačným výsledkem. Pokud dimenze vynecháte, dotaz se vztahuje na celý sloučený soubor. Seskupené odpovědi také počítají souhrnné hodnoty ze sloučených dat nezávisle na svých řádcích. Osa createdAt představuje čas události.
Podporované filtry zužují datový soubor: například filters: {"reviewerId":"…"} vybírá jedno měření podle jeho ID a engineId, sourceLocale a targetLocale vybírají engine a jazyky. Použijte skutečná ID z operací pro čtení měření. Jde o operace s předem definovanými dotazy, nikoli o libovolné SQL. Server doplňuje časové pásmo organizace a odmítá timezone zadané volajícím; toto časové pásmo si uchovejte spolu s výslovně uvedenými hranicemi intervalu. Později spuštěný dotaz může vrátit jiná data, proto spolu s výpočtem uložte zjištěné souhrnné hodnoty a datum načtení.
Vlastní řady v části Prozkoumat používají /analytics/events a /analytics/measurement-answers se stejnou strukturou požadavku na ose eventAt; vracejí řádky bez totals. Uložené reporty jsou dostupné na GET a POST /v2/organizations/:orgId/reports a dále na GET, PATCH a DELETE /v2/reports/:id.