Inicio rápido
Crea un proyecto, copia su clave de ingesta, envía un primer evento y encuéntralo en el panel.
Lyrelog es un servicio alojado, en acceso anticipado por invitación. Pide acceso en
lyrelog.com; el enlace de la invitación te permite crear tu cuenta. El
panel está en app.lyrelog.com y las apps envían sus eventos a
https://ingest.lyrelog.com.
Ponle nombre a tu primer proyecto
Después de crear tu cuenta, el panel se abre en Welcome. Ponle un nombre al proyecto e indica qué envía sus eventos: una app de iOS o macOS, un sitio web, un servicio de Node, Python o Go, o cualquier otra cosa por HTTP. Lo que elijas decide el fragmento de código que verás a continuación y la plataforma del proyecto.
Crea un proyecto por app. Si la app también tiene un sitio web y un backend, todos pueden enviar al mismo proyecto (consulta Plataformas). Los siguientes proyectos se crean desde Projects y New project. Solo un propietario de la organización puede crear proyectos.
Copia la clave de ingesta
Nada más crear el proyecto, Lyrelog muestra su clave de ingesta, lyr_ing_..., y las líneas que
debes pegar en tu app. Copia la clave ahora: solo se guarda un hash, así que no se puede
volver a mostrar. Si la pierdes, crea una nueva en la página API keys del proyecto.
La clave de ingesta solo puede enviar eventos, nunca leerlos, así que es seguro incluirla dentro de una app. Consulta Claves. Un backend debería enviar los eventos con una clave de servidor (Send events from a server, en la página API keys), cuyos eventos están verificados.
Envía un primer evento
Los SDK aún no están publicados
Los SDK para Swift, Android, React Native, Flutter, JavaScript, Python, Go y la JVM aún no se pueden instalar. Por ahora, envía tu primer evento con curl, o desde cualquier lenguaje por la API HTTP.
En una terminal de macOS o Linux (usa uuidgen y date), sustituye lyr_ing_... por tu clave
y ejecuta:
curl -X POST https://ingest.lyrelog.com/v1/events:batch \
-H "Authorization: Bearer lyr_ing_..." \
-H "Content-Type: application/x-ndjson" \
--data-binary "{\"event_id\":\"$(uuidgen | tr A-Z a-z)\",\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"message\":\"hello_lyrelog\",\"resource\":{\"environment\":\"production\"}}"Cada evento necesita un UUID nuevo como event_id y la hora actual como ts. Un evento cuyo ts
sea anterior a la retención del proyecto, o esté más de un día en el futuro, no se pierde: se
guarda con la hora a la que llegó, y la hora con la que se envió va en el atributo
_lyrelog_ts_clamped. La respuesta indica cuántas líneas se guardaron:
{"accepted":1,"rejected":[]}¿Recibes otra respuesta? Consulta No llegan eventos.
Mira cómo llega
La página Welcome espera al primer evento y te avisa cuando llega. Abre el proyecto desde
ahí: la página Events muestra hello_lyrelog. Haz clic en él para ver el evento completo.
¿No aparece?
El panel muestra un entorno a la vez y se abre en el predeterminado del proyecto,
production. Los SDK envían development desde una build que ejecutas en Xcode, desde el
simulador, desde una página en localhost y desde Node salvo que esté definido
NODE_ENV=production, así que tus primeros eventos desde un SDK estarán en development:
elígelo, o All environments, en la barra superior. El curl de arriba define
"environment":"production"; un evento enviado sin resource.environment también se guarda
como production. Consulta Entornos.
Léelo desde un script (opcional)
En la página API keys del proyecto, elige New key, pon What it can do en Read events
y copia la clave lyr_read_.... Para crear una clave de lectura tienes que volver a iniciar sesión
si lo hiciste por última vez hace más de 10 minutos. Guárdala en un servidor: lee todos los
eventos del proyecto.
export LYRELOG_READ_KEY=lyr_read_...
curl -s -G https://app.lyrelog.com/v1/events \
-H "Authorization: Bearer $LYRELOG_READ_KEY" \
--data-urlencode "message=hello_lyrelog"Consulta la API de lectura.
Siguientes pasos
Apps
Web y servidores
Cualquier otra cosa
- Aprende qué hace bueno a un evento: Eventos.
- Si algo no funciona: No llegan eventos.