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
| Comando | Qué hace |
|---|
collector login | Inicia sesión aprobando un código en el navegador, en esta máquina o en otra. Ver Iniciar sesión. |
collector logout | Revoca la credencial de esta máquina y la olvida. |
collector whoami | Quié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
| Comando | Qué hace |
|---|
collector projects list | Los 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 list | Los 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 list | Las 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 list | Las 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
| Comando | Qué 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
| Comando | Qué 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
| Comando | Qué hace |
|---|
collector speed | Las Web Vitals en el percentil 75, las páginas y los pedidos más lentos, como la pestaña Velocidad. |
collector speed pages | Las páginas, la más lenta primero. |
collector speed page <ruta> | Una página: sus medidas, dispositivos y visitas más lentas. |
collector speed requests | Los 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
| Comando | Qué hace |
|---|
collector orgs list | Tus 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 list | Los 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 list | Las 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 audit | El registro de auditoría, lo más reciente primero. |
Mapas de código fuente y pruebas
| Comando | Qué hace |
|---|
collector upload <dir> | Sube los mapas de código fuente que hay bajo el directorio. Ver Mapas de código fuente. |
collector test | Manda un evento de prueba, como lo hace un SDK de servidor, y muestra la respuesta de Collector. |
Más
| Comando | Qué hace |
|---|
collector open | Abre 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ón | Variable | |
|---|
--url | COLLECTOR_URL | Qué Collector. Por defecto, el último en el que iniciaste sesión; si no, app.clt.chrom.ar. |
--org, --project | COLLECTOR_ORG, COLLECTOR_PROJECT | Qué proyecto. No hacen falta si hay uno solo, o si fijaste uno con collector use. |
| COLLECTOR_TOKEN | Una credencial de acceso; siempre gana sobre la guardada. |
--json | | El JSON de Collector, tal cual. |
--lang en|es | COLLECTOR_LANG | El idioma de los mensajes de Collector. |
-q, --quiet | | Solo los errores y el resultado esencial. |
-v, --verbose | COLLECTOR_DEBUG=1 | Pedidos y tiempos en stderr; nunca las credenciales. |
--no-color | NO_COLOR | Sin colores. |
Códigos de salida
| Código | Significa |
|---|
0 | Hecho. |
1 | Collector rechazó o falló: no existe, no tienes permiso, datos inválidos, problema de red. |
2 | Un error de uso del comando. |
3 | Sin 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.