시스템

메모리 사용량, 가비지 컬렉션 통계, CPU 정보, 프로세스 메타데이터를 포함한 런타임 시스템 정보를 조회합니다.

로딩

local system = require("system")

종료

종료 코드와 함께 시스템 종료를 트리거합니다. 터미널 앱에 유용합니다. 실행 중인 액터에서 호출하면 전체 시스템이 종료됩니다:

local ok, err = system.exit(0)

반환: boolean, error

모듈 목록

메타데이터와 함께 로드된 모든 Lua 모듈을 가져옵니다:

local mods, err = system.modules()

반환: table[], error

각 모듈 테이블에는 다음이 포함됩니다:

메모리 통계

상세한 메모리 통계를 가져옵니다:

local stats, err = system.memory.stats()

반환: table, error

통계 테이블에는 다음이 포함됩니다:

현재 할당량

현재 할당된 바이트를 가져옵니다:

local bytes, err = system.memory.allocated()

반환: number, error

힙 객체

할당된 힙 객체 수를 가져옵니다:

local count, err = system.memory.heap_objects()

반환: number, error

메모리 제한

메모리 제한을 설정합니다 (이전 값 반환):

local prev, err = system.memory.set_limit(1024 * 1024 * 100)

반환: number, error

현재 메모리 제한을 가져옵니다:

local limit, err = system.memory.get_limit()

반환: number, error

강제 GC

가비지 컬렉션을 강제 실행합니다:

local ok, err = system.gc.collect()

반환: boolean, error

GC 목표 퍼센트

GC 목표 퍼센트를 설정합니다 (이전 값 반환). 100 값은 힙이 두 배가 될 때 GC가 트리거됨을 의미합니다:

local prev, err = system.gc.set_percent(200)

반환: number, error

현재 GC 목표 퍼센트를 가져옵니다:

local percent, err = system.gc.get_percent()

반환: number, error

고루틴 수

활성 고루틴 수를 가져옵니다:

local count, err = system.runtime.goroutines()

반환: number, error

GOMAXPROCS

GOMAXPROCS 값을 가져오거나 설정합니다:

-- 현재 값 가져오기
local current, err = system.runtime.max_procs()

-- 새 값 설정
local prev, err = system.runtime.max_procs(4)

반환: number, error

CPU 수

논리 CPU 수를 가져옵니다:

local cpus, err = system.runtime.cpu_count()

반환: number, error

프로세스 ID

현재 프로세스 ID를 가져옵니다:

local pid, err = system.process.pid()

반환: number, error

호스트명

시스템 호스트명을 가져옵니다:

local hostname, err = system.process.hostname()

반환: string, error

서비스 상태

특정 감독 서비스의 상태를 가져옵니다:

local state, err = system.supervisor.state("namespace:service")

반환: table, error

상태 테이블에는 다음이 포함됩니다:

모든 서비스 상태

모든 감독 서비스의 상태를 가져옵니다:

local states, err = system.supervisor.states()

반환: table[], error

각 상태 테이블은 system.supervisor.state()와 동일한 형식입니다.

권한

시스템 작업은 보안 정책 평가 대상입니다.

에러

에러 처리는 에러 처리를 참조하세요.