TeamCity オンプレミス 2026.1 ヘルプ

テストメタデータの報告

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

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

追加のテストデータの報告

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

  • name （オプション）は、同じテストの異なるメタデータアイテムを区別し、UI でこのアイテムを表示するために使用されるメタデータアイテムの名前です。省略すると、TeamCity は名前を自動生成しますが、UI には表示しません。

  • testName (オプション) は、このメタデータが生成されるテストの名前です。サービスメッセージがテストの途中または終了直後に報告される場合は、testName 属性をスキップできます。メタデータが後で報告される場合は、スイートとパッケージを含む完全なテスト名が次の形式で含まれている必要があります: <suiteName>: <packageName>.<testName> ( テスト名の解釈の詳細については、こちらを参照してください)。

  • value （必須）には、テストに関連付けられたメタデータ値が含まれています。最大値の長さは 1024 です。

  • type （オプション）は、特に指定がない限り、デフォルトでテキストになります。タイプは、メタデータの保存方法と、TeamCity UI でのその値の表示方法に影響します。

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

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

数値

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

##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 は name 属性と参照されたアーティファクトのファイル名の両方を表示します。名前が自動生成された場合、表示されません。

アーティファクトディレクトリからのイメージ

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

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

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

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

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

追加のテストデータの表示

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

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

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

Additional test data for a failed test

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

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

Additional test data graph for numeric values

テストを成功させるための追加データ

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

Additional data for successful tests
2025 年 4 月 07 日
任意のカバレッジ結果を TeamCity にインポートする ビルド結果にサードパーティのレポートを含める

関連ページ：

サービスメッセージ

サービスメッセージは、ビルドに関するコマンド / 情報をビルドスクリプトから TeamCity サーバーに渡す特別に構成されたテキストです。TeamCity、それらはビルドの標準出力ストリームに書き込まれる必要があり、ビルドステップから出力またはエコーされますによって処理されます。例:echo ##teamcity[<messageName> 'value']echo

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

アーティファクトのビルドはビルドによって生成されたファイルです。通常、これらにはディストリビューションパッケージ、WAR ファイル、レポート、ログファイルなどが含まれます。ビルド構成を作成するときは、一般設定を構成するページでビルドのアーティファクトへのパスを指定します。アーティファクトストレージ：TeamCity には、統合された軽量ビルドアーティファクトリポジトリが含まれています。アーティファクトは、サーバーアクセス可能ファイルシステムまたは外部ストレージに保存されます。ビルドが終了すると...

ビルド結果にサードパーティのレポートを含める

レポートツールが HTML 形式でレポートを作成する場合、TeamCity をカスタムタブで拡張して、サードパーティのレポートツールが提供する情報を表示できます。ツールによって提供されるレポートは、ビルド結果ページまたはプロジェクトホームページのいずれかに表示できます。一般的な流れは次のとおりです。HTML レポート（できれば zip アーカイブ内）を生成するようにビルドスクリプトを構成します。レポートをビルドアーティファクトとしてサーバーに公開するように構成します。この時点で、アーカイブがビル...