メインコンテンツまでスキップ

ビルドログ

ビルドログを使うと、ユーザーは自分のビルドを解析して、何が問題だったのか、そして何がうまくいったのかを確認できます。Bitriseでは、ビルドログに簡単にアクセスできます。ウェブサイト上で全文を確認することも、ダウンロードして自分のデバイスで確認することもできます。

ビルドの保持期間は 200 日間

アプリの Builds ページには、過去 200 日間のビルドのみが表示されます。このページで特定のビルドを検索する場合にも、同じ制限が適用されます。この制限は、ほとんどの API 呼び出しにも適用されます。GET/apps/{app-slug}/builds エンドポイントおよび関連するエンドポイントが返すのは、過去 200 日間のビルドのみです。

ただし、200 日より前のビルドを取得する方法が 2 つあります。

ビルドログを見つけるClick to copy link​

ビルドを実行すると、ビルドログが自動的に生成されます。すべてのビルドには、それぞれ固有のビルドログURLを持つ専用のログがあります。ビルドログURLには、特定のビルドを識別する16進数のビルドスラッグが含まれています。

Bitrise サポートへの対応

Bitrise サポートからビルドログの提供を求められた場合は、ビルドURLを送信するのが最善です。

  1. Bitrise CIページを開き、プロジェクト一覧から対象のプロジェクトを選択します。

  2. 確認したいビルドを選択します。

  3. Logタブが選択されていることを確認します。

  4. Logタブでは、WorkflowのStepsとそのステータスを確認できます。失敗したStepsはデフォルトですべて展開されています。

    Build logタブに表示されたStepsとそのステータス

  5. Stepの右側にある下向き矢印をクリックすると、Stepの情報を展開できます。ビルドログの該当部分が表示されます。

build logページClick to copy link​

build logページには、ビルドに含まれていたすべてのStepsとそのステータスが表示されます。失敗したStepsはデフォルトで展開され、トラブルシューティングをしやすいようにエラーメッセージがハイライト表示されます。Stepを展開すると、次の情報も確認できます。

注記

ログのヘッダーにあるDurationフィールドの値は、すべてのStepsの所要時間の合計と一致しない場合があります。この差異が生じる原因としては、次の2つが考えられます。

  • 所要時間の値には、Workflow/Pipelineの一回限りの初期化時間に加え、Stepの所要時間の合計が含まれます。
  • リモートアクセスを使用している場合、すべてのステップが完了した後も、ログの確認・ダウンロードができるようにVMは10分間開いたままになります。
  • Stepの実行開始時刻。
  • Step ID。これは、bitrise.ymlの設定ファイルがStepを識別する方法です。詳しくは、Step reference/ID formatをご覧ください。
  • Stepの現在のバージョン。バージョン番号の下には、Stepのリリースノートを確認できます。ビルドがStepのlatest versionで実行されなかった場合は、UpdateをクリックしてWorkflow Editorを開き、Stepを別のバージョンに更新することもできます。
  • Step resourcesの下では、IntegrationsページでStepのドキュメントを確認できるほか、GitHubでソースコードや課題管理を確認できます。

ビルドログの内容を1つのファイルで全文確認するには、ログをダウンロードしてください。

ビルドログをライブで確認するClick to copy link​

ビルドの実行中に、そのログをライブで確認できます。さらに、ビルドの進行に合わせてログを自動的に追従表示させることも可能です。つまり、ビルドが進むにつれて、新しいセクションが表示されるとログが自動的にスクロールします。

その方法は次のとおりです。

  1. ビルドを開始します。

  2. ビルドのページに移動します。

  3. ログまでスクロールします。

  4. Followをクリックします。

    実行中のビルドのログにあるFollowボタン

追従表示を停止するには、ログ内の任意の場所へ手動で移動するだけです。追従表示はいつでも再開できます。

ビルドログをダウンロードするClick to copy link​

Bitrise上のアプリにアクセスできない人にビルドログを送付する必要がある場合や、ログを自分のアーカイブに保存しておきたい場合は、Bitriseからログファイルを簡単にダウンロードできます。

ログのセキュリティ

ビルドログには機密情報が含まれる場合があるため、ご注意ください。ログファイルをダウンロードして誰かに送付する前に、必ず内容を確認してください。ビルドログに機密情報が表示されないようにするには、Secretsの使用をおすすめします。

  1. Bitrise CIページを開き、プロジェクト一覧から対象のプロジェクトを選択します。
  2. 確認したいビルドを選択します。
  3. Logsドロップダウンメニューを開き、Download logsボタンをクリックします。

ビルドログを削除するClick to copy link​

必要に応じて、Bitrise上の任意のビルドのログを削除できます。たとえば、新しいチームメンバーに過去のログに表示されている可能性のある機密情報を見られたくない場合などに役立ちます。

すべてのチームメンバーがログを削除できるわけではありません。チーム内でAdminまたはOwnerのロールを持つメンバーのみが削除できます。

削除は取り消せません

ログの削除は元に戻せないことにご注意ください。一度削除すると、ログファイルを復元する方法はありません。

  1. Bitrise CIページを開き、プロジェクト一覧から対象のプロジェクトを選択します。

  2. 確認したいビルドを選択します。

  3. Logsドロップダウンメニューを開き、Delete Logsボタンをクリックします。

    Download logsとDelete logsのオプションがあるLogsドロップダウンメニュー

  4. ポップアップウィンドウでDelete logsをクリックします。