Tracebell은 비공식 클라이언트입니다. Sentry(Functional Software, Inc.)와 제휴 관계가 없습니다.

지원

연결, 알림, 실시간 현황, 구매에 관한 도움말

개발자에게 가장 빠르게 연락하는 방법은 이메일([email protected])입니다. 앱 버전(프로필 → 정보)을 함께 적어 주시고, 연결 문제라면 sentry.io와 자체 호스팅 서버 중 무엇을 사용하는지도 알려 주세요. 인증 토큰은 절대 이메일에 포함하지 마세요.

계정 연결

토큰 만들기

  1. Sentry에서 User settings → Personal Tokens(자체 호스팅에서는 이에 해당하는 인증 토큰 설정)를 열고 새 토큰을 만드세요.
  2. 스코프를 선택하세요. 조회만 하려면 org:read, project:read, event:read가 필요합니다. 앱에서 이슈를 처리하려면 event:write(해결, 보관, 담당자 지정)와 member:read(담당자 선택)를 추가하세요.
  3. 토큰을 복사해 Tracebell의 연결 화면에 붙여넣으세요. 스코프는 토큰을 만든 후에는 변경할 수 없습니다. 스코프를 부족하게 골랐다면 새 토큰을 만드세요.

자체 호스팅 서버

연결 화면에서 ‘자체 호스팅’을 선택하고 서버 URL을 입력하세요. 앱은 sentry.io와 같은 API 경로를 사용합니다. 서버는 iPhone에서 직접 또는 VPN을 통해 HTTPS로 접근할 수 있어야 합니다.

자주 발생하는 문제

푸시 알림

무료 플랜에서는 등록된 기기로 새 이슈의 일일 요약(한국 시간 오전 7시경 / UTC 22:00경)이 전송되고, 등록된 모든 기기는 주간 요약을 받습니다. Tracebell Advanced에서는 일일 요약 대신 모든 이벤트(생성, 재발, 해결)가 실시간으로 전송되고 필터를 사용할 수 있습니다. 설정 방법은 두 경우 모두 같습니다.

  1. Tracebell에서 프로필 → 알림을 열고 알림 켜기를 탭한 다음 알림을 허용하세요.
  2. 푸시 알림 설정을 탭하세요. Sentry에서 Settings → Developer Settings → Custom Integrations를 열고 Internal Integration(내부 통합)을 만드세요. Issue & Event를 Read로 설정하고(이슈 웹훅을 구독하려면 Sentry에서 필요합니다) 나머지 권한은 모두 “No Access”로 둔 다음, Alert Rule Action을 켜고 웹훅에서 issue 이벤트를 구독하세요.
  3. 통합의 Client Secret을 복사해 앱에 붙여넣고 이 기기 등록을 탭하세요. 그러면 앱에 나만의 웹훅 URL이 표시됩니다.
  4. 이 URL을 Sentry 통합의 Webhook URL 칸에 붙여넣고 저장하세요. 원한다면 알림 규칙에 “Send a notification via Tracebell” 작업을 추가하세요.
  5. 앱으로 돌아와 테스트 알림을 보내세요. Advanced에서는 실시간으로 알림 받을 이벤트 유형을 선택하고, 원한다면 선택한 프로젝트(최대 50개)와 최소 레벨(Info, Warning, Error, Fatal)로 범위를 좁힐 수 있습니다.

Internal Integration을 만들려면 보통 조직의 Admin, Manager 또는 Owner 역할이 필요합니다. Member라면 Owner에게 설정을 부탁하거나 푸시 없이 앱을 사용하세요.

개인정보 관련 안내: 중계 서버는 Sentry 토큰을 보관하지 않으며 이슈 제목도 저장하지 않습니다. 이슈 제목은 알림을 전달하기 위해 중계 서버를 거쳐 Apple의 푸시 서비스로 넘어갈 뿐입니다. 개인정보 처리방침을 참고하세요.

필터 작동 방식

실시간 현황(Advanced)

미해결 이슈를 열고 잠금 화면에서 팔로우를 탭하세요. 실시간 현황은 이슈의 상태, 이벤트, 사용자, 알림 수와 최근 발생 시점을 잠금 화면과 Dynamic Island에 표시합니다. 이슈가 해결되거나 보관되면 종료되며, 언제든지 팔로우를 중지할 수 있습니다.

앱 아이콘(Advanced)

프로필 → 화면 모드 → 앱 아이콘을 열고 페이퍼, 모노, 시그널, 앰버, 민트 중에서 고르세요. 클래식은 언제든지 사용할 수 있습니다. 변경할 때마다 iOS가 짧은 알림으로 확인합니다. Advanced가 없거나 데모 모드인 경우에는 아이콘을 탭하면 미리 보기가 표시되고 홈 화면 아이콘은 바뀌지 않습니다. Advanced가 종료되어도 선택한 아이콘은 클래식으로 되돌릴 때까지 유지됩니다.

구매

기능 요청 및 버그 신고

기대한 동작과 실제로 일어난 일을 적어 이메일([email protected])로 보내 주세요. 스크린샷이 있으면 도움이 됩니다. 다만 민감한 내용은 먼저 가려 주세요.

Tracebell은 독립적인 비공식 클라이언트이며 Functional Software, Inc.와 제휴 관계가 없습니다. Sentry 자체에 관한 문제(계정, 결제, 데이터)는 Sentry 지원팀에 문의하세요.