テストメタデータの報告

TeamCity でのテスト実行には、テストステータス、実行時間、出力を補完する追加情報(メタデータ)を関連付けることができます。この情報は、追加のログ、スクリーンショット、数値、タグなどを提供するために使用できます。

サービスメッセージを使用して、この種の追加テストデータを TeamCity に報告し、その後 TeamCity UI で表示できます。

追加テストデータの報告

追加のテストデータは、 テストメタデータ サービスメッセージを使用して、次の属性とともに報告されます。

お名前 （オプション）は、同じテストの異なるメタデータアイテムを区別し、UI でこのアイテムを表示するために使用されるメタデータアイテムの名前です。省略すると、TeamCity はお名前を自動生成しますが、UI には表示しません。
テスト名 (オプション) は、このメタデータが生成されるテストの名前です。サービスメッセージがテストの途中または終了直後に報告される場合は、 テスト名 属性をスキップできます。メタデータが後で報告される場合は、次のフォーマットで suite とパッケージを含む完全なテスト名が含まれている必要があります: <スイート名>: <パッケージ名>.<テスト名> (テスト名の解釈について続きを読む)。
値 （必須）には、テストに関連付けられたメタデータ値が含まれています。最大値の長さは 1024 です。
タイプ （オプション）は、特に指定がない限り、デフォルトでテキストになります。タイプは、メタデータの保存方法と、その値が TeamCity UI に表示される方法に影響します。

サービスメッセージの形式が正しくない場合、それに対応するメモがビルドログに書き込まれます。

TeamCity で認識できるデータの種類は次のとおりです：

数値

TeamCity は、指定されたテストの数値を示すグラフを描画します。後続の各ビルド実行では、グラフに新しいドットが追加されます。 Y 軸は、「type」パラメーター値に応じてフォーマットされます: 番号、 ms (ミリ秒)、 バイト 、または パーセント

##teamcity[testMetadata testName='package.Test.testName' name='setUp time' type='ms' value='434.5']
##teamcity[testMetadata testName='package.Test2.testName' name='Success rate' type='percent' value='91.2']
##teamcity[testMetadata testName='package.Test3.testName' name='Total amount' type='number' value='54']
##teamcity[testMetadata testName='package.Test4.testName' name='Package size' type='bytes' value='1048576']

   

文字列/テキスト

##teamcity[testMetadata testName='package.Test.testName' name='some key' value='a text'] 

   

外部リンク

 ##teamcity[testMetadata testName='test.name' name='JetBrains' type='link' value='https://jetbrains.com']

   

ビルドアーティファクトへのリンク

 ##teamcity[testMetadata testName='test.name' type='artifact' value='path/to/catalina.out']

   

アーティファクトへのパスは、ビルドアーティファクトディレクトリからの相対パスである必要があり、アーカイブ内のファイルを参照できます。

 ##teamcity[testMetadata testName='test.name' type='artifact' value='logs.zip!/testTyping/full-log.txt']

   

アーティファクトへのリンクを表示する場合、TeamCity は お名前 属性と参照先アーティファクトのファイル名の両方を表示します。名前が自動生成された場合、表示されません。

アーティファクトディレクトリの画像

##teamcity[testMetadata testName='test.name' type='image' value='path/to/screenshot.png']

   

イメージへのパスは、ビルドアーティファクトディレクトリへの相対パスである必要があります。画像を表示する場合、TeamCity は お名前 属性と参照先画像のファイル名の両方を表示します。

アーティファクトディレクトリのビデオ

##teamcity[testMetadata testName='test.name' type='video' value='path/to/screen-capture.mp4']

   

ビデオフラグメントへのパスは、ビルドアーティファクトディレクトリへの相対パスである必要があります。ビデオフラグメントを表示する場合、TeamCity は お名前 属性と参照先ビデオのファイル名の両方を表示します。

追加テストデータの表示

TeamCity ウェブ UI のさまざまな場所で追加テストデータを表示できます。

失敗したテストの追加テストデータ

テストの追加データを表示するには、スタックトレースを展開します。TeamCity は、テスト失敗の詳細の前に、別のテストメタデータセクションで表示します。

数値の追加テストデータグラフ

テストデータグラフを表示するには、スタックトレースを展開します。TeamCity は、テスト失敗の詳細の前に、別のテストメタデータセクションで表示します。

成功したテストの追加データ

成功したテストの追加データを表示するには、テストタブまたはテスト履歴タブに移動します: 追加のテストデータが存在する場合、テストの OK ステータスがクリック可能になりました。

2026 年 9 月 11 日