Acceso anticipadoSolo por invitación, y los SDK aún no están publicados.Pedir una invitación
Ir al contenido
Docs

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