可観測性


builds for Red Hat OpenShift 1.6

ビルドコントローラーの可観測性

Red Hat OpenShift Documentation Team

概要

このドキュメントでは、ビルドコントローラーの可観測性に関する情報を提供します。

第1章 ロギング

ビルドが失敗した場合や、ビルドで予期しない動作が発生した場合は、詳細なログにアクセスすると、問題の特定に役立ちます。ログには、ビルド実行中に発生したことに関する情報が表示されます。

1.1. ログの表示

ビルド実行のログを表示して、実行時エラーを特定し、解決することができます。

前提条件

  • oc CLI がインストールされている。
  • オプション: shp CLI がインストールされている。

手順

  • いずれかの CLI を使用して、ビルド実行のログを表示します。

    oc CLI の使用

    $ oc logs <buildrun_resource_name>
    Copy to Clipboard Toggle word wrap

    shp CLI の使用

    $ shp buildrun logs <buildrun_resource_name>
    Copy to Clipboard Toggle word wrap

第2章 モニタリング

Builds は、ビルドリソースのパフォーマンスと機能の監視に役立ついくつかのメトリクスを公開します。ビルドコントローラーのメトリクスはポート 8383 で公開されます。

2.1. ビルドコントローラーのメトリクス

モニタリング用に、以下のビルドコントローラーのメトリクスを確認できます。

Expand
表2.1 ビルドコントローラーのメトリクス
名前説明ラベルステータス

build_builds_registered_total

Counter

登録されているビルドの総数。

  • buildstrategy=<build_buildstrategy_name>
  • namespace=<buildrun_namespace>
  • build=<build_name>

実験的機能

build_buildruns_completed_total

Counter

完了したビルド実行の合計数。

  • buildstrategy=<build_buildstrategy_name>
  • namespace=<buildrun_namespace>
  • build=<build_name>
  • buildrun=<buildrun_name>

実験的機能

build_buildrun_establish_duration_seconds

ヒストグラム

ビルド実行の確立にかかる時間 (秒)。

  • buildstrategy=<build_buildstrategy_name>
  • namespace=<buildrun_namespace>
  • build=<build_name>
  • buildrun=<buildrun_name>

実験的機能

build_buildrun_completion_duration_seconds

ヒストグラム

ビルド実行の完了までにかかる時間 (秒)。

  • buildstrategy=<build_buildstrategy_name>
  • namespace=<buildrun_namespace>
  • build=<build_name>
  • buildrun=<buildrun_name>

実験的機能

build_buildrun_rampup_duration_seconds

ヒストグラム

ビルド実行の立ち上げにかかる時間 (秒)。

  • buildstrategy=<build_buildstrategy_name>
  • namespace=<buildrun_namespace>
  • build=<build_name>
  • buildrun=<buildrun_name>

実験的機能

build_buildrun_taskrun_rampup_duration_seconds

ヒストグラム

タスク実行のビルド実行立ち上げにかかる時間 (秒)。

  • buildstrategy=<build_buildstrategy_name>
  • namespace=<buildrun_namespace>
  • build=<build_name>
  • buildrun=<buildrun_name>

実験的機能

build_buildrun_taskrun_pod_rampup_duration_seconds

ヒストグラム

タスク実行 Pod のビルド実行立ち上げにかかる時間 (秒)。

  • buildstrategy=<build_buildstrategy_name>
  • namespace=<buildrun_namespace>
  • build=<build_name>
  • buildrun=<buildrun_name>

実験的機能

2.1.1. ヒストグラムメトリクス

ビルドコントローラーにカスタムバケットを使用するには、特定のヒストグラムメトリクスの環境変数を設定する必要があります。次の表は、すべてのヒストグラムメトリクスの環境変数を示しています。

Expand
表2.2 ヒストグラムメトリクス
メトリクス環境変数デフォルト

build_buildrun_establish_duration_seconds

PROMETHEUS_BR_EST_DUR_BUCKETS

0,1,2,3,5,7,10,15,20,30

build_buildrun_completion_duration_seconds

PROMETHEUS_BR_COMP_DUR_BUCKETS

50,100,150,200,250,300,350,400,450,500

build_buildrun_rampup_duration_seconds

PROMETHEUS_BR_RAMPUP_DUR_BUCKETS

0,1,2,3,4,5,6,7,8,9,10

build_buildrun_taskrun_rampup_duration_seconds

PROMETHEUS_BR_RAMPUP_DUR_BUCKETS

0,1,2,3,4,5,6,7,8,9,10

build_buildrun_taskrun_pod_rampup_duration_seconds

PROMETHEUS_BR_RAMPUP_DUR_BUCKETS

0,1,2,3,4,5,6,7,8,9,10

Legal Notice

Copyright © 2025 Red Hat

OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).

Modified versions must remove all Red Hat trademarks.

Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.

Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat