Saltar al contenido principal
Versión: Next

Por qué no aparecen los datos de mi dispositivo

Un dispositivo envía eventos y no aparece nada. Antes de leer el log de un pod, mira lo que la plataforma rechazó. Cuando descarta un evento, o no puede almacenarlo, guarda un registro breve de ello, y tu tenant puede leerlo.

Estado

Disponible. Abre Fallos de ingesta en la sección Monitor de la consola, o consulta failedEvents y failedEventSummary en la API GraphQL de event-management. Ambas requieren device:write, la autorización de los miembros que gestionan dispositivos y por tanto pueden actuar ante un rechazo, y no la base de solo lectura que tiene todo miembro. Tampoco se ofrecen a los miembros cuyo acceso se limita a algunos clientes: un rechazo suele nombrar un dispositivo que no existe, por lo que no pertenece a ningún cliente.

Qué está viendo​

Cada fila es un evento rechazado, del más reciente al más antiguo:

ColumnaSignificado
RegistradoCuándo registró la plataforma el rechazo. Es el reloj de la plataforma, no el del dispositivo.
MotivoPor qué. Ve la tabla siguiente.
Token del dispositivoEl token que indicó el remitente. Es lo que afirma el remitente, no una prueba de que el dispositivo exista: para un dispositivo desconocido no nombra nada de su registro.
Lo que indicó la plataformaEl texto de la propia plataforma, acortado a 512 bytes.
Agrupados ademásCuántos registros adicionales del mismo motivo y del mismo dispositivo se contaron en esta fila. Ve el límite de inundación.

Las filas son un informe. No son una cola: no se reenvía nada, y los eventos originales no se almacenan en los datos de tu tenant. Corrige la causa y los siguientes eventos del dispositivo se aceptan.

Motivos y qué hacer​

MotivoQué ocurrióQué revisar
Dispositivo desconocido (DEVICE_NOT_FOUND)Ningún dispositivo tiene el token que indicó el remitente.Registra el dispositivo o corrige el token que envías. Un token no es el nombre del dispositivo ni su credencial; ve los tres identificadores.
Credencial rechazada (UNAUTHENTICATED)La credencial que presentó el dispositivo faltaba o era incorrecta.La credencial del dispositivo: ¿se rotó, venció o nunca se configuró en el dispositivo?
No es dispositivo de esta pasarela (NOT_GATEWAY_CHILD)Una pasarela publicó para un dispositivo que no le está asignado o que no existe.La asignación a la pasarela del dispositivo.
Mensaje ilegible (INVALID)El mensaje no se pudo leer.El formato de la carga que envía el dispositivo.
Error de la plataforma (API_CALL_FAILED)No se pudo contactar un servicio de la plataforma que el evento necesitaba, o falló el almacenamiento del evento.No se resuelve desde el dispositivo. Avisa a tu operador; el detalle está en los logs de la plataforma y no se te muestra.
Alias de integración cambiado (INTEGRATION_ALIAS_MISMATCH)El evento de una integración nombró un dispositivo que ya no tiene el alias con el que se asoció.El alias del dispositivo en la integración.
Otro motivo (UNKNOWN)Un motivo que esta versión no nombra.La fila lleva su código de motivo. Nunca se muestra como otro motivo.

Si la tabla está vacía y los datos siguen sin aparecer, la plataforma no registró ningún rechazo: comprueba si el dispositivo está deshabilitado (los eventos de un dispositivo deshabilitado se descartan y se cuentan, pero no aparecen aquí), la conexión del dispositivo, su estado en vivo y si sus eventos llegan al broker.

En la página de un dispositivo​

Cuando se rechazaron eventos de un dispositivo en las últimas 24 horas, su página de detalle lo indica, con un enlace a los motivos de ese dispositivo.

Desde la línea de comandos​

dcctl events failed lee los mismos registros como miembro del tenant, con el mismo requisito de device:write:

# los fallos del último día, contados por motivo, con los dispositivos que originan la mayoría
dcctl events failed -s dc.example.com --tls --tenant acme --email ops@acme.example --password "$PASSWORD" --summary

# los rechazos de un dispositivo por un motivo, del más reciente al más antiguo, en JSON
dcctl events failed --tenant acme --email ops@acme.example --password "$PASSWORD" \
--device sensor-17 --reason device-not-found --since 6h --output json

--since y --until aceptan una hora RFC 3339 o hace cuánto tiempo (6h). La plataforma lee como máximo 31 días atrás. Un listado se detiene en --limit registros (100 por defecto) e indica cuándo coincidieron más. --summary solo acepta --since (24 horas por defecto). Consulta la referencia de comandos. El comando no devuelve el evento original.

El límite de inundación​

Una flota con una sola credencial incorrecta puede ver rechazados miles de eventos por segundo. La lista sería inútil, y también el almacén que la respalda, si guardara cada uno. Por eso:

  • se conservan como máximo 10 registros por hora por dispositivo y motivo; cada registro adicional se cuenta en el más reciente de ellos (la columna Agrupados además);
  • se detallan como máximo 1000 registros por hora por motivo, entre todos los dispositivos. Un sondeo con tokens inventados queda acotado igual; el resto se cuenta en una sola fila marcada como más registros de ese motivo.

Los totales de los botones de motivo incluyen todo lo agrupado. Los contadores miden magnitud, no son una auditoría: los contadores se escriben aproximadamente una vez por segundo, así que durante una caída de la base de datos esperan en memoria y un reinicio de la plataforma antes de que se resuelva los pierde.

Cuánto tiempo se conservan​

Siete días por omisión. Un operador lo cambia con lifecycle.failedEventRetentionDays en la configuración de event-management (0 conserva los registros indefinidamente); es independiente de lifecycle.retentionDays, que rige la telemetría.

El evento original, cuando la plataforma archivó uno, permanece en el flujo de fallos de la plataforma solo hasta que el límite de tamaño de ese flujo lo descarta. Un registro cuyo original ya se descartó sigue en la lista e indica que el original ya no se conserva (payloadStatus: EXPIRED en la API). No es un error. Algunos registros nunca tuvieron un original: cuando la plataforma no pudo leer un mensaje, no conservó nada de él, y la consola indica «el original no se conservó» (payloadStatus: NOT_RETAINED). La API nunca devuelve el evento original.

Al eliminar un tenant​

Los registros se borran junto con el resto de los datos del tenant. Un tenant eliminado no deja ninguno.

Para operadores​

FailedEventsSustained se dispara cuando un mismo motivo se rechaza a más de un registro por segundo durante 15 minutos. La serie que lo respalda cuenta todos los registros, incluidos los que el límite de inundación agrupó. Ve Observabilidad y la referencia de métricas.