MonstarX에서 Sentry 사용하기

핵심 요약읽기 권한이 있는 Sentry 개인 토큰을 만들어 백엔드 → 클라우드의 Sentry 행에 붙여 넣으세요. 그러면 MonstarX 에이전트가 조직과 프로젝트를 조회하고, 이슈를 검색하고, 이슈 하나를 자세히 읽을 수 있습니다. “가장 많이 발생한 Sentry 오류를 고쳐 주세요”라고 요청하면 됩니다. 읽기만 합니다.

Sentry 프로젝트의 오류와 이슈를 읽습니다.

유형: 업무 도구 · API 키
카테고리: 분석과 모니터링
연결 방법: API 키

Sentry는 소프트웨어에서 일어나는 오류와 크래시를 기록하고 이슈 단위로 묶어 주는 서비스입니다. 토큰(소프트웨어가 내 Sentry 계정을 읽을 수 있게 해 주는, 비밀번호 같은 코드)으로 연결하면 MonstarX 에이전트(대화를 나누는 AI)가 작업하면서 이슈를 읽을 수 있습니다. 스택 트레이스를 대화에 일일이 복사해 넣지 않아도, 실제 사용자에게 어떤 문제가 생기는지 보고 바로 고칠 수 있습니다.

이 커넥터는 업무 도구입니다. MonstarX가 사용자를 대신해 Sentry를 읽습니다. 만드는 앱에는 토큰이 전달되지 않습니다.

MonstarX는 무엇을 할 수 있나요?

MonstarX가 할 수 있는 일	언제
조직 목록 보기	모든 모드
조직의 프로젝트 목록 보기	모든 모드
조직의 이슈 검색: Sentry 검색어(예: `is:unresolved`)를 쓰고, 특정 프로젝트로 좁힐 수도 있습니다.	모든 모드
이슈 하나 자세히 읽기	모든 모드

다음 작업은 하지 않습니다: 이슈 해결 처리·담당자 지정·무시·삭제, 알림이나 프로젝트 설정 변경, Sentry로 무언가 보내기.

시작하기 전에

sentry.io의 Sentry 계정이 필요합니다. 셀프 호스팅 Sentry 서버는 지원하지 않습니다. MonstarX는 sentry.io하고만 통신합니다.
MonstarX 프로젝트의 소유자여야 합니다. 도구를 연결하거나 연결 해제할 수 있는 사람은 소유자뿐입니다.

토큰 발급받기

Sentry에서 User settings > Personal Tokens를 열고 새 토큰을 만드세요.
읽기 권한 org:read(연결할 때 MonstarX가 확인), project:read, event:read를 주세요.
저장하고 토큰을 복사하세요.

Sentry 공식 가이드: Authentication, Permissions & scopes

MonstarX에서 연결하기

프로젝트를 열고 상단 바에서 백엔드를 클릭한 다음 클라우드를 클릭하세요.
커넥터까지 스크롤해 Sentry를 찾고 연결을 클릭하세요.
API 키 입력란에 토큰을 붙여 넣고 연결을 클릭하세요.
MonstarX가 조직 목록을 조회해 토큰을 확인합니다. 확인되면 행에 연결됨이 표시됩니다. 토큰이 거부되면 오류 메시지가 표시되고, 아무것도 저장되지 않습니다.

MonstarX에 사용 요청하기

입력 예시	결과
“내 Sentry 프로젝트 ‘booking-web’에서 해결되지 않은 주요 이슈는 무엇인가요?”	MonstarX가 이슈를 검색해 대화에 목록으로 보여 줍니다.
“Sentry 이슈 4512를 읽고 고쳐 주세요.”	이슈의 세부 정보를 읽고, 만들기 모드에서 원인이 되는 앱 코드를 고칩니다.
“내 Sentry 프로젝트는 무엇이 있나요?”	조직과 각 조직의 프로젝트 목록을 보여 줍니다.

보안과 개인정보 보호

MonstarX에만 보관됩니다. 토큰은 암호화되어 MonstarX 서버에 저장됩니다. 앱 코드에 기록되거나 앱에 전달되는 일은 없습니다.
읽기 전용입니다. MonstarX는 읽기만 합니다. 토큰에 읽기 권한만 주면 토큰이 유출되더라도 Sentry의 어떤 것도 바꿀 수 없습니다.
정보로만 읽습니다. 오류 메시지와 이벤트 데이터는 참고할 정보로만 다루고, 지시로 따르지 않습니다.
언제든 연결 해제할 수 있습니다. 백엔드클라우드에서 Sentry 옆의 연결 해제를 클릭하고 이 프로젝트에서 Sentry 연결을 해제할까요?를 확인하세요. MonstarX는 토큰을 삭제합니다. 더 이상 필요 없다면 Sentry에서도 토큰을 폐기하세요.

알아 두면 좋은 점

개인 토큰은 내 권한으로 작동하므로, MonstarX는 내가 볼 수 있는 조직과 프로젝트를 봅니다.
요청할 때 조직이나 프로젝트 이름을 알려 주면 MonstarX가 한 단계를 건너뛸 수 있습니다.
MonstarX에서 만들고 있는 앱의 오류라면 Sentry가 필요 없을 수도 있습니다. MonstarX는 앱 자체의 로그를 읽을 수 있습니다.

자주 묻는 질문

MonstarX가 Sentry 이슈를 해결 처리하거나 담당자를 지정할 수 있나요?

아니요. 조직과 프로젝트 목록 보기, 이슈 검색, 이슈 읽기만 할 수 있습니다. 수정 사항이 게시되면 Sentry에서 직접 이슈를 해결됨으로 표시하세요.

셀프 호스팅 Sentry에서도 작동하나요?

아니요. 이 연결은 sentry.io하고만 통신합니다.

앱의 오류를 Sentry로 보고하게 할 수 있나요?

그건 이 연결과는 다른 기능입니다. MonstarX에 앱에 Sentry 오류 보고를 추가해 달라고 요청하세요. 프로젝트의 DSN이나 키를 물어볼 텐데, 이 값은 백엔드 → 시크릿에 넣습니다. 시크릿으로 API 키 안전하게 보관하기를 참고하세요.