Tipos de clave de proyecto
Cada clave de proyecto pertenece a un solo proyecto. Su tipo define lo que puede hacer. Eliges el tipo con--kind cuando ejecutas
logbrew projects keys create.
Los tipos
sdk, server, cli y browser son claves de ingesta. Elige el
tipo que nombra dónde se ejecuta la clave. Usa browser para el código que se
ejecuta en un navegador. Nunca pongas una clave de lectura en código de
navegador, en una app móvil ni en un bundle público.
El acceso de la cuenta es otra cosa. logbrew login da a la CLI el acceso de
tu cuenta. Nunca uses el acceso de la cuenta como configuración del SDK. Una
clave de lectura no puede iniciar sesión en la CLI ni en el panel.
Lee de vuelta tu evento de prueba
1
Crea una clave de lectura
Para este paso necesitas el acceso de la cuenta. Ejecuta
La CLI escribe la clave en un archivo nuevo que solo puede leer su
propietario. Nunca muestra la clave ni la ruta del archivo.
logbrew status --json y comprueba que indica un acceso de cuenta
autenticado.--ingest-key-file es la opción de archivo para todos los tipos de
clave. El archivo de destino no debe existir.Punto de control: el resultado tiene status: "created" y
ingest_key.kind: "read". Anota ingest_key.id. Lo necesitas para
revocar la clave.2
Envía un evento de prueba
Envía un log de prueba seguro desde tu aplicación con la clave de ingesta
del proyecto. Sigue los pasos para tu runtime en el
inicio rápido o en la
guía de integración del SDK. Para probar
también las incidencias, envía un error de prueba gestionado.Punto de control: el SDK indica un estado
2xx. Esto muestra que
LogBrew aceptó la solicitud. Continúa con el siguiente paso.3
Lee el evento de vuelta
Carga la clave de lectura en Cada lectura devuelve solo datos del proyecto de la clave, así que no
necesitas
LOGBREW_TOKEN solo para esta shell. Después,
lee el proyecto:--project. Añade --service, --environment o --release
para que coincida con el evento de prueba.Punto de control: el log de prueba aparece con tu servicio, entorno y
release. Un error de prueba aparece como incidencia. Esto muestra que
LogBrew guardó los eventos y que puedes leerlos.Cuando termines, ejecuta unset LOGBREW_TOKEN. La CLI vuelve a usar el
acceso de tu cuenta.4
Revoca la clave de lectura
Revoca la clave cuando ya no la necesites. Este paso necesita el acceso de
la cuenta, así que primero quita Punto de control: el resultado tiene
LOGBREW_TOKEN.status: "revoked". La clave
deja de funcionar en su siguiente solicitud.Da acceso de lectura a un trabajo de CI o a un agente
Usa una clave de lectura propia para un trabajo de CI o un agente de programación que lea un proyecto. Guarda la clave en el almacén de secretos del sistema de CI o del entorno del agente. Ponla a disposición comoLOGBREW_TOKEN. No
pongas la clave en un prompt, en un repositorio ni en la salida de un comando.
Después, el trabajo o el agente puede ejecutar lecturas como
logbrew issues --json, logbrew issue "<issue_id>" --json y
logbrew read trace "<trace_id>". Los comandos de proyectos, claves y cuenta
necesitan el acceso de la cuenta. Los clientes de la API envían la clave como
token bearer a las lecturas de telemetría de la
API de telemetría.
Usa una clave para cada trabajo o agente. Así puedes revocar una clave sin
afectar a las demás.
Soluciona una lectura fallida
Si la telemetría sigue sin aparecer, usa las
comprobaciones de la primera telemetría.
Para sustituir una clave de ingesta, consulta
Rotar una clave de ingesta.