teamcity-info.xml

ビルドスクリプト収集情報を収集するための廃止されたアプローチとして、ルートビルドディレクトリに teamcity-info.xml と呼ばれる XML ファイルを生成できます。ビルドが完了すると、このファイルはビルドアーティファクトとして自動的にアップロードされ、TeamCity サーバーによって処理されます。

このアプローチは将来の TeamCity バージョンでは中止できます可能性があるため、代わりにサービスメッセージアプローチをお勧めします。サービスメッセージが機能しない場合は、詳細をお知らせいただき、メールでケースを説明してください。

ビルドステータスの変更

TeamCity には、ビルドスクリプトから直接ビルドステータスを変更する機能があります。ステータス(ビルドの失敗または成功)を設定し、ビルドステータスのテキストを変更できます(たとえば、テストフレームワークが TeamCity でサポートされていない場合は、失敗したテスト数を記載します)。

ビルドに対して以下の情報を設定することが可能です。

ビルド番号 — 完成したビルドの新しい番号を設定します。 {build.number} を使用して、TeamCity が提供するビルド番号を参照できます。
ビルドステータス — ビルドステータスを変更します。サポートされている値は 失敗 と SUCCESS です。
ステータステキスト — ビルドステータスのテキストを変更します。 TeamCity が提供するステータステキストを置き換えたり、標準テキストの前後にカスタム部分を追加したりできます。サポートされている アクション の値は、「append」、「prepend」、「replace」です。

teamcity-info.xml ファイルの例:

<build number="1.0.{build.number}">
   <statusInfo status="FAILURE"> <!-- or SUCCESS -->
      <text action="append"> fitnesse: 45</text>
      <text action="append"> coverage: 54%</text>
   </statusInfo>
</build>


  

カスタム統計の報告

TeamCity でカスタムチャートを提供できます。ビルドでは、 teamcity-info.xml ファイルを使用してこのようなグラフのデータを提供できます。

teamcity-info.xml へのデータの保存

このファイルは、ビルドによってビルドのルートディレクトリに作成されます。複数の統計を公開し（下記のデータ形式の詳細を参照）、値のセットごとに別々のチャートを作成することができます。

teamcity-info.xml ファイルには、次の形式のコードが含まれています（teamcity-info.xml ファイルにさまざまなデータを組み合わせることができます）。

<build>
   <statisticValue key="chart1Key" value="342"/>
   <statisticValue key="chart2Key" value="53"/>
</build>

キー は、事前定義されたキーのいずれとも等しくありません。 値 は、最大 13 桁の正 / 負の整数である必要があります。最大 6 桁の小数点以下の浮動小数点値がサポートされています。

ここでのキーは、チャートを記述するときに使用される valueType タグのキーに関連しています。

カスタムチャートの説明

詳細な説明については、統計チャートのカスタマイズページを参照してください。

2026 年 9 月 11 日