프로젝트 및 API 키
가입하고, 프로젝트를 생성하고, API 키를 관리하고, 환경을 분리하세요.
프로젝트 및 API 키
JamJet Cloud는 모든 텔레메트리, 거버넌스, 승인 데이터를 프로젝트 단위로 구성합니다. 프로젝트는 논리적 경계입니다. 모든 스팬, 정책 결정, 예산 제한, 감사 이벤트는 정확히 하나의 프로젝트에 속합니다. API 키는 프로젝트에 대한 접근 권한을 부여하며, SDK가 필요로 하는 유일한 인증 정보입니다.
가입하기
app.jamjet.dev에서 무료 계정을 생성하세요. 신용카드는 필요하지 않습니다. 무료 티어는 텔레메트리, 거버넌스, 감사 추적, 네트워크 그래프를 포함한 전체 대시보드에 즉시 접근할 수 있으며, 롤링 보존 기간이 제공됩니다.
가입 후 프로젝트 화면으로 이동하여 첫 번째 프로젝트를 생성할 수 있습니다.
프로젝트
프로젝트는 JamJet Cloud에서 모든 것을 그룹화하는 최상위 단위입니다. 일반적인 패턴:
- 서비스당 하나의 프로젝트. 추론 API, 백그라운드 작업 실행기, 내부 채팅 도구가 각각 자체 프로젝트를 가집니다. 스팬은 분리되고, 비용은 개별적으로 집계되며, 정책은 독립적으로 범위가 지정됩니다.
- 환경당 하나의 프로젝트. 단일 서비스가
my-app-dev,my-app-staging,my-app-prod프로젝트를 가집니다. 개발 트래픽을 프로덕션 감사 로그에서 분리하는 가장 간단한 방법입니다. - 팀당 하나의 프로젝트. 거버넌스 소유권이 팀별로 다른 대규모 조직에서 유용합니다. 각 팀은 자체 정책, 예산, 멤버 명단을 관리합니다.
프로젝트는 계층적이지 않습니다. 하위 프로젝트나 워크스페이스는 없습니다. 프로젝트 간 비용 집계가 필요한 경우 각 프로젝트에서 스팬을 내보내 외부에서 집계하거나, 프로세스 컨텍스트를 통해 설정된 스팬별 environment 및 service 태그를 사용할 수 있습니다.
API 키
API 키는 SDK를 JamJet Cloud에 인증합니다. 각 키는 정확히 하나의 프로젝트에 범위가 지정됩니다. 설정 → API 키에서 프로젝트 내부에 생성할 수 있습니다. 키는 jj_xxxxxxxxxxxx 형식입니다.
키는 생성 시 단 한 번만 표시됩니다. 즉시 복사하여 저장하세요. 분실한 경우 새 키를 생성하고 기존 키를 폐기하세요.
환경별 분리
환경을 분리하는 가장 신뢰할 수 있는 방법은 환경마다 전용 키를 생성하여 각각 다른 프로젝트를 가리키도록 하는 것입니다(또는 동일한 프로젝트 — SDK는 environment를 스팬 속성으로 전송하지만, 별도 프로젝트를 사용하면 더 깔끔한 필터링과 독립적인 보존 설정을 얻을 수 있습니다).
일반적인 설정:
JAMJET_API_KEY_DEV→my-app-dev프로젝트JAMJET_API_KEY_STAGING→my-app-staging프로젝트JAMJET_API_KEY_PROD→my-app-prod프로젝트
각 배포 대상에서 환경 변수를 통해 적절한 키를 설정하세요. SDK는 기본적으로 JAMJET_API_KEY를 읽거나, init() / configure() 시점에 명시적으로 전달할 수 있습니다.
다운타임 없는 키 교체
키를 안전하게 교체하는 과정은 세 단계입니다:
- 설정 → API 키에서 새 키를 생성합니다. 새 키는 즉시 활성화됩니다.
- 환경에 새 키를 배포합니다. 플릿이 완전히 재시작될 때까지 기존 키와 새 키가 동시에 사용됩니다 — 둘 다 유효합니다.
- 실행 중인 모든 인스턴스가 새 키를 적용했음을 확인한 후 설정 → API 키에서 기존 키를 폐기합니다. 폐기는 즉시 적용됩니다.
3단계 이전에 기존 키를 폐기하지 마세요. 부분 롤아웃, 카나리 배포, 점진적 재시작 모두 중복 기간을 허용합니다.
멤버 및 역할
프로젝트 멤버는 설정 → 멤버에서 관리됩니다. 이메일로 팀원을 초대할 수 있습니다. 역할 할당은 프로젝트 내에서 멤버가 볼 수 있고 수행할 수 있는 작업을 제어합니다:
- Owner — 프로젝트 삭제 및 결제 설정을 포함한 모든 권한.
- Admin — 결제 및 프로젝트 삭제를 제외한 모든 권한. 멤버를 관리할 수 있습니다.
- Member — 모든 텔레메트리를 조회하고, 승인 요청에 대응하며, 거버넌스(정책, 예산, 에이전트)를 관리할 수 있습니다. 멤버를 관리할 수 없습니다.
- Read-only — 텔레메트리와 감사 추적을 조회할 수 있습니다. 요청을 승인하거나 거버넌스 설정을 변경할 수 없습니다.
역할 이름과 정확한 권한은 대시보드가 발전함에 따라 변경될 수 있습니다. 현재 정의는 프로젝트의 설정 → 멤버 페이지를 참조하세요.
최소 Member 역할을 가진 모든 팀원은 대기 중인 승인 요청을 승인하거나 거부할 수 있습니다 — 별도의 승인자 역할은 없습니다. 승인 권한을 제한해야 한다면, 관찰자에게는 Read-only를, 승인을 신뢰할 수 있는 사람에게만 Member를 사용하세요.