53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
|
# JIT Events JSON (v0.1)
|
|||
|
|
|
|||
|
|
最小のイベントJSONスキーマ。観測の足場として、値は安定キーのみを出力します。
|
|||
|
|
|
|||
|
|
- 出力形態: 1行 = 1 JSON（JSONL）
|
|||
|
|
- 出力先: 標準出力 or `NYASH_JIT_EVENTS_PATH` で指定したファイル
|
|||
|
|
- phase分離:
|
|||
|
|
- compile: `phase: "lower"`（明示opt-in: `NYASH_JIT_EVENTS_COMPILE=1`）
|
|||
|
|
- runtime: `phase: "execute"`（既定ON可: `NYASH_JIT_EVENTS=1` または `NYASH_JIT_EVENTS_RUNTIME=1`）
|
|||
|
|
|
|||
|
|
## フィールド（必須）
|
|||
|
|
- kind: 文字列（例: "hostcall"）
|
|||
|
|
- function: 文字列（現状は "<jit>" で固定）
|
|||
|
|
- phase: 文字列（"lower" | "execute"）
|
|||
|
|
- id: シンボル名（例: "nyash.map.get_hh"）
|
|||
|
|
- decision: 文字列（"allow" | "fallback"）
|
|||
|
|
- reason: 文字列（"sig_ok" | "receiver_not_param" | "policy_denied_mutating" | "sig_mismatch" など）
|
|||
|
|
- argc: 数値（観測引数数）
|
|||
|
|
- arg_types: 文字列配列（例: ["Handle","I64"]）
|
|||
|
|
|
|||
|
|
任意フィールド（存在時のみ）
|
|||
|
|
- handle: 数値（JITハンドル）
|
|||
|
|
- ms: 数値（処理時間ミリ秒）
|
|||
|
|
|
|||
|
|
## 出力例
|
|||
|
|
|
|||
|
|
compile（lower）:
|
|||
|
|
```json
|
|||
|
|
{"kind":"hostcall","function":"<jit>","id":"nyash.map.get_hh","decision":"allow","reason":"sig_ok","argc":2,"arg_types":["Handle","Handle"],"phase":"lower"}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
runtime（execute）:
|
|||
|
|
```json
|
|||
|
|
{"kind":"hostcall","function":"<jit>","id":"nyash.array.push_h","decision":"fallback","reason":"policy_denied_mutating","argc":2,"arg_types":["Handle","I64"],"phase":"execute"}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
trap（execute 中の失敗）:
|
|||
|
|
```json
|
|||
|
|
{"kind":"trap","function":"<jit>","reason":"jit_execute_failed","ms":0,"phase":"execute"}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 環境変数（抜粋）
|
|||
|
|
- NYASH_JIT_EVENTS=1: 既定のruntime出力
|
|||
|
|
- NYASH_JIT_EVENTS_COMPILE=1: compile（lower）出力
|
|||
|
|
- NYASH_JIT_EVENTS_RUNTIME=1: runtime出力
|
|||
|
|
- NYASH_JIT_EVENTS_PATH=path.jsonl: ファイルに追記
|
|||
|
|
- NYASH_JIT_THRESHOLD（未設定時）: 観測ONで自動的に1が補われます（Runner/DebugConfigBoxが補助）
|
|||
|
|
|
|||
|
|
## 推奨の最小運用
|
|||
|
|
- 現象確認: `NYASH_JIT_EVENTS=1`（runtimeのみ）
|
|||
|
|
- 解析時のみcompile出力: `NYASH_JIT_EVENTS_COMPILE=1 NYASH_JIT_EVENTS_PATH=events.jsonl`
|
|||
|
|
- HostCall系の例では `NYASH_JIT_HOSTCALL=1` を明示
|