class Settings
W&B SDK の Settings クラスです。
このクラスは W&B SDK の設定を管理し、
すべての設定でタイプ安全性と検証が確保されるようにします。Settings には属性としてアクセスでき、
プログラムから、環境変数
(WANDB_ プレフィックス) 、および設定ファイルを通じて初期化できます。
設定は次の 3 つのカテゴリに分類されます。
- Public settings: ユーザーが安全に変更でき、特定のニーズに合わせて W&B の動作をカスタマイズするための中核的な設定オプションです。
- Internal settings: ‘x_’ で始まる Settings で、SDK の低レベルな動作を扱います。 これらの設定は主に内部利用とデバッグ用です。変更は可能ですが、 Public API の一部とは見なされず、将来の バージョンで予告なく変更される場合があります。
- Computed settings: 他の設定または 環境から自動的に導出される読み取り専用の Settings です。
method Settings.__init__
-
allow_media_symlink(bool): メディアファイルを run ディレクトリにシンボリックリンクするかどうか。 True の場合、メディアファイルはコピーされる代わりに run ディレクトリにシンボリックリンクまたはハードリンクされます。これにより、 ログがより高速になり、ディスク使用量を削減できる場合があります。ただし、 W&B サーバーにアップロードする前に元のファイルを削除または変更すると、 その内容がアップロードされたデータに反映されます。 -
allow_offline_artifacts(bool): オフラインモードで表アーティファクトを同期できるようにするフラグです。 以前の動作に戻すには、False に設定します。 -
allow_val_change(bool): 設定後にConfigの値の変更を許可するフラグです。 -
anonymous(object): 非推奨で、今後削除される予定です。 -
api_key(Optional[str]): W&B の APIキー。 -
azure_account_url_to_access_key(Optional[Dict[str, str]]): Azure インテグレーション用の、Azure アカウント URL とそれに対応するアクセス キーのマッピング。 -
app_url_override(Optional[str]): W&B UI の ‘app’ URL を上書きするための値です。app_urlは通常base_urlに基づいて計算されますが、これを使用して明示的に設定することもできます。 WANDB_APP_URL は対応する環境変数です。 -
base_url(str): データを同期するための W&B バックエンドの URL です。 -
code_dir(Optional[str]): W&Bでトラッキングするコードを含むディレクトリ。 -
config_paths(Optional[Sequence]):Configオブジェクトに読み込む設定ファイルのパス。 -
console(Literal[‘auto’, ‘off’, ‘wrap’, ‘redirect’, ‘wrap_raw’, ‘wrap_emu’]): 適用するコンソールの取得タイプです。 指定可能な値は次のとおりです:- “auto” - システム環境と設定に基づいて、コンソール出力の取得方法を自動的に選択します。
- “off” - コンソール出力の取得を無効にします。
- “redirect” - 出力を取得するために、低レベルのファイルディスクリプターをリダイレクトします。
- “wrap” - sys.stdout/sys.stderr の write メソッドをオーバーライドします。システムの状態に応じて、“wrap_raw” または “wrap_emu” のいずれかにマッピングされます。
- “wrap_raw” - “wrap” と同じですが、エミュレーターを介さずに生の出力を直接取得します。
wrap設定から派生するため、手動で設定しないでください。 - “wrap_emu” - “wrap” と同じですが、エミュレーターを介して出力を取得します。
wrap設定から派生するため、手動で設定しないでください。
-
console_multipart(bool): マルチパートのコンソールログを有効にします。 True の場合、SDK はコンソール出力を単一のoutput.logではなく、logs/ディレクトリ配下のタイムスタンプ付きファイルに書き込みます。 各パートはクローズされるとすぐにアップロードされるため、ユーザーは run がアクティブな間、ログにリアルタイムで アクセスできます。ロールオーバーの間隔はconsole_chunk_max_bytesおよび/またはconsole_chunk_max_secondsによって制御されます。 両方の制限が0の場合、すべてのログは run の終了時にまとめてアップロードされます。 注: アップロードされたチャンクは不変です。以前の行を変更する ターミナル制御シーケンス (例: キャリッジリターンを使用するプログレスバー) は、 現在のチャンクにのみ影響します。 -
console_chunk_max_bytes(int): マルチパートのコンソールログにおける、バイト単位のサイズベースのロールオーバーしきい値です。 現在のパートがこの サイズに達すると、新しいコンソールログファイルを開始します。console_multipartがTrueの場合にのみ有効です。console_chunk_max_secondsと組み合わせることができ、どちらかの制限に 先に達するとロールオーバーがトリガーされます。値を0にすると、 サイズベースの制限は無効になります。 -
console_chunk_max_seconds(int): マルチパートのコンソールログに対する、秒単位の時間ベースのロールオーバーしきい値です。 現在のパートの開始からこの秒数が経過すると、 新しいコンソールログファイルを開始します。console_multipartはTrueである必要があります。console_chunk_max_bytesと併用でき、 先に達したほうの制限でパートが閉じられます。値を0にすると、 時間ベースの制限は無効になります。 -
credentials_file(str): 一時的なアクセストークンを書き込むファイルのパスです。 -
disable_code(bool): コードの取得を無効にするかどうか。 -
disable_git(bool): Git の状態の取得を無効にするかどうか。 -
disable_git_fork_point(bool): リモートブランチから fork point を推定する処理を無効にするかどうか。 True に設定すると、設定されている場合、SDK は upstream ブランチの最新コミットを使用します。設定されていない場合は、diff パッチの生成をスキップします。 False に設定すると、SDK は、設定されている場合は upstream ブランチの最新コミットの使用を試みます。 設定されていない場合は、すべてのリモートブランチから最も近いコミットを検索します。 これは、upstream ブランチが多数あるリポジトリではパフォーマンスに影響する可能性があります。 -
disable_job_creation(bool): W&B Launch のジョブ artifact の作成を無効にするかどうか。 -
docker(Optional[str]): スクリプトの実行に使用する Docker image。 -
email(Optional[str]): ユーザーのメールアドレス。 -
entity(Optional[str]): ユーザーまたはチームなどの W&B の entity。 -
organization(Optional[str]): W&B の組織。 -
force(bool):wandb.login()にforceフラグを渡すかどうかを指定します。 -
fork_from(Optional[RunMoment]): 以前の run の実行において、フォーク元となる時点を指定します。 その時点は、run ID、メトリクス、およびその値で定義されます。 現在サポートされているメトリクスは ‘_step’ のみです。 -
git_commit(Optional[str]): run に関連付ける Git コミットハッシュ (省略可能) です。 -
git_remote(str): run に関連付ける Git リモートです。 -
git_remote_url(Optional[str]): git のリモートリポジトリの URL。 -
git_root(Optional[str]): Git リポジトリのルート ディレクトリです。 -
host(Optional[str]): スクリプトを実行しているマシンのホスト名です。 -
http_proxy(Optional[str]): W&B への HTTP リクエストに使用するカスタム プロキシサーバー。 -
https_proxy(Optional[str]): W&B への HTTPS リクエストに使用するカスタムプロキシサーバー。 -
identity_token_file(Optional[str]): 認証用のアイデンティティトークン (JWT) が格納されたファイルへのパス。 -
ignore_globs(Sequence): アップロードから除外するファイルを指定する、files_dirからの相対パスの Unix glob パターン。 -
init_timeout(float):wandb.initの呼び出しが完了するまで待機する時間 (秒) 。この時間を超えるとタイムアウトします。 -
insecure_disable_ssl(bool): 安全でない方法で SSL 検証を無効にするかどうか。 -
job_name(Optional[str]): スクリプトを実行中のLaunchジョブの名。 -
job_source(Optional[Literal[‘repo’, ‘artifact’, ‘image’]]): Launch のソースのタイプ。 -
label_disable(bool): 自動ラベリング機能を無効にするかどうかを指定します。 -
launch_config_path(Optional[str]): Launch 設定ファイルのパス。 -
login_timeout(Optional[float]): ログイン処理がタイムアウトするまでの待機時間 (秒) 。 -
mode(Literal[‘online’, ‘offline’, ‘shared’, ‘disabled’, ‘dryrun’, ‘run’]): W&B のログ記録と同期を行う際の動作モードです。 -
notebook_name(Optional[str]): Jupyterのような環境で実行する場合のノートブック名。 -
program(Optional[str]): 利用可能な場合、run を作成したスクリプトのパス。 -
program_abspath(Optional[str]): run を作成したスクリプトへの、リポジトリのルートディレクトリからの絶対パスです。 リポジトリのルートディレクトリは、.gitディレクトリが存在する場合はそれを含むディレクトリとして定義されます。存在しない場合は、現在の作業ディレクトリです。 -
program_relpath(Optional[str]): run を作成したスクリプトの相対パスです。 -
project(Optional[str]): W&B の project ID。 -
quiet(bool): 必要のない出力を抑制するフラグです。 -
reinit(Union[Literal[‘default’, ‘return_previous’, ‘finish_previous’, ‘create_new’], bool]): run がアクティブな状態でwandb.init()が呼び出されたときの動作。 オプション:- “default”: ノートブックでは “finish_previous” を使用し、それ以外では “return_previous” を使用します。
- “return_previous”: まだ終了していない、直近に作成された run を返します。
これは
wandb.runを更新しません。“create_new” オプションを参照してください。 - “finish_previous”: アクティブなすべての run を終了した後、新しい run を返します。
- “create_new”: 他のアクティブな run を変更せずに、新しい run を作成します。
wandb.runやwandb.logのようなトップレベル関数は更新されません。 このため、グローバル run に依存する一部の古いインテグレーションは 動作しません。 ブール値を指定することもできますが、これは非推奨です。False は “return_previous” と同じで、True は “finish_previous” と同じです。
-
relogin(bool): 再度ログインを試行するよう強制するフラグです。 -
resume(Optional[Literal[‘allow’, ‘must’, ‘never’, ‘auto’]]): run の再開動作を指定します。 オプション:- “must”: 同じ ID の既存の run から再開します。該当する run が存在しない場合は、 失敗します。
- “allow”: 同じ ID の既存の run からの再開を試みます。見つからない場合は、 新しい run が作成されます。
- “never”: 常に新しい run を開始します。同じ ID の run がすでに存在する場合は、 失敗します。
- “auto”: 同じマシン上で直近に失敗した run から自動的に再開します。
-
resume_from(Optional[RunMoment]): 以前の run の実行において、再開元となる時点を指定します。 この時点は、run ID、メトリクス、およびその値で定義されます。 現在サポートされているメトリクスは ‘_step’ のみです。 -
root_dir(str): すべてのrun関連パスの基準となるルートディレクトリです。 特に、wandbディレクトリとrunディレクトリはこの値に基づいて決定されます。 -
run_group(Optional[str]): 関連する run のグループ識別子。 UI で run をグループ化する際に使用します。 -
run_id(Optional[str]): run の ID です。 -
run_job_type(Optional[str]): 実行中のジョブのタイプ (例: トレーニング、評価) 。 -
run_name(Optional[str]): runの人間が読みやすい名前。 -
run_notes(Optional[str]): run に関する追加のメモまたは説明。 -
run_tags(Optional[Tuple[str, Ellipsis]]): 組織化やフィルタリングのために run に関連付ける Tags。 -
sagemaker_disable(bool): SageMaker 固有の機能を無効にするフラグ。 -
save_code(Optional[bool]): run に関連付けられたコードを保存するかどうか。 -
settings_system(Optional[str]): システム全体で使用する設定ファイルのパス。 -
max_end_of_run_history_metrics(int): run の終了時に表示する履歴スパークラインの最大数。 -
max_end_of_run_summary_metrics(int): run終了時に表示されるsummaryメトリクスの最大数。 -
show_errors(bool): エラー メッセージを表示するかどうか。 -
show_info(bool): 情報メッセージを表示するかどうかを指定します。 -
show_warnings(bool): 警告メッセージを表示するかどうかを指定します。 -
silent(bool): すべての出力を抑制するフラグです。 -
strict(Optional[bool]): 検証とエラーチェックに対して厳格モードを有効にするかどうか。 -
summary_timeout(int):summaryの処理がタイムアウトするまで待機する秒数。 -
sweep_id(Optional[str]): この run が属する sweep の ID。 -
sweep_param_path(Optional[str]): sweep パラメーターの設定へのパス。 -
symlink(bool): シンボリックリンクを使用するかどうか (Windows を除き、デフォルトは True) 。 -
sync_tensorboard(Optional[bool]): TensorBoard のログを W&B に同期するかどうか。 -
table_raise_on_max_row_limit_exceeded(bool): 表の行数制限を超えた場合に例外を送出するかどうか。 -
use_dot_wandb(Optional[bool]): run データに対して、非表示の.wandbディレクトリと表示されるwandbディレクトリのどちらを使用するかを指定します。 True の場合、SDK は.wandbを使用します。False の場合はwandbを使用します。 設定されていない場合、.wandbがすでに存在すればデフォルトでそれを使用し、そうでなければwandbを使用します。 -
username(Optional[str]): ユーザー名。 -
x_disable_meta(bool): システムメタデータのコレクションを無効にするフラグです。 -
x_disable_stats(bool): システムメトリクスの収集を無効にするフラグです。 -
x_extra_http_headers(Optional[Dict[str, str]]): 送信するすべての HTTP リクエストに付加するヘッダーです。 -
x_label(Optional[str]): run に対して収集されるシステムメトリクスおよびコンソールログに割り当てるラベルです。 フロントエンドでデータをグループ化するために使用され、分散トレーニングジョブ内の 異なるプロセスからのデータを区別するのにも使用できます。 -
x_primary(bool): 内部 wandb ファイルとメタデータを保存するかどうかを指定します。 分散環境では、システムメトリクスとログのみが必要な場合、 プライマリプロセスが主要なログ出力を担うため、セカンダリプロセスによる ファイルの上書きを回避するのに役立ちます。 -
x_save_requirements(bool): requirements ファイルを保存するためのフラグです。 -
x_server_side_derived_summary(bool):historyからsummaryを自動計算する処理をサーバー側に委譲するためのフラグです。 この設定を有効にしても、ユーザーによるsummaryの更新は無効になりません。 -
x_service_wait(float): wandb-core の内部サービスの起動を待機する時間 (秒) 。 -
x_skip_transaction_log(bool): run イベントをトランザクションログに保存しないようにするかどうか。 これは online run でのみ有効です。ディスクに書き込まれる データ量を減らすために使用できます。 ただし、復旧可能性に関する保証が失われるため、 注意して使用してください。 -
x_stats_sampling_interval(float): システムモニターのサンプリング間隔 (秒単位) 。 -
x_stats_dcgm_exporter(Optional[str]): Nvidia DCGM メトリクスを抽出するエンドポイント。 オプション:- Prometheus の
/api/v1/queryエンドポイントへのクエリから、DCGM 関連のメトリクスを抽出します。 Prometheus を使用して、クラスター内の異なるノードで実行されている DCGM Exporter インスタンスから報告されるメトリクスを集約するのは一般的です。 - TODO: DCGM Exporter の
/metricsエンドポイントからメトリクスを直接パースします。 例: http://localhost:9400/api/v1/query?query=DCGM_FI_DEV_GPU_TEMP{node="l1337", cluster="globular"}.
- Prometheus の
-
x_stats_open_metrics_endpoints(Optional[Dict[str, str]]): システムメトリクスを監視する OpenMetrics/metricsエンドポイント。 -
x_stats_open_metrics_filters(Union[Dict[str, Dict[str, str]], Sequence, None]): OpenMetrics の/metricsエンドポイントから収集されるメトリクスに適用するフィルターです。 次の 2 つの形式をサポートします:{"エンドポイント名を接頭辞として含むメトリクスの正規表現パターン": {"label": "ラベル値の正規表現パターン"}}("メトリクスの正規表現パターン 1", "メトリクスの正規表現パターン 2", ...)
-
x_stats_open_metrics_http_headers(Optional[Dict[str, str]]): OpenMetrics リクエストに追加する HTTP ヘッダー。 -
x_stats_disk_paths(Optional[Sequence]): ディスク使用量を監視する対象のシステムパス。 -
x_stats_cpu_count(Optional[int]): システムの CPU 数。 If set, overrides the auto-detected value in the run metadata. -
x_stats_cpu_logical_count(Optional[int]): 論理 CPU 数。 設定すると、run メタデータで自動検出された値を上書きします。 -
x_stats_gpu_count(Optional[int]): GPU デバイス数。 設定すると、run メタデータ内で自動検出された値を上書きします。 -
x_stats_gpu_type(Optional[str]): GPU デバイスのタイプ。 設定すると、run メタデータで自動検出された値を上書きします。 -
x_stats_gpu_device_ids(Optional[Sequence]): 監視対象の GPU デバイスのインデックスです。 設定しない場合、システムモニターはすべての GPU のメトリクスを取得します。 CUDA/ROCm のデバイス列挙に対応する 0 始まりのインデックスであることを前提とします。 -
x_stats_track_process_tree(bool):x_stats_pidを起点として、プロセス ツリー全体のリソース使用状況を監視します。Trueの場合、システム モニターは PIDx_stats_pidのプロセスとそのすべての子孫プロセスの RSS、CPU%、およびスレッド数を集計します。 これによりパフォーマンス上のオーバーヘッドが発生する可能性があるため、デフォルトでは無効になっています。 -
x_sync_dir_suffix(str): run のディレクトリ名 (sync_dir) に追加するサフィックスです。 これは、名前の競合を避けるためにwandb.init()で設定します。 設定すると、デフォルト名にダッシュ区切りで連結されます。 -
x_update_finish_state(bool): このプロセスがサーバー上で run の最終状態を更新できるかどうかを示すフラグです。 分散トレーニングで、最終状態を決定するのがメインプロセスのみである必要がある場合は、False に設定します。
Settings オブジェクト。
プロパティ Settings.app_url
W&B UI の URL です。通常は https://wandb.ai です。
これは、プログラムから W&B API にアクセスするために使用する
base_url (https://api.wandb.ai など) とは異なります。
戻り値:
str: app_url プロパティの値。
プロパティ Settings.colab_url
Colab で実行している場合の Colab ノートブックの URL です。
戻り値:
Optional[str]:colab_urlプロパティの値。
プロパティ Settings.deployment
プロパティ Settings.files_dir
run のファイルが保存されているローカルディレクトリの絶対パスです。
戻り値:
str: files_dir プロパティの値。
プロパティ Settings.is_local
プロパティ Settings.log_dir
ログファイルを保存するディレクトリです。
戻り値:
str:log_dirプロパティの値。
プロパティ Settings.log_internal
内部ログ用のファイルのパスです。
戻り値:
str:log_internalプロパティの値です。
プロパティ Settings.log_symlink_internal
最新の run の内部ログファイルへのシンボリックリンクのパスです。
戻り値:
str:log_symlink_internalプロパティの値です。
プロパティ Settings.log_symlink_user
最新の run におけるユーザープロセスのログファイルへのシンボリックリンクのパスです。
戻り値:
str:log_symlink_userプロパティの値です。
プロパティ Settings.log_user
ユーザープロセスのログを出力するファイルのパスです。
戻り値:
str:log_userプロパティの値。
プロパティ Settings.project_url
project を表示できる W&B の URL です。
戻り値:
str:project_urlプロパティの値です。
プロパティ Settings.resume_fname
resume ファイルのパスです。
戻り値:
str:resume_fnameプロパティの値です。
プロパティ Settings.run_mode
run のモードを示します。“run” または “offline-run” のいずれかです。
戻り値:
Literal['run', 'offline-run']: run_mode プロパティの値です。
プロパティ Settings.run_url
run を表示できる W&B の URL です。
戻り値:
str:run_urlプロパティの値。
プロパティ Settings.settings_workspace
Workspace settings ファイルのパスです。
戻り値:
str:settings_workspaceプロパティの値です。
プロパティ Settings.sweep_url
sweep を表示できる W&B の URL です。
戻り値:
str:sweep_urlプロパティの値。
プロパティ Settings.sync_dir
run ファイルを保存するディレクトリです。
戻り値:
str:sync_dirプロパティの値です。
プロパティ Settings.sync_file
追記専用のバイナリトランザクションログファイルへのパスです。
戻り値:
str:sync_fileプロパティの値です。
プロパティ Settings.sync_symlink_latest
最新の run のトランザクションログファイルを指すシンボリックリンクのパスです。
戻り値:
str:sync_symlink_latestプロパティの値。
プロパティ Settings.timespec
run の時刻指定を表します。
戻り値:
str: timespec プロパティの値。
プロパティ Settings.wandb_dir
wandb ディレクトリのフルパスです。
戻り値:
str:wandb_dirのプロパティ値です。