Superlog 자체 호스팅 설치 구성과 실제 규모
Superlog는 OTLP trace, log, metric을 incident로 묶고 에이전트가 분류합니다. VPS에 Postgres, ClickHouse, collector와 Node 서비스 4개를 설치하기 전 실제 구성과 한계를 확인합니다.
Superlog를 실제로 자체 호스팅할 때 설치되는 구성 요소
Superlog를 자체 호스팅하려면 저장소를 clone하고, Docker Compose로 Postgres, ClickHouse, OpenTelemetry collector를 실행한 다음, 데이터베이스 마이그레이션 1회를 수행하고, 소스에서 Node 서비스 4개를 시작해야 한다. 애플리케이션은 OTLP(OpenTelemetry protocol) trace, log, metric을 intake 포트로 전송한다. Superlog는 이를 fingerprinting하고, 반복되는 항목을 하나의 incident로 그룹화한다. 기본 community agent runner는 로컬 incident 요약을 기록한다. 설치에는 반나절이 걸린다. 시작하기 전에 확인할 가치가 있는 부분은 설치 규모와 솔직한 한계다.
Superlog는 Apache 2.0 라이선스로 배포되며 github.com/superloglabs/superlog에 있다. 13 October 2026 기준으로 star는 약 1.5k개이고, main에는 commit이 대략 490개 있으며, release tag는 전혀 없다. clone한 날 아침에 main에 있었던 내용을 그대로 실행하지 말고 직접 commit을 고정해야 한다.
Superlog가 Uptime Kuma와 Langfuse에는 없는 답을 제공하는 것
셀프 호스팅 모니터링 도구는 겉으로 보면 서로 대체할 수 있을 것처럼 보인다. 그러나 실제로는 다르며, 잘못된 도구를 운영하면 아무런 이점 없이 서버만 사용하게 된다.
- Uptime Kuma는 외부에서 엔드포인트를 확인하고, 서비스가 작동하는지만 알려 준다.
- Zabbix는 Ubuntu 24.04에서 호스트와 서비스를 감시하며, 설정한 임계값을 기준으로 CPU, 메모리, 디스크와 서비스 상태를 확인한다.
- Langfuse는 LLM 호출을 추적하며, 각 호출의 프롬프트, 모델, 토큰 수, 지연 시간과 비용을 기록한다.
- Superlog는 일반 서비스가 이미 생성하는 텔레메트리를 받아 반복되는 장애를 인시던트로 변환한다.
Superlog가 다루는 질문은 다음과 같다. 무엇인가 고장 났다면, 무엇이 고장 났고 그 원인은 무엇인가. Superlog는 LLM 호출을 대상으로 하지 않으며 외부에서 서비스를 확인하지도 않는다. 일반 애플리케이션 코드에서 OTLP를 수집하고, 트리아지 단계에 에이전트를 배치한다. 이 단계는 온콜 담당자가 어차피 수행하는 최초 점검이다.
VPS 예산에서 중요한 차이는 스토리지다. Superlog에는 컬럼 스토어가 포함된다. 텔레메트리는 한 번 기록한 뒤 수백만 행을 대상으로 시간 범위별 조회를 수행하기 때문이다. 이것이 ClickHouse가 담당하는 작업이며, Postgres가 담당하는 작업은 아니다. Postgres도 스택에 포함되지만, 프로젝트, 사용자, 인시던트와 ingest key 같은 소규모 관계형 데이터를 저장한다.
docker compose up -d는 실제로 무엇을 시작하는가?
세 개의 컨테이너가 시작되지만, 그중 Superlog는 없습니다. 한 번의 명령어로 설치가 완료될 것이라 기대하는 사용자들에게는 의외일 수 있습니다.
postgres:16: 호스트 포트 5434로 게시됨clickhouse/clickhouse-server:26.1: HTTP용 8123 포트 및 네이티브 프로토콜용 9000 포트 사용otel/opentelemetry-collector-contrib:0.150.1: gRPC용 4317 포트 및 HTTP 기반 OTLP용 4318 포트 사용
Superlog 애플리케이션은 호스트에서 소스 코드로부터 실행되며, pnpm dev에 의해 시작됩니다. 2026년 10월 13일 기준으로 저장소에는 프로덕션용 compose 파일이 포함되어 있지 않습니다. 따라서 장기 운영을 위해서는 직접 systemd 유닛을 작성하거나 저장소에 포함된 각 애플리케이션별 Dockerfile을 사용해야 합니다. api, worker, proxy 앱에는 각각 유닛으로 감싸기 위한 start 스크립트가 있습니다. web 앱은 Vite 기반 애플리케이션이므로 build 스크립트로 빌드한 뒤 nginx나 Caddy를 통해 정적 파일로 서빙하거나, vite preview인 preview 스크립트를 실행해야 합니다.
스팬(span)이 이동하는 경로를 기억하십시오. 아래에서 발생하는 모든 오류는 이 경로의 특정 구간이 끊어졌음을 의미합니다. 애플리케이션은 OTLP 데이터를 Superlog 수신 프록시로 전송합니다. 프록시는 수집 키(ingest key)로 요청을 인증하고 프로젝트 ID를 부여한 뒤 수집기(collector)로 전달합니다. 수집기는 클라이언트가 설정하려 했던 superlog.* 속성을 제거하고, 프록시가 제공한 헤더에서 superlog.project_id을 추가한 뒤, 데이터를 배치 처리하여 ClickHouse에 기록합니다. 이후 web 앱과 API는 ClickHouse에서 텔레메트리 데이터를, 그 외 데이터는 Postgres에서 읽어옵니다.
이러한 속성 제거는 단순한 장식이 아니라 실제 멀티 테넌시 제어 기능입니다. 이 기능이 없다면 유효한 수집 키를 가진 누구나 스스로 superlog.project_id를 설정하여 다른 프로젝트의 데이터 영역에 기록할 수 있습니다.
VPS는 어느 정도 규모가 필요합니까?
수집량이 적은 단일 노드 설치에서는 4 vCPU, 8 GB RAM, 40 GB SSD를 기준으로 계획합니다. 이는 측정값이 아니라 계획을 위한 하한선입니다. 시작 크기로 사용하고 자체 트래픽을 기준으로 다시 확인합니다.
메모리는 네 곳에서 사용합니다. ClickHouse는 RAM이 충분한 장치를 기준으로 설계되었으며 기본값도 이를 전제로 합니다. 여기서 Postgres 16은 텔레메트리가 아니라 메타데이터를 저장하므로 메모리 사용량이 크지 않습니다. collector도 마찬가지입니다. 4개의 Node 프로세스에는 Vite 개발 서버와 3개의 tsx watch 프로세스가 포함됩니다. 자체 서버에서 메모리 사용량을 측정해야 합니다.
디스크는 더 조용한 문제입니다. 이 monorepo의 pnpm install는 span 하나를 수집하기 전에도 AWS SDK, ClickHouse 클라이언트, OpenTelemetry SDK, React 도구 체인을 가져옵니다. 그다음 ClickHouse가 트래픽에 따라 커집니다. 다음 두 항목을 모두 측정합니다.
df -h /
free -m
docker stats --no-stream
docker compose exec clickhouse clickhouse-client --database superlog --query "SELECT table, formatReadableSize(sum(bytes_on_disk)) AS size FROM system.parts WHERE active AND database = 'superlog' GROUP BY table ORDER BY sum(bytes_on_disk) DESC"문제를 일으키는 부하는 burst입니다. 한 번의 잘못된 배포로 분당 수천 개의 동일한 오류가 생성될 수 있습니다. fingerprinting은 독자에게 이러한 오류를 하나의 incident로 묶어 보여 주지만, ClickHouse는 내부적으로 모든 행을 계속 기록합니다.
보존 기간은 직접 설정해야 합니다. collector의 ClickHouse exporter는 테이블, otel_traces, otel_logs 및 metric type별 테이블 하나를 생성합니다. 또한 infra/collector/config.yaml의 설정에서 time to live를 지정한 경우에만 이를 적용합니다. 데이터는 자동으로 만료되지 않습니다. 따라서 이를 계획하지 않으면 트래픽이 많은 한 달 만으로도 디스크가 가득 찰 수 있습니다.
고정된 커밋에서 설치
git clone https://github.com/superloglabs/superlog.git
cd superlog
git tag -l
git log -1 --format='%H %cs %s'git tag -l은 2026년 10월 13일 기준으로 아무것도 출력하지 않는 것이 정상적인 결과다. 테스트한 커밋을 선택하고 해당 커밋을 계속 사용한다.
git checkout 0d3a6c8bb63eda3493e6ba0003e7c2a70750bc1e다음은 toolchain이다.
node -v
corepack enable
corepack prepare pnpm@9.12.0 --activate
pnpm -vpackage.json은 engines.node을 >=20.0.0로, packageManager를 pnpm@9.12.0으로 선언한다. 호환되지 않는 Node 버전이라고 해서 설치가 자동으로 중단되지는 않는다. engine 적용 여부는 설정에 따라 달라지며, pnpm 9.12.0에는 engineStrict이 비활성화된 경우 경고 경로가 있다. Ubuntu 24.04 아카이브의 nodejs 패키지는 20보다 낮은 버전이므로 NodeSource 또는 nvm에서 Node 20 이상을 설치한다. 저장소에는 .nvmrc이 있으므로 nvm을 사용한다면 nvm use이 지정된 버전을 선택한다.
pnpm install
docker compose up -d
docker compose psup -d이 준비 상태를 의미한다고 보고 기다리지 말고 health check가 완료될 때까지 기다린다. Postgres와 ClickHouse는 compose 파일에서 모두 health check를 선언한다.
curl -sS http://127.0.0.1:8123/ping
pg_isready -h 127.0.0.1 -p 5434 -U postgresClickHouse는 Ok.에 응답하고, pg_isready은 accepting connections에 응답한다. 8123에서 connection refused가 발생하면 컨테이너가 아직 시작 중이거나 종료된 것이다. 어느 경우인지 docker compose logs clickhouse로 확인하고, 커널이 메모리 부족으로 프로세스를 종료했다면 docker inspect $(docker compose ps -q clickhouse) | grep -i oomkilled이 true을 보고한다. 이 경우 설정 문제가 아니라 서버 사양이 부족한 것이다.
그다음 migration과 애플리케이션을 처리한다.
pnpm --filter @superlog/db db:migrate
pnpm dev포트에 유의한다. 5432가 아니라 5434다. compose 파일은 호스트에 이미 설치된 Postgres와 충돌하지 않도록 Postgres를 5434에 publish한다. 애플리케이션의 .env.example 파일도 DATABASE_URL=postgres://postgres:postgres@localhost:5434/superlog와 함께 동일한 포트를 사용한다. Postgres가 이미 실행 중인 서버에서 migration을 5432로 지정하면 connection refused가 발생하거나, 더 나쁘게는 잘못된 데이터베이스에 migration이 적용된다.
pnpm dev은 turbo run dev을 실행한다. 이 명령은 Turborepo를 통해 각 애플리케이션의 dev 스크립트를 시작한다. api, web, worker, proxy가 포함되며 출력은 하나의 터미널에 섞여 표시된다. 저장소의 Procfile에는 동일한 4개 프로세스가 지정되어 있고 각 프로세스의 출력은 tmp/logs/에도 기록된다. ingest 출력을 tail -f tmp/logs/proxy.log에서 확인하려면 pnpm dev 대신 overmind나 foreman 같은 Procfile runner로 시작한다. README에는 web 애플리케이션이 http://localhost:5173, API가 http://localhost:4100, OTLP intake가 http://localhost:4101에서 실행된다고 되어 있다.
실제로 어떤 프로세스가 포트를 bind했는지 확인한 다음 연결한다.
ss -lntp | grep -E '4000|4100|4101|5173'
curl -sS http://127.0.0.1:4101/health이 내용은 이후에 중요하다. proxy는 PORT 환경 변수에서 자체 포트를 읽고, PORT이 설정되지 않으면 4000으로 대체한다. proxy가 읽는 apps/proxy/.env.example에도 PORT=4000이 설정되어 있지만 README에는 intake가 4101로 나와 있다. 두 값은 모두 2026년 10월 13일에 확인한 것이다. ss에 표시되는 포트를 사용한다. 아래 예시는 4101을 사용하므로 실제로 bind된 포트가 4000이면 4000으로 바꾼다. 직접 작성한 systemd unit은 PORT을 넣지 않는 한 아무 값도 설정하지 않는다. 따라서 4000에서 listening 중인 proxy에 4101을 대상으로 하는 exporter를 연결하면 connection refused가 발생하며, 다른 단서는 제공되지 않는다.
트레이스 하나를 전송하고, 오류 하나를 만들고, 인시던트 하나를 확인합니다
웹 앱에서 프로젝트를 만들고 ingest key를 복사합니다. intake는 모든 요청을 해당 키로 인증하므로 키 없이 전송된 텔레메트리는 ClickHouse에 도달하지 않습니다.
표준 환경 변수를 사용해 OpenTelemetry SDK를 intake로 지정합니다.
export OTEL_SERVICE_NAME=checkout-api
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4101
export OTEL_EXPORTER_OTLP_HEADERS='x-api-key=YOUR_INGEST_KEY'intake는 x-api-key 헤더에서 키를 읽습니다. exporter를 더 쉽게 구성할 수 있다면 authorization: bearer YOUR_INGEST_KEY도 사용할 수 있습니다. intake는 표준 OTLP 경로 3개인 /v1/traces, /v1/logs, /v1/metrics과 /health을 제공합니다.
한 가지 주의할 점이 있습니다. OTEL_EXPORTER_OTLP_ENDPOINT는 base URL이며 SDK가 여기에 signal 경로를 추가합니다. OTEL_EXPORTER_OTLP_TRACES_ENDPOINT과 같은 signal별 변수는 작성한 그대로 사용되며 경로가 추가되지 않습니다. signal별 변수를 http://127.0.0.1:4101로 설정하면 모든 export가 /로 전송됩니다. 이 주소는 라우트가 아니므로 아무것도 도착하지 않습니다. SDK는 export 실패를 기록하지만 애플리케이션은 정상적으로 보입니다.
Node 서비스에서는 코드를 추가하지 않는 경로만으로도 파이프라인을 확인할 수 있습니다.
npm install @opentelemetry/api @opentelemetry/auto-instrumentations-node
node --require @opentelemetry/auto-instrumentations-node/register server.js이제 일부러 문제를 만듭니다. 오류를 발생시키는 라우트라면 무엇이든 사용할 수 있습니다.
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3000/boom첫 번째 중단 지점이 실패한 위치를 알려 주므로 다음 순서로 각 구간을 확인합니다.
tail -n 50 tmp/logs/proxy.log
docker compose exec clickhouse clickhouse-client --database superlog --query 'SELECT count() FROM otel_traces'웹 앱에 활동이 없는데 otel_traces의 수만 증가한다면 프로젝트가 일치하지 않는 것입니다. ingest key가 어느 프로젝트에 속하는지 확인합니다. proxy 로그에 활동이 있는데 수가 증가하지 않는다면 collector 또는 ClickHouse 쓰기 단계의 문제입니다. docker compose logs collector을 확인합니다. proxy 로그에 활동이 전혀 없다면 exporter가 intake에 도달하지 않은 것입니다. 포트가 잘못되었거나, 경로가 잘못되었거나, 키가 거부된 경우입니다.
웹 앱에서는 이러한 반복 실패가 요청별 행 하나가 아니라 하나의 인시던트로 수집됩니다. Superlog는 들어오는 신호의 fingerprint를 만들고 일치하는 신호를 그룹화합니다. 따라서 받은 편지함에 동일한 오류 4,000개가 쌓이는 대신 페이지에는 하나만 표시됩니다. 기본 community agent runner는 해당 그룹에 대한 로컬 인시던트 요약도 기록합니다.
모델 기반 조사를 수행하려면 model provider와 호환되는 agent runner를 구성해야 합니다. 기본 community runner는 로컬 요약을 기록합니다. 변수 이름은 외부 문서가 아니라 고정한 커밋의 각 애플리케이션 디렉터리에 있는 .env.example 파일에서 확인합니다. 해당 이름은 main에 따라 변경되기 때문입니다. GitHub와 Sentry 통합도 동일합니다. 두 통합은 각각 docs/github-app-setup.md과 docs/sentry-app-setup.md에 자체 설정 문서를 제공하며, webhook payload는 docs/webhooks.md에 문서화되어 있습니다.
인입 경로를 비공개로 유지하고 agent는 읽기 전용으로 설정한다
Docker는 기본적으로 컨테이너 포트를 0.0.0.0에 게시하며, 이렇게 게시된 포트는 ufw를 우회한다. Docker는 nat 테이블에서 컨테이너 트래픽을 라우팅한다. 따라서 게시된 포트로 향하는 패킷은 ufw의 규칙이 있는 INPUT 및 OUTPUT 체인에 도달하기 전에 다른 곳으로 전달되며, ufw는 이를 제어할 수 없다. 공인 IP가 있는 VPS에서는 제공된 compose 파일에 따라 ClickHouse HTTP가 8123에서, Postgres가 5434에서 인터넷에 노출된다. 해당 파일의 자격 증명은 개발 환경용 기본값이다. ClickHouse 사용자는 default이고 비밀번호는 비어 있다. Postgres는 postgres을 사용자 이름과 비밀번호로 모두 사용한다.
loopback에 바인딩한다. compose 파일의 모든 게시 포트는 환경 변수에서 호스트 측 주소를 가져오므로 저장소 루트에 .env 파일을 만들면 충분하다.
POSTGRES_HOST_PORT=127.0.0.1:5434
CLICKHOUSE_HTTP_HOST_PORT=127.0.0.1:8123
CLICKHOUSE_TCP_HOST_PORT=127.0.0.1:9000
COLLECTOR_GRPC_HOST_PORT=127.0.0.1:4317
COLLECTOR_HTTP_HOST_PORT=127.0.0.1:4318신뢰하기 전에 결과를 확인한 다음 컨테이너를 다시 생성한다.
docker compose config
docker compose up -d
ss -lntp | grep -E '5434|8123|9000|4317|4318'docker compose config는 해석된 파일을 출력하므로 추측하지 않고 127.0.0.1:5434:5432을 확인할 수 있다. 그러면 ss에는 127.0.0.1:5434가 표시되고 0.0.0.0:5434은 표시되지 않아야 한다. Compose override 파일에서 ports을 다시 선언하면 호스트 IP가 달라도 두 바인딩이 모두 유지된다. Compose 2.24.4 이상에서는 ports: !override를 사용해 목록을 교체할 수 있다.
인입 경로에도 같은 주의가 필요하다. 인제스트 키가 헤더로 전송되므로 앞단에 TLS(전송 계층 보안)가 필요하다. 프록시 앞에서 nginx 또는 Caddy가 TLS를 종료하게 하거나, 인제스트를 비공개 네트워크 또는 WireGuard 터널 내부에 둔다. 5173에서 실행되는 웹 앱은 Vite 개발 서버이므로 인터넷에 노출해서는 안 된다.
다음은 agent 자체다. Superlog의 핵심은 agent가 조사하고 수정안을 제안한다는 것이다. 여기서 중요한 단어는 제안이다. 실제 장애 몇 건에서 동작을 확인할 때까지는 production에 대해 읽기 전용으로 유지한다. 읽기 전용 GitHub App은 수정 브랜치를 push하거나 pull request를 열 수 없다. 해당 작업 흐름에는 설정 안내서에 Contents 및 Pull requests 쓰기 권한이 필요하고, 댓글에는 Issues 쓰기 권한도 필요하다. 텔레메트리를 읽고 패치를 작성하는 agent는 유용하다. 서비스를 재시작할 수 있는 agent는 위험 수준이 다르다. 이 권한은 기본값으로 상속할 것이 아니라 의도적으로 결정해야 한다. 모델 기반 runner를 구성할 때는 비용도 같은 수준으로 주의해야 한다. 시끄러운 production 시스템에 연결하기 전에 VPS에서 agent 비용 예산을 책정한다. 또한 agent가 실제로 수행한 작업을 기록한다를 유지하여 예상하지 못한 pull request에도 감사 추적을 남긴다.
발생할 오류와 이를 식별하는 문자열
pnpm install중ERR_PNPM_UNSUPPORTED_ENGINE가 발생하면 엔진 요구 사항이 호환되지 않는다는 의미다. pnpm 9.12.0은 Node와 pnpm 요구 사항을 모두 확인한다. 오류 메시지에서 요구 버전과 현재 버전을 확인한 다음node -v및pnpm -v를 확인한다.- 마이그레이션 중
ECONNREFUSED 127.0.0.1:5434가 발생하면 compose 스택이 실행 중이 아니거나DATABASE_URL에 잘못된 포트가 지정된 것이다. docker compose logs clickhouse로 ClickHouse가 재시작되는지 확인한 다음, 컨테이너에서OOMKilled가true인지 확인한다.- 웹 애플리케이션이 계속 비어 있는데 exporter가 성공을 보고한다면, 데이터가 4318의 collector로 직접 전송되었을 가능성이 높다. 그러면 프록시가 수행하는 프로젝트 식별자 주입이 생략된다.
- 4101에서 연결이 거부되면 일반적으로 프록시가 4000에서 수신 대기 중이라는 뜻이다. 4000은 해당 코드의 기본값이며
.env.example가 설정하는 포트다. unit 파일 또는 애플리케이션의.env에PORT를 명시적으로 설정한다. docker compose ps에0.0.0.0:8123가 표시되면 loopback 바인딩이 적용되지 않은 것이다.docker compose config을 실행하고 확인된 포트를 읽는다.
Flawless, HyperProbe, 그리고 Superlog의 위치
이 범주는 아직 초기 단계이며, 에이전트가 접근할 수 있는 범위에 따라 도구가 나뉜다. Flawless 저장소는 현재 PolyForm Noncommercial 라이선스에 따라 Kubernetes 및 클라우드 인프라를 위한 AI SRE(site reliability engineering) 플랫폼인 CISRE를 제공한다. HyperProbe는 실행 중인 프로세스 내부에 probe를 배치해 변수 상태를 수집하고, MCP(model context protocol)를 통해 해당 상태를 assistant에 노출한다. 또한 Docker Compose와 license key를 사용한 self-hosting 방법도 문서화한다.
Superlog는 두 도구의 중간에 있다. OTLP 수집부터 ClickHouse 저장까지 전체 pipeline을 담당하며, agent를 수정 단계가 아니라 triage 단계에 배치한다. 이러한 설계 때문에 Superlog를 self-hosting하는 일은 단순히 실행해 두고 잊는 container 운영이 아니라 인프라 운영 결정이다. Superlog를 실행하면 column store도 운영하게 되며, 직접 운영하는 다른 database와 동일한 수준으로 관리해야 한다.
FAQ
자체 호스팅한 Superlog에는 RAM이 얼마나 필요한가?
수집량이 적은 단일 노드라면 RAM 8 GB, vCPU 4개, 디스크 40 GB를 기준으로 계획한다. 이 스택은 Postgres, ClickHouse, OpenTelemetry collector, Node 프로세스 4개로 구성되며, ClickHouse에는 여유 리소스가 필요하다. 게시된 수치를 그대로 신뢰하지 말고 이 수치를 포함해 docker stats --no-stream 및 free -m로 직접 측정한다.
OTLP exporter는 어느 포트로 지정해야 하는가?
README에서 http://localhost:4101에 배치하는 Superlog intake proxy를 지정한다. 이 프록시는 /v1/traces, /v1/logs 및 /v1/metrics을 제공하며, x-api-key 헤더 또는 authorization: bearer 헤더에서 가져온 프로젝트의 ingest key로 인증한다. 포트 4318은 그 아래에서 실행되는 OpenTelemetry collector의 포트다. 이 포트로 직접 내보내면 데이터를 프로젝트 ID와 연결하는 proxy를 건너뛰게 된다. PORT이 설정되지 않으면 proxy는 포트 4000으로 대체되며, 해당 .env.example도 4000으로 설정한다. 따라서 4101이라고 가정하기 전에 ss -lntp을 실행해 실제로 어느 포트에 바인딩되었는지 확인한다.
Superlog가 Uptime Kuma 또는 Zabbix를 대체하는가?
아니다. Uptime Kuma는 네트워크 외부에서 엔드포인트가 응답하는지 확인하고, Zabbix는 설정한 임계값을 기준으로 호스트 및 서비스 메트릭을 모니터링한다. Superlog는 애플리케이션이 생성하는 trace, log, metric을 수집하고 반복되는 장애를 incident로 그룹화한다. 외부 uptime probe도 함께 유지한다. 다른 위치에서 실행되는 probe가 있어야 telemetry pipeline을 실행하는 서버 자체가 중단된 경우에도 이를 보고할 수 있다.
Superlog agent가 운영 시스템을 변경할 수 있는가?
부여한 권한의 범위에서만 가능하다. 기본 community runner는 로컬 incident 요약을 기록한다. 다른 조사 runtime의 동작은 구성한 runner에 따라 달라진다. 운영 자격 증명은 읽기 권한으로 제한한다. pull request를 열려면 branch와 pull request에 대한 별도의 GitHub 쓰기 권한이 필요하다. 운영 환경에 대한 쓰기 권한 부여는 별도의 결정으로 신중하게 처리한다. 서비스를 재시작할 수 있는 agent는 telemetry를 읽고 검토용 patch를 작성하는 agent보다 훨씬 큰 권한을 요구한다.
commit을 고정해야 하는가, 아니면 main을 추적해야 하는가?
commit을 고정한다. 13 October 2026 기준으로 repository에는 release tag가 없었다. 테스트한 SHA를 기록하고 해당 버전을 배포한다. 이후 업데이트하기 전에 diff를 검토한다. git log --oneline <old-sha>..main는 검토 대상이며, 앱별 .env.example 파일은 bump 후 새로 필요한 변수를 확인할 때 가장 먼저 살펴볼 위치다.