Elige una señal
Empieza la investigación de un fallo con las incidencias o los logs. Usa una
traza disponible para examinar una ejecución. Usa la tendencia de una métrica
para examinar un periodo más amplio. Para la actividad y la retención, lee
Analíticas de producto.
Captura solo los campos que necesita una investigación. Usa nombres estables
de servicios, operaciones y métricas. No envíes credenciales, datos de pago ni
cuerpos de solicitud sin procesar. Controlar los datos capturados explica los controles.
Logs
Un log es un registro de la aplicación en un momento concreto. Un log útil tiene:- La hora de origen del evento.
- Una severidad canónica.
- El alcance de proyecto y servicio.
- El entorno y el release.
- Los identificadores de traza y span, cuando el log tiene un contexto de traza activo.
- Atributos pequeños y con nombre que dan contexto al evento.
occurred_at, severity,
project_id, service_name, environment, release, trace_id, span_id
y attributes. Pon el contexto en atributos con nombre, no en el texto del
mensaje.
Los logs de varios servicios en una misma vista no tienen una relación de
traza. Solo el contexto de la traza crea esa relación.
Trazas
Una traza contiene los spans de una solicitud u operación. Un span raíz no tiene padre. Un span hijo identifica a su padre. Todos los spans de una traza tienen el mismo ID de traza y distintos ID de span. Consulta Trazado distribuido. Un log, una incidencia, una acción o una métrica que se envía sin contexto de traza activo recibe una traza de captura. Esa traza solo contiene spans de captura. No muestra la ruta de una solicitud. Consulta Spans de captura.Métricas
Una métrica registra un valor medido a lo largo del tiempo. Lee cada métrica con su nombre, unidad, dimensiones, proyecto, intervalo de tiempo e intervalo. LogBrew elige elvalue de cada punto según el kind y la temporality de
la métrica:
Por ejemplo, tres muestras de un contador delta con los valores
2, 3 y 5
en un intervalo dan un value de 10 en el punto y un sample_count de 3.
Tres muestras de un gauge con los mismos valores, en ese orden, dan un value
de 5 en el punto. Un valor p95 no es una media. Alrededor del 95 % de las
observaciones registradas son iguales o inferiores a él.
Con status: "ready", la agregación derivada está disponible. Con
status: "limited", lee aggregation.limitation y usa solo los valores sin
procesar. No sumes un gauge ni un flujo acumulativo. Un intervalo sin punto no
es un cero medido. Para los campos de consulta, lee
Filtros de consulta.
GET /api/telemetry/metrics/series devuelve estos puntos. Requiere
project_id, name y since. Cada serie tiene una identity con un kind,
una unit y una temporality. Las series con identidades distintas se
mantienen separadas. Cada punto también puede contener:
coverage.truncated es true cuando series_limit omitió series de menor
volumen. Para comparar el intervalo de tiempo de una métrica con el intervalo
de tiempo anterior de la misma duración, ejecuta:
Incidencias
Una incidencia agrupa fallos repetidos por una huella estable. Tiene una severidad, un estado, un número de ocurrencias, una hora en que se vio por primera vez y otra en que se vio por última vez. Los detalles de una incidencia pueden añadir cadenas de excepciones, marcos de pila, pasos anteriores, logs relacionados y una relación con una traza.last_seen_at es la ocurrencia más reciente del grupo. La ocurrencia que
selecciones puede ser más antigua. Lee las dos horas.
El status de una incidencia es unresolved, resolved o archived. La
versión 1 de la respuesta de la API muestra archived como ignored. Las
versiones 2 y 3 de la respuesta añaden priority (high, medium o low) y
priority_source. La versión 3 también añade assignee. Consulta
Valores de estado y
Prioridad.
Acciones
Una acción registra la actividad de producto. La clasificación admitida la marca como vista de página, vista de pantalla o interacción. El nombre del evento por sí solo no define la clasificación. Usa Captura de eventos de producto para añadir este contexto. Las sesiones no son usuarios. Los sujetos anónimos no son usuarios identificados.Valores de severidad
LogBrew acepta los alias como entrada en mayúsculas o minúsculas. La API, la
CLI y los eventos en vivo usan los valores canónicos. Los valores de severidad
desconocidos se rechazan. La severidad es la urgencia registrada. No muestra
el impacto en el negocio ni la causa raíz.
Un usuario puede cambiar la severidad que se muestra de una incidencia o un
log. La respuesta contiene entonces un objeto
triage con
effective_severity. El campo severity conserva el valor capturado.
Lecturas en vivo e instantáneas
logbrew read devuelve una instantánea del proyecto, el intervalo de tiempo y
los filtros seleccionados. Vuelve a ejecutarlo para leer eventos nuevos.
logbrew watch transmite los nuevos logs, incidencias y acciones mientras la
conexión está abierta. No transmite trazas ni métricas. Un fallo de conexión
no demuestra que el proyecto esté vacío.
Estados de la evidencia
Las respuestas mantienen separados estos estados: capturado, ausente, oculto, truncado y no disponible. La evidencia de una traza tiene cuatro estados:available, not_linked, not_found y unavailable. Consulta la
introducción para su
significado, y
Límites de la evidencia
para los campos de cobertura. Un SDK más reciente no añade campos a los
eventos que envió antes.
Investiga un proyecto
1
Encuentra las incidencias sin resolver
2
Lee una incidencia
Esto lee el historial conservado de la incidencia. El filtro
--since de
la lista no se aplica.3
Abre una traza disponible
Usa el ID de traza solo cuando la ocurrencia seleccionada devuelva uno.
4
Lee la evidencia relacionada
Filtra los logs, las acciones y las métricas con el mismo proyecto,
servicio, entorno y release. No vincules señales solo por la hora.