Saltar al contenido principal

Comandos

Todos los comandos de collector, agrupados como los agrupa la propia CLI. collector <comando> --help muestra las opciones de cada uno.

Un problema se puede nombrar por su identificador o pegando la dirección de su página. Las listas muestran una página (--limit, hasta 100) con una pista --cursor … para la siguiente, o todas con --all.

Iniciar sesión​

ComandoQué hace
collector loginInicia sesión aprobando un código en el navegador, en esta máquina o en otra. Ver Iniciar sesión.
collector logoutRevoca la credencial de esta máquina y la olvida.
collector whoamiQuién es la credencial, qué acceso tiene, a qué organizaciones pertenece.
collector use [<org>[/<proyecto>]]Fija la organización, y si quieres el proyecto, que usan los demás comandos. --clear lo olvida.

Proyectos y puesta en marcha​

ComandoQué hace
collector projects listLos proyectos de la organización, con sus problemas sin resolver.
collector projects create <nombre>Crea uno e imprime su DSN.
collector projects show [<proyecto>]Un proyecto, con su DSN.
collector projects edit [<proyecto>] --name <nombre>Lo renombra (propietarios y administradores); la dirección no cambia.
collector projects mute [<proyecto>]Apaga sus correos de problemas, para ti.
collector projects unmute [<proyecto>]Los vuelve a encender.
collector dsn [<proyecto>]Solo el DSN, para scripts: COLLECTOR_DSN=$(collector dsn).
collector origins listLos dominios del proyecto y su estado.
collector origins allow <origen>Acepta los eventos de ese dominio (un host sin esquema es https://).
collector origins block <origen>Rechaza sus eventos.
collector origins forget <origen>Lo olvida: su próximo evento vuelve a preguntar.
collector upload-tokens listLas credenciales de subida del proyecto.
collector upload-tokens create <nombre>Crea una e imprime el secreto, una sola vez.
collector upload-tokens revoke <id>La revoca.
collector server-keys listLas claves de servidor del proyecto.
collector server-keys create <nombre>Crea una e imprime el secreto, una sola vez.
collector server-keys revoke <id>La revoca.

Problemas​

ComandoQué hace
collector issues list [palabras…]Los problemas, el visto más recientemente primero. Sin filtros: los sin resolver de la última semana.
collector issues show <id|url>Un problema. Con --markdown, el texto que Collector escribe para una IA.
collector issues events <id|url>Sus eventos, el más nuevo primero.
collector issues event <id|url> <uuid>Un evento completo (también con --markdown).
collector issues resolve <id|url>…Los marca como resueltos. Acepta varios.
collector issues ignore <id|url>…Los marca como ignorados.
collector issues reopen <id|url>…Los vuelve a Sin resolver.
collector issues assign <id|url> <correo|me|none>Asigna un responsable, o lo quita.

Filtros de issues list: --status unresolved|resolved|ignored, --range day|week|month|all, --env, --platform elixir|javascript|node|other, --release (la versión que introdujo el problema) y --search, o las palabras sueltas, que buscan en el título, el mensaje y la función. Ver Problemas.

Registros​

ComandoQué hace
collector logs [palabras…]Lo que mandaron los servidores del proyecto: líneas de log, solicitudes e inicios de sesión, en una línea de tiempo, lo más viejo arriba.

Filtros: --since y --until (15m, 2h, 1d o una hora ISO), --env, --server, --service, --request, --user, --ip, --account, --status 404|5xx, --path, --level (un mínimo) y --type log,request,sign_in. --markdown da el texto de Collector para una IA.

--follow (o -f) lee lo reciente y después sigue mostrando los registros nuevos en vivo, hasta Ctrl-C. Si la conexión se corta, se reconecta sola y completa lo que faltó. Ver Registros.

Velocidad y señales​

ComandoQué hace
collector speedLas Web Vitals en el percentil 75, las páginas y los pedidos más lentos, como la pestaña Velocidad.
collector speed pagesLas páginas, la más lenta primero.
collector speed page <ruta>Una página: sus medidas, dispositivos y visitas más lentas.
collector speed requestsLos pedidos que hacen las páginas, el más lento primero.
collector speed request <método> <ruta>Un pedido: las páginas que lo hacen y sus llamadas más lentas.
collector signals [<proyecto>]Qué servidores y navegadores reportan, por entorno. Ver Señales.

speed acepta --period day|week|month|quarter, --env y --device phone|tablet|desktop.

Organización y personas​

ComandoQué hace
collector orgs listTus organizaciones y tu rol en cada una.
collector orgs show [<org>]Una organización.
collector orgs edit [<org>]La renombra (--name) o cambia su dirección (--slug). Una dirección nueva cambia sus URL.
collector members listLos miembros y sus roles.
collector members invite <correo>…Invita personas; cada una recibe un correo con un enlace. --role elige el rol.
collector members role <correo> <member|admin|owner>Cambia el rol de alguien, con las reglas de la aplicación.
collector members remove <correo>Quita a alguien de la organización. Pregunta antes, o --yes.
collector members leave [<org>]Sales de la organización. Pregunta antes, o --yes.
collector invitations listLas invitaciones pendientes, la más nueva primero.
collector invitations resend <id>La manda de nuevo, con un enlace nuevo y siete días más.
collector invitations revoke <id>La revoca: su enlace deja de funcionar.
collector auditEl registro de auditoría, lo más reciente primero.

Mapas de código fuente y pruebas​

ComandoQué hace
collector upload <dir>Sube los mapas de código fuente que hay bajo el directorio. Ver Mapas de código fuente.
collector testManda un evento de prueba, como lo hace un SDK de servidor, y muestra la respuesta de Collector.

Más​

ComandoQué hace
collector openAbre una página de la aplicación web: los problemas del proyecto, o issue <id>, logs …, speed, settings. También imprime la dirección.
collector api <ruta>Un pedido directo a la API, bajo /api/v1, con tu sesión, para lo que no tiene comando propio. -X elige el método, -f clave=valor agrega campos.

collector completion bash|zsh|fish|powershell imprime el autocompletado para tu shell.

Opciones globales​

OpciónVariable
--urlCOLLECTOR_URLQué Collector. Por defecto, el último en el que iniciaste sesión; si no, app.clt.chrom.ar.
--org, --projectCOLLECTOR_ORG, COLLECTOR_PROJECTQué proyecto. No hacen falta si hay uno solo, o si fijaste uno con collector use.
COLLECTOR_TOKENUna credencial de acceso; siempre gana sobre la guardada.
--jsonEl JSON de Collector, tal cual.
--lang en|esCOLLECTOR_LANGEl idioma de los mensajes de Collector.
-q, --quietSolo los errores y el resultado esencial.
-v, --verboseCOLLECTOR_DEBUG=1Pedidos y tiempos en stderr; nunca las credenciales.
--no-colorNO_COLORSin colores.

Códigos de salida​

CódigoSignifica
0Hecho.
1Collector rechazó o falló: no existe, no tienes permiso, datos inválidos, problema de red.
2Un error de uso del comando.
3Sin sesión, una credencial rechazada o revocada, o una credencial de solo lectura que intentó cambiar algo.

upload y test usan solo 0, 1 y 2.