HeuJung
5f4a733b3b
계측 축이 "목록 SELECT" 하나였고 프로파일 12종이 커맨드 파일에 하드코딩돼 있어 확장이 자기 대상을 추가할 수 없었다. 확장이 설치·제거되는 설치본마다 "실제로 존재하는 대상"이 달라지므로, 대상을 소유자가 선언하고 코어가 수집하도록 뒤집었다. - 선언 지점 두 곳, 스키마 하나: 코어 config/benchmark.php, 확장 getBenchmarkProfiles (모듈/플러그인). 수집은 method_exists 기반이라 인터페이스를 직접 구현한 서드파티 확장이 깨지지 않는다. - 축 4종(목록/화면/쓰기/배치)을 실행기로 분리하고 컨테이너 태그로 주입 — 축이 늘 때 커맨드를 고치지 않는다. - 화면 축은 HTTP 커널로 내부 요청을 처리한다. 라우트만 dispatch 하면 전역 미들웨어를 건너뛰어 화면과 다른 것을 재게 된다. 인증은 프로파일이 선언한 권한만 가진 임시 계정이 기본이며 --as 로 기존 계정을 지목할 수 있다. - 화면/쓰기 축은 계측 계정 생성부터 처리까지 롤백되는 트랜잭션 안에서 실행해 운영 DB 에도 잔여 데이터를 남기지 않는다. 배치 축은 내부 커밋·락 보유 때문에 감싸지 않고 --allow-write 로만 통제한다. - 잘못된 선언은 조용히 버리지 않고 사유를 경고로 남긴다. 버려진 선언이 곧 계측 사각이 되기 때문이다. 전부 건너뛴 실행은 종료 코드 1 로 끝난다. - 리포트는 환경 정보를 함께 적어 저장소 밖(storage/app/benchmarks)에 남긴다. 측정값이 실행 머신에 종속되므로 저장소에 축적하면 비교 불가능한 수치가 섞인다. 작업 중 발견해 함께 고친 것: - 이관 프로파일 3종의 soft_delete 선언이 실제 스키마와 어긋나 있었다 (users/product_inquiries/pages 에 deleted_at 없음). - 주문 목록이 상태 미지정 시 임시 주문 상태를 NOT IN 으로 제외하는데 선언에 빠져 있었다. filters 가 등가 비교만 지원한 것이 근본 원인이라 연산자 형태를 받도록 넓히고, 미허용 연산자는 측정 전에 거부한다. - 댓글 프로파일은 지배적 술어가 상관 서브쿼리라 선언형으로 재현할 수 없어 제거했다. 맨 테이블 스캔은 어느 화면도 내지 않는 수치가 된다. g7:bench:pagination → g7:bench 로 개명(4축을 재므로). 이전 이름은 별칭으로 남겼다. 테스트 61건 통과, 라이브 18종 전건 측정.
117 lines
5.3 KiB
PHP
117 lines
5.3 KiB
PHP
<?php
|
|
|
|
return [
|
|
/*
|
|
|--------------------------------------------------------------------------
|
|
| 성능 계측 프로파일 (Benchmark Profiles)
|
|
|--------------------------------------------------------------------------
|
|
|
|
|
| `g7:bench` 커맨드가 재는 코어 계측 대상 선언입니다. 확장은 자기 대상을
|
|
| `getBenchmarkProfiles()` 오버라이드로 선언하며(모듈/플러그인 공통), 스키마는
|
|
| 여기와 동일합니다. 계측 대상을 커맨드에 하드코딩하지 않는 이유는, 확장이
|
|
| 설치·제거되는 설치본마다 "실제로 존재하는 대상"이 다르기 때문입니다.
|
|
|
|
|
| 공통 필드
|
|
| type : list | screen | write | batch (필수)
|
|
| label : 표시용 설명 (선택)
|
|
|
|
|
| type=list — 목록 SELECT 비용 (전체 컬럼 / 목록 컬럼 / 키 컬럼 3축)
|
|
| table : 대상 테이블 (필수)
|
|
| columns : 목록이 실제로 select 하는 컬럼. ['*'] 는 "응답 계약상 전 컬럼
|
|
| 노출이라 프루닝 불가" 선언이며 이때 비교축은 select * vs select id
|
|
| order : [[컬럼, 방향], ...]
|
|
| filters : 화면이 실제로 거는 필터. 필터 없이 재면 인덱스 선택이 달라져 화면에서
|
|
| 일어나는 일과 다른 것을 잰다. 두 형태를 받는다 —
|
|
| 등가: ['board_id' => 1]
|
|
| 연산자: ['order_status' => ['not in', [...]]]
|
|
| 연산자 닫힌 집합: = != <> < <= > >= like in "not in".
|
|
| 목록에 없는 연산자는 측정 전에 사유와 함께 거부한다.
|
|
| 선언형으로 재현 못 하는 술어(상관 서브쿼리·권한 스코프)가 지배적인
|
|
| 목록은 프로파일을 두지 않는다 — 어느 화면도 내지 않는 수치가 된다.
|
|
| soft_delete : true 면 deleted_at IS NULL 부착
|
|
| seed_overrides : 합성 시딩 시 고정할 컬럼값 (filters 와 맞출 용도)
|
|
|
|
|
| type=screen — 화면 1장 응답 시간 + 실행 쿼리 건수 + N+1 후보
|
|
| route : 라우트명 (권장 — URI 프리픽스 조립 금지, 사라지면 즉시 실패)
|
|
| route_params: 라우트 파라미터
|
|
| uri : 라우트명이 없을 때만 쓰는 원시 경로
|
|
| method : HTTP 메서드 (기본 GET)
|
|
| query : 쿼리스트링 [키 => 값]
|
|
| permissions : 계측용 임시 계정에 부여할 권한 식별자 목록
|
|
|
|
|
| type=write — 저장 경로 1회 소요 시간
|
|
| callback : 'Fqcn' (invokable) 또는 ['Fqcn', 'method']. 클로저는 config:cache 를
|
|
| 깨뜨리므로 금지하며 레지스트리가 거부한다
|
|
| cleanup : 동일 형식. 측정으로 생긴 행을 되돌린다
|
|
|
|
|
| type=batch — 배치 커맨드 소요 시간 + 피크 메모리
|
|
| command : artisan 커맨드명
|
|
| arguments : 커맨드 인자/옵션 [키 => 값]
|
|
|
|
|
*/
|
|
|
|
'profiles' => [
|
|
|
|
// --- 목록 조회 (list) -------------------------------------------------
|
|
|
|
// 활동 로그와 알림 발송 이력은 응답 계약상 넓은 컬럼(changes/properties, body)을
|
|
// 그대로 노출하므로 컬럼 프루닝이 불가하다. 지연 조인만 적용했고 계측 비교축은
|
|
// select * vs select id 다.
|
|
'activity_logs' => [
|
|
'type' => 'list',
|
|
'label' => '활동 로그 목록',
|
|
'table' => 'activity_logs',
|
|
'columns' => ['*'],
|
|
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
|
'soft_delete' => false,
|
|
],
|
|
|
|
'notification_logs' => [
|
|
'type' => 'list',
|
|
'label' => '알림 발송 이력 목록',
|
|
'table' => 'notification_logs',
|
|
'columns' => ['*'],
|
|
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
|
'soft_delete' => false,
|
|
],
|
|
|
|
// 회원 테이블은 소프트 삭제 컬럼이 없다 (탈퇴는 status 로 표현) — 실제 스키마 기준 선언
|
|
'users' => [
|
|
'type' => 'list',
|
|
'label' => '회원 목록',
|
|
'table' => 'users',
|
|
'columns' => ['*'],
|
|
'order' => [['created_at', 'desc'], ['id', 'desc']],
|
|
'soft_delete' => false,
|
|
],
|
|
|
|
// --- 화면 응답 (screen) -----------------------------------------------
|
|
|
|
'activity_logs_screen' => [
|
|
'type' => 'screen',
|
|
'label' => '관리자 활동 로그 목록 화면',
|
|
'route' => 'api.admin.activity-logs.index',
|
|
'query' => ['per_page' => 20],
|
|
'permissions' => ['core.activities.read'],
|
|
],
|
|
|
|
'users_screen' => [
|
|
'type' => 'screen',
|
|
'label' => '관리자 회원 목록 화면',
|
|
'route' => 'api.admin.users.index',
|
|
'query' => ['per_page' => 20],
|
|
'permissions' => ['core.users.read'],
|
|
],
|
|
|
|
// --- 배치 작업 (batch) ------------------------------------------------
|
|
|
|
'sitemap' => [
|
|
'type' => 'batch',
|
|
'label' => '사이트맵 생성',
|
|
'command' => 'seo:generate-sitemap',
|
|
'arguments' => ['--sync' => true],
|
|
],
|
|
|
|
],
|
|
];
|