エージェントのワークフローでは
--json を追加します。確認が失敗すると、安定した next フィールドが返されます。簡単な確認から始める
最初のテレメトリが届かないときに回復する
SDK の設定を変える前に、次の読み取り専用のコマンドを実行します。logbrew doctor は、API へのアクセス、認証、プロジェクト、取り込みキー、設定、テレメトリ、ログの表示を確認します。プロジェクトは変更しません。全体の status と各チェックを、doctor レポートで読みます。終了コードが 0 でも、すべての確認に合格したとは限りません。
レポートのステータスは、
auth_invalid、project_missing、api_unreachable、check_failed になることもあります。それぞれの次のステップは doctor レポートにあります。
シグナルの種類はそれぞれ別なので、ready のプロジェクトでもログがないことがあります。logs の確認は empty または unavailable になることがあります。ログの読み取りの失敗は、空の結果とは違います。
安全なテストイベントを1件送信する
インストールした SDK から、固有のメッセージを持つテストログを1件送信します。トークン、ユーザーのデータ、リクエストボディは含めないでください。プロジェクト ID、サービス、環境、リリース、UTC の開始時刻、SDK のバージョンを記録します。送信が終わるのを待ってから、同じプロジェクトの短い期間を読みます。送信の保留中に、追加のテストイベントを送信しないでください。見つからないログを探す
まず、狭く正確なスコープで読みます。- プロジェクト ID が、イベントを送信したアプリのものであること。
- サービス、リリース、環境が、大文字と小文字や空白も含めて正確に一致していること。
- 期間にイベントの時刻が含まれていること。LogBrew はイベントの時刻を UTC で返します。
--untilの時刻自体は期間に含まれません。 - 検索や重大度のフィルターでイベントが隠れていないこと。
- 読んでいるシグナルの種類を、アプリが送信していること。ログから課題やトレースは作られません。
- プロジェクトはそのままにして、期間を広げます。
- リリースのフィルターを外します。
- 環境のフィルターを外します。
- サービスのフィルターを外します。
- 検索と重大度のフィルターを外します。
結果の1ページは合計ではありません。
--pagination cursor を使う場合は、返された next_cursor で続きを読み、フィルターは同じものを使います。カーソルベースのページネーションを参照してください。
ダッシュボードの表示を確認する
ダッシュボードは、各一覧のスナップショットを表示します。ログの画面で ライブログ をオンにすると、新しいログが届くたびに追加されます。ほかの画面はライブでは更新されません。新しいスナップショットを取得するには、ページを再読み込みします。古いスナップショットは、空の結果とは違います。 LogBrew が保存するのは、アプリが送信したテレメトリだけです。認証情報、リクエストボディ、クエリの値、個人データは送信前に取り除いてください。フィールドの選び方は 取得するデータを管理するで確認します。課題とトレースを確認する
LogBrew が返した課題 ID またはトレース ID を使います。ID を作り出さないでください。--status には unresolved、resolved、archived を指定できます。ignored は archived と同じ課題を選びます。
課題のステータスとトレースのステータスは別のものです。トレースのステータスの値 not_linked、not_found、unavailable は、それぞれ意味が異なります。各値については 課題を調査するを参照してください。課題を解決、アーカイブ、再開する前に、その課題とログを読みます。
CLI と API のエラーに対処する
JSON モードでは、CLI のエラーにok、error、message、next が含まれます。
error は api_error になります。エラーには、status（HTTP ステータス）、api_code（API の code）、api_error、api_next も含まれます。rate_limited のエラーには retry_after_seconds も含まれます。CLI は自動では再試行しません。
各エラーコードについては API エラーを参照してください。
不正利用されたアカウントを保護する
アカウントのアクセストークン、リフレッシュトークン、セッション Cookie をほかの人が持っている可能性がある場合は、すべての LogBrew クライアントからログアウトします。アカウント全体のログアウトの手順に従ってください。この操作には人の承認が必要です。logbrew logout やブラウザーでのログアウトは1つのクライアントしか終了しないため、十分ではありません。
アカウント全体のログアウトは、それより前に承認されたすべての MCP 接続も止めます。成功したら、各クライアントでローカルの LogBrew の認証情報を消去し、信頼できるクライアントからもう一度サインインします。MCP クライアントは、信頼できることを確認してから再び承認します。レスポンスが失われた場合は、すべてのクライアントがログアウトしたと報告せず、リクエストを自動で繰り返さないでください。
アカウント全体のログアウトでは、プロジェクトの取り込みキーはローテーションされません。取り込みキーが漏えいした場合は、取り込みキーをローテーションしてください。
トラブルシューティングを安全に行う
CLI での読み取りには、アカウントのアクセス用の認証情報を使います。プロジェクト単位の取り込み用の認証情報は、SDK での書き込みにだけ使います。トークン、認可ヘッダー、生のログ、顧客のデータ、リクエストボディ、ローカルのパス、ソースコードを、コマンド、チャット、サポートチケットに含めないでください。 問題を報告する前に、失敗が再現する最も狭いスコープで読み取りを1回繰り返します。認証情報の値を除いたコマンド、エラーコード、プロジェクト ID、フィルターの値を記録します。確認しても問題が解決しない場合は、問題を報告してください。関連ページ
クイックスタート
最初の安全なイベントを送信して読みます。
CLI を使う
正確なフィルターと JSON 出力を使います。
課題を調査する
ステータスを変える前に、課題の証拠を読みます。
API エラー
エラーコードごとに回復します。