コマンド/perf

この項目はJava Edition限定の要素です。

perf

必要権限レベル	4
実行制限	専用サーバー限定

ゲームの実行状況に関する情報と測定値を10秒間収集する。

このコマンドはサーバー上専用であるため、クライアント側のパフォーマンスプロファイリングにはF3 + Lを使用されたい。

構文[]

perf start

1ティックに掛かる時間やヒープ領域のサイズなどの詳細な情報に関するプロファイリングを、10秒間行う。

perf stop

10秒経過する前に、プロファイリングを強制的に終了する。

結果[]

コマンド	トリガー	Java Edition
`/perf start`	プロファイリングがすでに開始している	失敗
`/perf stop`	プロファイリングが実行されていない	失敗
任意	成功時

出力[]

コマンド	エディション	状況	成功回数	`/execute store success ...`	`/execute store result ...`
任意	Java Edition	失敗時	-	0	0
任意	Java Edition	成功時	-	1	0

ファイル構造[]

/perfでプロファイリングを行うと、プロファイル結果のZIPファイルが.minecraft/debug/profilingに保存される。ZIPファイルの構造は次の通り。

年-月-日_時.分.秒-<ワールド名>-<バージョン>.zip
- system.txt
- server
  - deviations
    - ticktime
      - <現在のティック>@年-月-日_時.分.秒.少数3桁.txt
  - levels
    - <名前空間>
      - <ディメンション>
        block_entities.csv: x,y,z,typeのフォーマットの下、ワールド内のブロックエンティティのリストを保存。
        
        chunks.csv:x,z,level,in_memory,status,full_status,accessible_ready,ticking_ready,entity_ticking_ready,ticket,spawning,entity_count,block_entity_countのフォーマットの下、チャンクの情報のリストを保存。
        
        entities.csv: x,y,z,uuid,type,alive,custom_nameのフォーマットの下、ワールド内のエンティティのリストを保存。
        
        entity_chunks.csv: x,y,z,visibility,load_status,entity_countのフォーマットの下、ディメンション内の読み込まれているチャンクのリストを保存。
        
        example_crash.txt: クラッシュファイルの例。
        
        stats.txt: いくつかの統計値を保存。
  - metrics
    - cpu.csv
    - event_loops.csv
    - jvm.csv
    - mailboxes.csv
    - ticking.csv
  - classpath.txt: Minecraftが使用している外部の.jarファイルのパス。
  - gamerules.txt: ゲームルールとその値の一覧を記したテキストファイル（(<gamerule>=<value>のフォーマット）。
  - modules.txt: Minecraftが使用している外部のモジュールの.jarファイル。
  - profiling.txt: プロファイリングの結果。
  - server.properties.txt:現在のserver.properties。
  - stats.txt: いくつかの統計値を記録。
  - threads.txt: 実行中のスレッド一覧。

歴史[]

Java Edition
1.17		Pre-release 1			`/perf`が追加された。

コマンド