Archynt 작동 방식
하나의 그래프, 여덟 가지 기능 — 정적 분석부터 실시간 토폴로지, 로그, 커스텀 메트릭 대시보드, 알림, AI 기반 인사이트, 자동 PR 체크, 퍼블릭 리포지토리용 무료 GitHub Action까지.
프로젝트
모든 코드베이스를 살아있는 아키텍처로 이해하세요. Archynt는 Java, Node, Python, Go를 파싱해 자동으로 그래프를 구성합니다.
런타임
읽기 전용 에이전트가 서비스, 의존성, 호스트 부하를 실시간으로 탐지합니다 — 계측 없이. 현재는 Docker를 지원하며, Kubernetes와 systemd가 다음 순서입니다.
메트릭
Prometheus 메트릭으로 Grafana 스타일의 대시보드를 구성하세요. 자유로운 PromQL, 임계값 설정, 조직별 패널을 지원합니다.
AI 인사이트
LLM이 정적 또는 실시간 아키텍처 그래프를 추론해 결합도 문제와 god-service를 탐지하고, 근거와 구체적인 해결책을 함께 제시합니다.
로그
Docker에서 직접 컨테이너 로그를 읽습니다. 시간 범위와 레벨로 필터링하고, 검색과 실시간 tail을 지원하며 — 별도의 로그 전송 파이프라인을 유지할 필요가 없습니다.
알림
CPU 급증, RAM 압박, 에러율 이상, 컨테이너 다운이 발생하면 자동으로 알림이 발생합니다 — 팀에 이메일로 전송되며, 별도의 임계값 설정이 필요 없습니다.
PR 체크
모든 pull request는 main과 비교 분석되어 GitHub에 check run으로 게시됩니다 — 새로운 설계 문제가 발견되면 머지 전에 체크가 실패합니다.
GitHub Action
퍼블릭 리포지토리에 워크플로우를 추가하면 모든 PR에서 동일한 아키텍처 체크를 받을 수 있습니다 — Archynt 계정도, 토큰 공유도 필요 없습니다.
자주 묻는 질문
Archynt는 Datadog, Grafana, Dynatrace와 무엇이 다른가요?
이런 플랫폼들은 메트릭, 로그, 트레이스 같은 텔레메트리를 기반으로 "지금 무슨 일이 일어나고 있는가"에 답합니다. Archynt는 전혀 다른 질문에 답합니다: "실제로 운영 중인 시스템이 코드가 설명하는 시스템과 일치하는가?" Archynt는 소스 코드를 구조적 그래프로 파싱하고, 이를 읽기 전용 런타임 에이전트와 상관 분석한 뒤, 모든 의존성을 정적/런타임/양쪽으로 태깅합니다. 팀이 이미 보유한 Prometheus 메트릭을 흡수해 이 그래프를 보강할 수는 있지만, 텔레메트리 저장소로서 경쟁하지는 않습니다 — Archynt의 핵심 가치는 대시보드가 아니라 아키텍처 그래프와 그에 대한 추론입니다.
Archynt가 제 소스 코드를 볼 수 있나요?
정적 분석은 리포지토리를 파싱해 클래스, 모듈, 엔드포인트와 그 관계를 그래프로 추출합니다 — 코드 텍스트 자체를 저장을 위해 제3자에게 전송하지 않습니다. 런타임 에이전트는 읽기 전용이며 관찰 대상 시스템에서 어떤 것도 수정하거나 실행하지 않습니다.
아키텍처 드리프트란 무엇인가요?
드리프트는 한쪽 레이어에는 존재하지만 다른 쪽에는 존재하지 않는 의존성을 말합니다: 실제 트래픽에서 관찰됐지만 어떤 코드 경로에도 문서화되지 않은 서비스 간 호출, 또는 코드에 선언되어 있지만 런타임에서 실제로 실행된 적 없는 의존성(데드 코드 후보)입니다. Archynt가 모든 엣지에 부여하는 confirmed_by 태그 — static, runtime, 또는 both — 가 애초에 드리프트를 탐지 가능하게 만드는 핵심입니다.
Archynt는 어떤 언어와 프레임워크를 분석하나요?
현재는 Java/Spring, Node/NestJS, Python, Go를 지원하며, 동일한 그래프 모델 뒤에서 언어별 전용 워커가 동작합니다. 동일한 워커 계약을 확장하는 방식으로 새로운 언어를 추가합니다.
애플리케이션을 계측해야 하나요?
아니요. 런타임 에이전트는 Docker API와 /proc을 기반으로 서비스, 컨테이너, 의존성을 실시간으로 탐지합니다 — SDK도, 사이드카도, 코드 변경도 필요 없습니다. RED 메트릭(rate, errors, duration)은 eBPF 센서(Beyla)에서 제공되며, 이 역시 애플리케이션 코드를 건드리지 않습니다.
코딩 AI 에이전트가 Archynt를 직접 사용할 수 있나요?
네. Archynt는 MCP 서버를 제공하여 Cursor나 Claude Code 같은 도구가 실제 아키텍처 그래프를 조회하고, 열려 있는 설계 문제 목록을 확인하며, 코드를 생성하기 전에 제안된 변경이 아키텍처 경계를 침범하는지 검증할 수 있게 합니다. 기계가 읽을 수 있는 설명은 /llms.txt와 /.well-known/mcp.json에서 확인할 수 있습니다.
Archynt가 pull request를 자동으로 검토하나요?
네. 리포지토리에 GitHub App을 설치하면 모든 pull request마다 체크가 실행됩니다: Archynt는 base 커밋과 head 커밋 각각의 아키텍처 그래프를 구성하고, 둘 사이의 설계 문제를 비교합니다. PR이 HIGH 심각도의 새로운 문제를 유발하면 체크가 실패하며, 어떤 문제가 새로 생기거나 해결됐는지를 포함한 결과가 GitHub에 네이티브 check run으로 게시됩니다. 이 체크는 결정론적으로 동작하며, LLM 호출이 아니라 Archynt 전반에서 사용하는 것과 동일한 탐지기를 사용합니다.