Pruebas de eventos, observabilidad y recuperación ante fallos

Obtén más información sobre cómo probar y gestionar tus eventos y flujos de eventos.

Las siguientes secciones proporcionan información sobre cómo probar los flujos de eventos y gestionar eventos.

​

Probar el flujo de eventos

Después de crear y habilitar un flujo de eventos, puede probar el nuevo flujo. Actualmente, Auth0 no admite el envío de eventos a flujos de eventos deshabilitados.

Para probar su flujo de eventos, primero cree un usuario para su aplicación ejecutando lo siguiente con las credenciales que prefiera:

Auth0 CLI

auth0 users create # siga las instrucciones para crear un usuario de prueba

cURL

curl -s \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -X POST https://$TENANT/api/v2/users \
  -d '{
        "email": "[e-mail]",
        "password": "Password123!",
        "connection": "Username-Password-Authentication"
      }'

Después de crear el usuario, esto debería activar el evento user.created en su flujo de eventos y devolver una respuesta. En este ejemplo, se usan webhooks para implementar el flujo de eventos.

"Webhook received": {
  "id": "evt_6SfwXrtm8nVcjzzNCFFH1L",
  "source": "urn:auth0:",
  "specversion": "1.0",
  "type": "user.created",
  "time": "2025-02-02T17:56:01.573Z",
  "data": {
    "object": {
      "created_at": "2025-02-02T17:56:01.566Z",
      "email": "[e-mail]",
      "email_verified": false,
      "identities": [
        {
          "connection": "Username-Password-Authentication",
          "isSocial": false,
          "provider": "auth0",
          "user_id": "679fb1b1e809445f129bc18d"
        }
      ],
      "name": "[e-mail]",
      "nickname": "nick-testing-21",
      "picture": "test.png",
      "updated_at": "2025-02-02T17:56:01.566Z",
      "user_id": "auth0|679fb1b1e809445f129bc18d"
    }
  },
  "a0tenant": "acme",
  "a0stream": "est_38ANnv8pQhqsZrX2VFbftv",
  "a0purpose": "test"
}

Puedes listar los fallos de entrega de eventos de un flujo de eventos específico ejecutando:

Auth0 CLI

auth0 api get event-streams/$EVENT_STREAM_ID/deliveries

cURL

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://$TENANT/api/v2/event-streams/${EVENT_STREAM_ID}/deliveries" | jq .

Si se devuelve un array vacío de fallos de entrega, tu flujo de eventos funciona correctamente.

​

Observabilidad

Para garantizar la fiabilidad de los flujos de eventos, implemente un proceso de monitorización que compruebe periódicamente si hay fallos de entrega y active alertas cuando sea necesario.

Los fallos de entrega pueden deberse a lo siguiente:

• Flujos de eventos deshabilitados.
• Flujos de eventos no disponibles.
• Errores de conexión.

​

Endpoint Deliveries para sondeo

Consulte el endpoint Deliveries cada 5 minutos para comprobar si hay eventos fallidos. Use la siguiente llamada a la API para obtener las entregas de eventos recientes:

Auth0 CLI

auth0 api get event-streams/$EVENT_STREAM_ID/deliveries

cURL

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://$TENANT/api/v2/event-streams/${EVENT_STREAM_ID}/deliveries" | jq .

Si se detectan fallos:

• Registre los detalles del evento fallido.
• Notifique al equipo o sistema correspondiente para revisar y diagnosticar el problema.

​

Recuperación

La entrega de eventos se reintentará automáticamente. Para obtener más información, consulte Prácticas recomendadas.

Si se producen errores, use la Redelivery API para volver a intentar la entrega de eventos.

​

Reentregar un único evento fallido

Para reintentar la entrega de un evento fallido específico, use:

Auth0 CLI

EVENT_ID=<your event id>
auth0 api POST event-streams/$EVENT_STREAM_ID/redeliver/$EVENT_ID --data '{}'

cURL

curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  "https://<your-domain>/api/v2/event-streams/$EVENT_STREAM_ID/redeliver/$EVENT_ID"

​

Reenvío por lotes de eventos fallidos

Para reintentar todos los eventos fallidos del flujo de eventos:

Auth0 CLI

auth0 api POST event-streams/$EVENT_STREAM_ID/redeliver --data '{}'

cURL

curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  "https://<your-tenant>.auth0.com/api/v2/event-streams/<event_stream_id>/redeliver"

​

Mecanismo de desactivación automática

Auth0 desactiva automáticamente un flujo de eventos si se produce un número excesivo de fallos.

Condición	Acción
500 fallos consecutivos	El flujo de eventos se desactiva automáticamente.
5000 fallos totales	El flujo de eventos se desactiva automáticamente.

• Si un flujo de eventos se desactiva automáticamente, debe usar la Redelivery API para procesar los eventos fallidos.
• El flujo de eventos no puede volver a habilitarse manualmente hasta que el número total de fallos sea inferior a 5000.
• Una vez reducido el número de fallos, puede volver a habilitar el flujo mediante la API.

​

Más información

• Tipos de eventos
• Crear un flujo de eventos
• Prácticas recomendadas sobre eventos