レポート
レーダーの概要と保存済みの探索レポートで、イベントや測定結果の傾向を把握し、定期的な分析に使う計算方法を残せます。
レポートを使えば、個々の翻訳だけでなく、全体の傾向も把握できます。記録された作業の大半を占める言語、結果が変化した測定、同じルールへの違反が続いている箇所などを、チームで確認できます。次に取るべき行動は、レポートが何を数えているかによって変わります。イベントの増加、合格した結果の減少、トークン数の増加は、それぞれ異なる状況を示します。
レーダーには、二つのレポート画面があります。レーダー → 概要では、今月の平均スコア、生成単語数、今日のイベント、今日のイベントに対して測定が算出した値を確認できます。レーダー → 探索では、イベントと、合否または数値スコアで示される測定結果をグラフ化し、組織のレポートとして保存できます。個々の結果のテキストと説明を確認するには、結果で対象を開きます。編集パターンの分類は、これらのレポートや結果一覧には含まれません。編集率と編集距離で変更箇所を見つけてから、比較対象のテキストを確認してください。
概要のタイル名にカーソルを合わせると、集計対象を確認できます。概要のスコア、単語数、イベント、今日の測定の各タイルと探索を利用するには、Enterpriseプランでのみ利用できるレポート利用権が必要です。利用権がない場合は、現在のプランではレポートを利用できない旨が表示されます。
知りたいことに合わせてレポートを選ぶ #
| 知りたいこと | 確認する場所 |
|---|---|
| 今月、Lingo.devはどれだけ生成しましたか? | 概要の生成単語数。詳しくは翻訳の作業量を参照してください。 |
| 言語別、エンジン別、プロバイダー別に、どれだけの処理がありましたか? | 探索のイベント。詳しくは翻訳の作業量を参照してください。 |
| リポジトリへのコミットで、ローカライズ済みコンテンツのどこが変わりましたか? | レーダー → ログのGitHubイベント。詳しくはリポジトリの変更を参照してください。 |
| 測定結果は月内でどのように変化しましたか? | 概要のスコアパネル。詳しくは評価結果を参照してください。 |
| ある測定では、言語別やエンジン別にどのような結果が出ましたか? | 探索の測定レポート。詳しくは評価結果を参照してください。 |
| ルールや用語は、どの程度一貫して守られていましたか? | ルール遵守または用語集遵守のスコアレポート。個別の説明は結果で確認できます。詳しくは評価結果を参照してください。 |
アカウントの対象期間におけるトークン数とモデル費用のデータ系列は、レーダーではなく、設定 → 使用量で確認できます。詳しくは使用量を参照してください。
探索でレポートを作成する #
- レーダー → 探索を開きます。新しいレポートを選択するか、サンプルを開いて、自分のデータをもとにしたレポートを選び、調整します。
- 数値または合否を返す一つの測定を追跡するには、プリセットから対象を選びます。レポートには、過去90日間のその測定の結果が週単位で表示されます。0〜100の測定にはスコアの平均、合否の測定には真偽値の平均が使われます。プリセットを選ぶとレポート全体が置き換わります。選択欄にプリセット名が表示されるのは、レポートがその内容と一致している間だけです。
- データでデータを追加を選び、集計や計算の対象と方法を指定します。フィールドには件数または一意の件数、スコアには合計または平均、真偽値には平均を使います。各系列は、選択したデータに応じて、イベントまたは測定結果を読み取ります。
- フィルターでフィルターを追加を選び、フィールドを選択して、次のいずれかに一致、次のいずれにも一致しない、空であるのいずれかを指定します。フィルターの値の一覧には、選択期間内だけでなく、記録された全履歴で出現頻度の高い値が表示されます。
- グループ化で、必要に応じて内訳を選びます。二つ目の内訳を指定するには、次の項目でさらに分類を使います。内訳で選べるのは、レポート内のすべての系列に共通するフィールドだけです。
- グラフの上で日付範囲と時間の集計単位を選びます。単位は日、週、月、年、全期間から選べます。グラフで表示方法を選び、レポートを保存を選択します。
データ、フィルター、内訳の各選択肢には、名前の下に内容の説明が表示されます。フィルター値として選べるイベントの種類にも、それぞれの意味が表示されます。レポート名の候補は表示内容に応じて決まり、MQM · Score per weekのように追跡対象の測定名で始まります。グラフのタイトルには、データ選択欄で使われている名前が反映されます。
選択したデータとグループ化に合わせて、折れ線グラフ、棒グラフ、数値、横棒グラフ、円グラフ、ヒートマップ、散布図、ドットプロットから選べます。時系列グラフでは、ドラッグして拡大で、集計期間を区切りとして表示範囲を絞り込めます。拡大をリセットを選ぶと、保存済みの範囲に戻ります。
日付範囲は、過去7日間、過去30日間、過去90日間、365日間を対象とする過去12か月間、データがある最初の日からの全期間です。どの範囲も今日の終わりまでが対象になるため、まだ終了していない今日も含まれます。日、週、月の区切りには、設定 → 一般で指定した組織のタイムゾーンが使われます。週の始まりは月曜日です。イベントと測定結果は、結果を算出した時刻ではなく、イベントの時刻に基づいて配置されます。
内訳では、一度に表示するグループ数に上限があります。時系列グラフでは、上位5グループとその他が表示されます。時間軸のない単一の内訳では、上位10グループとその他が表示されます。ただし、横棒グラフ、ヒートマップ、ドットプロット、散布図では、最初に50グループが表示され、さらに表示で50グループずつ追加されます。二つ目の内訳を指定すると、上位100通りの組み合わせが表示されます。対象フィールドのないレコードは未設定と表示されます。時間軸のない単一の内訳では、並べ替えで高い順または低い順を選べます。
イベント系列では、フィルターと内訳でイベントの種類、翻訳先ロケール、翻訳元ロケール、エンジン、プロバイダーを選べます。測定系列では、さらに測定、値の種類、該当なし、判定元、判定モデルも選べます。イベント系列と測定系列の両方を含むレポートでは、共通するフィールドでグループ化できます。
レポートを保存して共有する #
保存済みレポートには、名前と定義が保存されます。定義には、系列、フィルター、グループ化、グラフ、日付範囲が含まれます。データ自体は保存されません。開くたびにクエリが再実行されるため、同じレポートでも後で異なる値が表示されることがあります。組織のすべてのメンバーが組織のレポートを閲覧でき、どのレポートでも名前の変更、上書き、削除ができます。削除したレポートは復元できません。
保存済みレポートを変更したら、保存で上書きするか、新規として保存で元のレポートを残すか、破棄を選びます。CSVをダウンロードでは、グラフの下の表が表示どおりに出力されます。書式設定済みの割合、欠損値を示す**—**、その他グループも含まれます。内訳の表示上限によって非表示になっているグループは、ファイルに含まれません。
代表値の計算方法を理解する #
割合を平均する方法と、観測結果をまとめて計算する方法では、結果が異なることがあります。たとえば、ある日は1件の結果のうち1件が合格し、別の日は9件の結果のうち合格が0件だったとします。日ごとの合格率の平均は50%ですが、母集団全体では10件中1件の合格なので、10%になります。
レーダーでは、表示箇所によってこの二つの計算方法を使い分けています。
| 表示 | 計算方法 |
|---|---|
| 概要のスコアパネル | 日ごとに、その日の結果をまとめて集計します。月の代表値は、スコアのある日の値を平均したもので、結果の件数による重み付けは行いません。 |
| 概要のスコア変化 | 今月の今日までの日次平均から、前月の同じ日付範囲の日次平均を引き、ポイントで示します。 |
| 生成単語数 | 今月の単語数を合計し、前月の同じ日付範囲と比較します。比較対象は、vs Oct 1 – 2のようにタイルに表示されます。 |
| 探索の数値グラフ | 期間全体をまとめて集計した一つの値です。変化量は、直前の同じ長さの期間と比較します。割合はポイント、件数は相対変化で示し、前の値がない場合やゼロの場合は**—**を表示します。 |
| 探索のスコア → 平均 | 該当なしを除く、0〜100の数値結果の平均です。 |
| 探索の真偽値 → 平均 | 合格した結果の件数を、該当なしを除いた合否結果の件数で割ります。0〜100の尺度による結果は、分母に含まれません。 |
母集団全体の比率を確認するには、グラフ上の各点を平均するのではなく、探索の数値グラフや後述するクエリ応答のtotalsなど、全体をまとめて集計した値を使ってください。値がない日は概要の平均から除外されます。スコアのある結果が一件もない月は、ゼロではなく**—**と表示されます。
母集団が空の場合も、同様の注意が必要です。ヌル値、表示上のゼロ、観測された行がない状態は、それぞれ異なる意味を持つ場合があります。結果の総数だけでは、対象でありながら一度も選択されなかった翻訳や、完了しなかった翻訳を特定できません。結果を使い、合格率と併せて、完了状況と確定的な判定が得られた範囲を報告してください。
数値の背後にある傾向を調べる #
スコアが変化した場合は、同じ測定の例を確認し、コンテンツの構成、言語、サンプリング、指針を比較します。難しい言語の作業が増えたり、別の測定が結果を返し始めたりするだけでも、全体平均は変化します。観測に基づく順位は、条件を統制したモデル比較のきっかけにはなりますが、その差をモデルが引き起こしたと証明するものではありません。
編集状況については、編集率と編集距離を併せて確認し、下書きと翻訳先テキストの組み合わせが正しいことを確かめてください。編集が少ないのは、下書きの品質が高いためかもしれませんが、レビューが少ないため、あるいは採用方針が異なるためかもしれません。編集パターンの結果は構造化されたもので、スコアや合格率の指標には含まれません。時間の削減を示すには、別の根拠が必要です。
運用上の問題については、実行とリクエストを追跡します。段階が存在しない場合、スキップされた場合、失敗した場合、完了した場合を区別してください。翻訳の完了、送信先への書き戻し、出力の公開は、それぞれ異なる到達点です。個々のレコードは調査に役立ちますが、状態遷移を集約した完全な履歴を提供するものではありません。
構造的整合性の検出結果も、個別に解釈する必要があります。欠落したキー、余分なキー、プレースホルダー、修復済みの出力を、想定される仕様と照らし合わせてください。整合性フィールドがないことは、検査の成功を意味しません。また、構造上の不備と、主張内容の変化は別の問題です。
イベントと取り込みのタイムスタンプは、ソースで実際に使われている時刻の意味に沿って解釈してください。Crowdinの承認では提案の作成時刻が保持されるため、時刻の差には収集の遅延だけでなく、承認前の時間も含まれる場合があります。日付フィルターへの影響は、イベントで説明しています。判定所要時間が表すのは、また別の区間です。件数や遅延を集計する際は、プロバイダーの文字列単位のイベントを、リクエスト単位やジョブ内ロケール単位のイベントと区別してください。
同じ作業の費用と時間を比較する #
集計単位が、リクエスト、ステップ、測定結果、アカウントの対象期間のどれなのかを明示してください。一つの生成リクエストに複数の測定結果が対応する場合があるため、その費用全額を各結果に割り当てると、費用が重複計上されます。トークンの合計が表すのは作業量であり、金額ではありません。また、イベントフィールドの既定値がゼロでも、生成費用がゼロだった証拠にはなりません。
リクエストの所要時間は、キューやレビューの待ち時間を含むジョブ全体の経過時間よりも狭い範囲を表します。確定的な判定が得られた結果一件あたりの記録費用は、測定でどれだけ判定を得られたかを示す指標にはなりますが、人の作業をどれだけ削減できたかを証明するものではありません。必要な費用集計の範囲は、費用で説明しています。
繰り返し行う分析を残す #
保存済みの探索レポートには、問いの定義は残りますが、その前提となる考え方や、表示されていた値は残りません。それらはチームの分析と一緒に記録してください。分析をどの判断に使うのか、対象母集団、単位、指標、内訳、フィルター、期間、タイムゾーン、時間の集計単位、並び順、上位の表示件数から外れたグループの扱いなどです。名前は変更されることがあるため、測定名だけでなく測定識別子も残してください。
すべての比率について、分子と分母を明示してください。ロケールの構成比には、小さなグループを非表示にする前の、フィルター後に残った全グループを使います。品質の合格率には、一つの基準で確定的な判定が得られた結果を使い、判定対象をどれだけ網羅しているかは別に報告します。期間の成長率は、差分を前の期間の値で割って求めます。前の値がゼロの場合は定義できません。
分析の仕様と一緒に、観測した結果または取得日を残してください。保存済みレポートやライブクエリは、後で異なるデータを返す場合があります。たとえば、過去データの評価によって対象期間の結果が置き換わった場合です。ダウンロードしたCSVには、その時点でレポートに表示されていた内容が記録されます。
最後に、レポートの基礎となる測定を検証してください。品質に関する検出結果の検証では、指摘が妥当かどうかを確認します。測定の設計では、誤検出、エラーの見逃し、網羅性を確認します。二つの判定モデルが一致しているだけでは、正しさを証明できません。
レポートの全体集計値を取得する #
対象組織のサーバー側のX-API-Key、または有効なベアラー認証情報で認証し、Content-Type: application/jsonを使ってJSONをhttps://api.lingo.devに送信します。これらの操作には、組織のメンバーであることと、レポート利用権が必要です。分析の閲覧だけであれば、オーナーである必要はありません。:orgIdを組織の識別子に置き換え、認証情報をクライアントコードや保存するレポート仕様に含めないでください。
| POSTパス | totalsでリクエストし、読み取る指標 |
|---|---|
/v2/organizations/:orgId/analytics/measurement-scores | averageScore, reviews, scored |
期間全体のスコアを取得するには、測定スコア取得操作で次のリクエスト本文を使い、例示されている期間を置き換えてください。
{
"measures": ["averageScore", "reviews", "scored"],
"time": {
"axis": "createdAt",
"from": "2026-10-01T00:00:00.000Z",
"to": "2026-11-01T00:00:00.000Z"
}
}totals.averageScoreをtotals.reviewsおよびtotals.scoredと併せて読み取ります。averageScoreは0〜1の尺度です。reviewsは該当なしを含むすべての結果を数え、scoredは確定的な判定が得られた結果を数えます。集計軸を省略すると、母集団全体が対象になります。グループ化された応答でも、各行とは独立して全体の集計値が計算されます。createdAt軸には、イベントの時刻が使われます。
対応するフィルターで母集団を絞り込めます。たとえば、filters: {"reviewerId":"…"}では識別子で一つの測定を選び、engineId、sourceLocale、targetLocaleではエンジンと言語を選びます。測定の取得で得られる実際の識別子を使ってください。これらは定義済みクエリの操作であり、任意のSQLではありません。組織のタイムゾーンはサーバーが指定し、呼び出し側が指定したtimezoneは拒否されます。このタイムゾーンを、明示的な期間の開始・終了境界と一緒に記録してください。後でクエリを実行すると異なるデータが返る場合があるため、観測した集計値と取得日を計算方法と一緒に保存してください。
探索自体の系列では、同じリクエスト形式で/analytics/eventsと/analytics/measurement-answersを使い、eventAt軸で集計します。これらはtotalsを含まない行を返します。保存済みレポートは、GET、POST /v2/organizations/:orgId/reports、GET、PATCH、DELETE /v2/reports/:idで利用できます。