サポート
アカウントの接続
トークンの作成
- Sentryで User settings → Personal Tokens (セルフホストでは相当するトークン設定)を開き、新しいトークンを作成します。
-
スコープを選びます。閲覧のみなら
org:read・project:read・event:read。アプリからトリアージするならevent:write(解決・アーカイブ・担当)とmember:read(担当者の候補表示)を追加します。 - トークンをコピーしてTracebellの接続画面に貼り付けます。スコープは作成後に変更できないため、足りなかった場合は新しいトークンを作成してください。
セルフホストのサーバー
接続画面で「セルフホスト」を選び、サーバーのURLを入力します。sentry.ioと同じAPIパスを使用します。サーバーには、お使いのiPhoneからHTTPSで(直接またはVPN経由で)到達できる必要があります。
よくあるトラブル
- 貼り付けた直後に「トークンが無効」 — 途中で切れていないか、余分な空白が入っていないか確認してください。トークンはかなり長い文字列です。セルフホストの場合は、URLのホスト名の後ろにパスが付いていないかも確認を。
- 解決・担当のボタンが押せない — トークンに
event:writeまたはmember:readがありません。これらのスコープを付けた新しいトークンを作成してください。 - 使えていたのに急に動かなくなった — トークンが失効したか、組織のメンバーシップが変わった可能性が高いです。新しいトークンで接続し直してください。
- 一覧が遅い・更新が止まる — SentryのAPIにはエンドポイントごとのレート制限があります。アプリは自動で間隔を空け、制限が解除されると再開します。
プッシュ通知
無料プランでは、登録した端末に新規イシューの毎日のダイジェスト(日本時間7:00ごろ / UTC 22:00ごろ)が届き、週間サマリーは登録したすべての端末に届きます。Tracebell Advancedでは、毎日のダイジェストの代わりに全イベント(作成・再発・解決など)が即時に届き、絞り込みも使えます。設定の手順はどちらも同じです。
- Tracebellで プロフィール → 通知 を開き、通知を有効にする をタップして通知を許可します。
- プッシュ通知を設定 をタップします。Sentryで Settings → Developer Settings → Custom Integrations を開き、Internal Integration を作成します(権限は Issue & Event を「Read」にし、 それ以外はすべて「No Access」。issue の Webhook を購読するために Sentry が必須としています。Alert Rule Action をオンにし、Webhook で issue イベントを購読)。
- インテグレーションの Client Secret をコピーしてアプリに貼り付け、この端末を登録 をタップします。自分専用のWebhook URLが表示されます。
- そのURLをSentry側の Webhook URL 欄に貼り付けて保存します。必要に応じてアラートルールに「Send a notification via Tracebell」を追加します。
- アプリに戻ってテスト通知を送ります。Advancedでは即時通知するイベント種別を選べるほか、対象を選んだプロジェクト(最大50件)と最低レベル(Info・Warning・Error・Fatal)に絞り込めます。
Internal Integrationの作成には、通常、組織のAdmin・Manager・Ownerいずれかのロールが必要です。Memberの場合は組織のオーナーに設定を依頼するか、プッシュなしでアプリをご利用ください。
プライバシーについて: 中継はSentryのトークンを一切保持しません。イシューのタイトルも保存せず、通知を届けるためにAppleのプッシュサービスへ渡すだけです。詳しくはプライバシーポリシーをご覧ください。
絞り込みの仕組み
- 絞り込みは即時プッシュとLive Activityの自動開始に適用されます。毎日のダイジェスト(無料プラン)と週間サマリーはすべての新規イシューを数え、ロック画面でフォロー中のイシューも絞り込みの対象外です。
- メトリクスアラートはプロジェクトだけで絞り込みます。Sentryがイベントのプロジェクトやレベルを示さない場合は、捨てずに配信します。
Live Activity(Advanced)
未解決のイシューを開き、ロック画面でフォローをタップします。Live Activityはイシューのフェーズ・イベント数・ユーザー数・アラート数・最終発生をロック画面とDynamic Islandに表示します。イシューが解決またはアーカイブされると終わり、いつでもフォローをやめられます。
- バックグラウンドでの更新はプッシュ中継を経由するため、そのイシューの組織で通知を設定(上記)しておく必要があります。更新は一定間隔ではなく、Sentryからそのイシューの Webhookが届いたときに行われます。イシューのアラートルールに「Send a notification via Tracebell」を追加すると、更新の頻度が上がります。通知を設定していない場合は、Tracebellを開いている間だけ更新され、30分後に「Tracebellを開いて更新」と表示されます。
- 自動での再開: フォロー中のイシューが再発するかアラートが発生すると、Live Activityがもう一度始まります。
- 強制終了したとき: Appスイッチャーでアプリを上にスワイプして終了した場合や、低電力モードがオンのとき、TracebellのAppのバックグラウンド更新がオフのときは、iOSの制限によりバックグラウンドでLive Activityを開始したり、更新用トークンを中継に送ったりできないことがあります。その場合、始まったLive Activityは通知を設定していても30分後に「Tracebellを開いて更新」と表示されます。Tracebellを開くと更新が再開します。
- 自動で開始(プロフィール → 通知。初期設定はオフ): 通知対象のプロジェクトで最低レベル以上のイシューが再発すると、Live Activityを自動で開始できます。ただし、TracebellのLive Activityが実行中でないときに限ります。
- 制限: 同時に実行できるLive Activityは3つまでで、4つ目をフォローすると最も長く更新されていないものが終わります。バックグラウンドで開始できる頻度はiOSが決め、中継からの開始も1時間に4回までのため、開始されないことがあります。iOSはLive Activityを8時間で終了します。
- 表示されない場合は、iOSの設定アプリでTracebellのLive Activityがオンになっているか確認し、プロフィール → 通知のテスト用のLive Activityを送信をタップしてiPhoneをロックしてください。約10秒でテスト用のLive Activityが表示されます。
- デモモードでもサンプルのイシューをフォローでき、アプリを開いている間はサンプルの更新が流れます。
アプリアイコン(Advanced)
プロフィール → 外観 → アプリアイコンを開き、ペーパー・モノ・シグナル・アンバー・ミントから選びます。クラシックはいつでも使えます。変更のたびにiOSが短い確認を表示します。Advancedがない場合やデモモードでは、アイコンをタップするとプレビューが表示され、ホーム画面のアイコンは変わりません。Advancedが終了しても、選んだアイコンはクラシックに戻すまでそのままです。
購入について
- プラン: Tracebell Advancedは月額(¥500 / $2.99)、年額(¥4,000 / $24.99、14日間の無料トライアル付き)、買い切り(¥9,700 / $99.99)から選べます。アプリ内の投げ銭(チップ)は開発の応援用で、機能は増えません。
- 復元: プロフィール → プラン → 購入を復元(同じAppleアカウントでご利用ください)。
- 解約: サブスクリプションの管理はアプリ内ではなく、App Storeのアカウント設定から行います。
- 返金はAppleが reportaproblem.apple.com で受け付けています。
機能要望・バグ報告
[email protected] まで、「期待した動作」と「実際の動作」を添えてお送りください。スクリーンショットがあると助かりますが、機密情報は事前にぼかしてください。