Añade
--json en los flujos de agentes. Una comprobación fallida devuelve un
campo next estable.Empieza por las comprobaciones rápidas
Recupera la primera telemetría que falta
Ejecuta estos comandos de solo lectura antes de cambiar la configuración del SDK:logbrew doctor comprueba el acceso a la API, la autenticación, el proyecto,
la clave de ingesta, la configuración, la telemetría y la visibilidad de los
logs. No cambia el proyecto. Lee el status general y cada comprobación del
informe de doctor. El código de
salida 0 no significa que se hayan superado todas las comprobaciones.
El informe también puede tener el estado
auth_invalid, project_missing,
api_unreachable o check_failed. El
informe de doctor indica el
siguiente paso para cada uno.
Un proyecto ready puede no tener logs, porque cada tipo de señal es
independiente. La comprobación logs puede ser empty o unavailable. Una
lectura de logs fallida no es un resultado vacío.
Envía un evento de prueba seguro
Envía un log de prueba con un mensaje único desde el SDK instalado. No incluyas tokens, datos de usuarios ni cuerpos de solicitudes. Anota el ID del proyecto, el servicio, el entorno, el release, la hora de inicio en UTC y la versión del SDK. Espera a que se envíe y después lee un intervalo de tiempo corto en el mismo proyecto. No envíes más eventos de prueba mientras el envío siga pendiente.Encuentra los logs que faltan
Lee primero un alcance pequeño y exacto:- El ID del proyecto pertenece a la app que envió el evento.
- El servicio, el release y el entorno coinciden exactamente, incluidas las mayúsculas y los espacios.
- El intervalo de tiempo incluye la hora del evento. LogBrew devuelve las horas
de los eventos en UTC.
--untiles un límite superior exclusivo. - Ningún filtro de búsqueda o de severidad oculta el evento.
- La app envió el tipo de señal que lees. Un log no crea una incidencia ni una traza.
- Mantén el proyecto y amplía el intervalo de tiempo.
- Quita el filtro de release.
- Quita el filtro de entorno.
- Quita el filtro de servicio.
- Quita los filtros de búsqueda y de severidad.
Una página de resultados no es un total. Con
--pagination cursor, continúa con
el next_cursor devuelto y mantén los mismos filtros. Consulta
Paginación por cursor.
Revisa la vista del panel
El panel muestra una instantánea de cada lista. En la vista de logs, activa Registros en vivo para añadir los logs nuevos a medida que llegan. Las demás vistas no se actualizan en vivo. Recarga la página para obtener una instantánea nueva. Una instantánea antigua no es lo mismo que un resultado vacío. LogBrew solo guarda la telemetría que envía la app. Quita las credenciales, los cuerpos de las solicitudes, los valores de consulta y los datos personales antes del envío. Usa Controlar los datos capturados para revisar tu selección de campos.Revisa las incidencias y las trazas
Usa un ID de incidencia o un ID de traza que haya devuelto LogBrew. Nunca te inventes uno.--status acepta unresolved, resolved y archived. ignored selecciona
las mismas incidencias que archived.
El estado de la incidencia y el estado de la traza son distintos. Los valores
de estado de la traza not_linked, not_found y unavailable significan cosas
distintas. Consulta Investigar una incidencia
para ver cada valor. Lee la incidencia y sus logs antes de resolverla,
archivarla o reabrirla.
Gestiona los errores de la CLI y de la API
En modo JSON, un error de la CLI contieneok, error, message y next:
error es api_error. El error también tiene
status (el estado HTTP), api_code (el code de la API), api_error y
api_next. En un error rate_limited, también tiene retry_after_seconds. La
CLI no reintenta automáticamente.
Consulta Errores de la API para ver cada código de
error.
Protege una cuenta comprometida
Si otra persona podría tener un token de acceso de la cuenta, un token de actualización o una cookie de sesión, cierra la sesión de todos los clientes de LogBrew. Sigue el procedimiento de cierre de sesión en toda la cuenta. Una persona debe aprobar esta acción.logbrew logout y el cierre de sesión en
un navegador solo terminan un cliente, así que no bastan.
El cierre de sesión en toda la cuenta también detiene todas las conexiones MCP
aprobadas antes de él. Si termina bien, borra las credenciales locales de
LogBrew en cada cliente y vuelve a iniciar sesión desde un cliente de
confianza. Vuelve a aprobar los clientes MCP solo cuando confíes en ellos. Si
se pierde la respuesta, no informes de que se cerró la sesión de todos los
clientes y no repitas la solicitud automáticamente.
El cierre de sesión en toda la cuenta no rota las claves de ingesta del
proyecto. Si se expuso una clave de ingesta,
rota la clave de ingesta.
Soluciona problemas de forma segura
Usa una credencial de acceso de la cuenta para las lecturas con la CLI. Usa una credencial de ingesta limitada al proyecto solo para las escrituras del SDK. No pongas tokens, encabezados de autorización, logs sin procesar, datos de clientes, cuerpos de solicitudes, rutas locales ni código fuente en un comando, un chat o un ticket de soporte. Antes de informar de un problema, repite una lectura con el alcance más pequeño que siga fallando. Anota el comando sin los valores de las credenciales, el código de error, el ID del proyecto y los valores de los filtros. Si las comprobaciones no resuelven el problema, informa de un problema.Páginas relacionadas
Inicio rápido
Envía y lee el primer evento seguro.
Usar la CLI
Usa filtros exactos y salida JSON.
Investigar una incidencia
Lee la evidencia de la incidencia antes de cambiar su estado.
Errores de la API
Recupérate de cada código de error.