Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo, se describen los conceptos principales de Event Grid relacionados con la entrega de inserciones.
Nota:
Para ver los conceptos de Event Grid relacionados con el nuevo modelo de recursos que usa espacios de nombres, consulte este artículo de conceptos .
Eventos
Un evento es la cantidad mínima de información que describe completamente algo que se ha producido en un sistema. Cada evento tiene información común, como el source del evento, el time evento tuvo lugar y un identificador único. Cada evento también tiene información específica que solo es relevante para el tipo de evento específico. Por ejemplo, un evento sobre un nuevo archivo que se crea en Azure Storage contiene detalles sobre el archivo, como el valor lastTimeModified. Un evento de Event Hubs tiene la URL del archivo de captura. Un evento sobre un nuevo pedido en el microservicio Orders puede tener un atributo orderId y un atributo URL en la representación de estado del pedido.
CloudEvents
Event Grid usa la especificación Cloud Native Computing Foundation (CNCF) open standard CloudEvents 1.0 con el enlace de protocolo HTTP y el formato JSON. CloudEvents es una especificación de eventos extensible con extensiones documentadas para requisitos específicos. CloudEvents es el formato de evento preferido debido a sus casos de uso bien documentados (modos para transferir eventos, formatos de eventos, etc.), extensibilidad y mejor interoperabilidad. CloudEvents mejora la interoperabilidad al proporcionar un formato de eventos común para la publicación y el consumo de eventos. Permite herramientas uniformes y formas estándar de enrutamiento y control de eventos.
En la tabla siguiente se muestra la compatibilidad actual con la especificación CloudEvents:
| Modo de contenido de CloudEvents | Se admite? |
|---|---|
| JSON estructurado | Sí |
| Binario | No |
El tamaño máximo permitido para un evento es de 1 MB. Los eventos de más de 64 KB se cobran en incrementos de 64 KB. Para obtener las propiedades que se envían en un evento, consulte el documento sobre el esquema CloudEvents.
Otros formatos
Event Grid también admite el formato de esquema propietario de Event Grid para los publicadores de eventos del sistema. Puede configurar Event Grid para entregar eventos con el formato CloudEvents.
Publicadores
Un publicador es la aplicación que envía eventos a Event Grid. Puede ser la misma aplicación donde se originaron los eventos, el origen del evento. Los servicios de Azure publican eventos en Event Grid para anunciar una incidencia en su servicio. Puede publicar eventos desde su propia aplicación. Las organizaciones que hospedan servicios fuera de Azure también pueden publicar eventos a través de Event Grid.
Orígenes de eventos
Un origen de evento es donde se produce el evento. Cada origen de evento está relacionado con uno o más tipos de eventos. Por ejemplo, Azure Storage es el origen de evento de los eventos creados por blob. IoT Hub es el origen de evento de los eventos creados por dispositivo. La aplicación es el origen de evento de los eventos personalizados que defina. Los orígenes del evento son responsables de enviar eventos a Event Grid.
Asociados
Un asociado es un tipo de publicador que envía eventos desde su sistema para que estén disponibles para los clientes de Azure. Normalmente, un asociado es un proveedor de Software como servicio (SaaS) o Enterprise Resource Planning (ERP) que se integra con Azure Event Grid para ayudar a los clientes a obtener casos de uso basados en eventos en distintas plataformas. Los asociados no solo pueden publicar eventos en Azure Event Grid, sino que también pueden recibir eventos de él. Estas funcionalidades se habilitan a través de la característica Eventos de asociados.
Temas
Un tema contiene eventos que se publican en Event Grid. Normalmente, se usa un recurso de tema para una colección de eventos relacionados. Para responder a determinados tipos de eventos, los suscriptores (un servicio de Azure u otra aplicación) deciden los temas a los que se suscriben. Hay varios tipos de temas: temas personalizados, temas del sistema y temas de asociados.
Temas personalizados
Los temas personalizados también son temas que se usan con las aplicaciones. Fueron el primer tipo de temas diseñados para crear integraciones controladas por eventos para aplicaciones personalizadas. Como recurso independiente, exponen su propio punto de conexión al que se publican eventos.
Los temas personalizados admiten la entrega de inserción. Consulte cuándo usar la entrega de extracción o inserción para ayudarle a decidir si la entrega de inserción es el enfoque adecuado según sus requisitos. También puedes consultar el artículo Temas personalizados.
Temas del sistema
Los temas del sistema son temas integrados que proporcionan los servicios de Azure, como Azure Storage, Azure Event Hubs y Azure Service Bus. Puede crear temas del sistema en su suscripción de Azure y suscribirse a ellos. Para obtener más información, consulte Información general sobre los temas del sistema.
Temas de asociados
Los temas de asociados son un tipo de tema que se usa para suscribirse a eventos publicados por un asociado. La característica que habilita este tipo de integración se denomina Eventos de partners. A través de esa integración, obtendrá un tema de asociado en el que los eventos de un sistema asociado están disponibles. Una vez que tenga un tema asociado, cree una suscripción de eventos como haría para cualquier otro tipo de tema.
Suscripciones a eventos
Nota:
Para obtener información sobre las suscripciones de eventos dentro de un tema en el espacio de nombres, consulte este artículo de conceptos.
Las suscripciones le indican a Event Grid qué eventos de un tema les interesa recibir. Al crear una suscripción, proporciona un punto de conexión para controlar el evento. Los puntos de conexión pueden ser un webhook o un recurso de servicio de Azure. Puede filtrar los eventos que se envían a un punto de conexión. Puede filtrar por tipo de evento o por asunto de evento, por ejemplo. Para obtener más información, consulte Suscripciones de eventos y Esquema de CloudEvents. Las suscripciones a eventos para temas personalizados, de sistema, de socio y de dominio presentan las mismas propiedades de recursos.
Para obtener ejemplos de creación de suscripciones para temas personalizados, sistemas, temas de socios y dominios, consulte:
- Creación de un tema personalizado y suscripción a eventos con la CLI de Azure
- Ejemplos de Azure PowerShell para Event Grid
- Plantillas de Azure Resource Manager para Event Grid
Para obtener información sobre las suscripciones de Event Grid actuales, vea Consulta de suscripciones de Event Grid.
Caducidad de la suscripción de eventos
Puede establecer una hora de expiración para las suscripciones de eventos asociadas a temas personalizados, del sistema, de socios, del dominio, así como para las suscripciones de dominio. La suscripción de eventos expira automáticamente después de esa fecha. Establezca una fecha de caducidad para las suscripciones de eventos que solo necesite durante un tiempo limitado, sin tener que preocuparse por eliminarlas. Por ejemplo, es posible que, al crear una suscripción de eventos para probar un escenario, desee establecer una fecha de expiración.
Para ver un ejemplo acerca de cómo se establece una fecha de expiración, consulte Suscripción con filtros avanzados.
Controladores de eventos
Desde la perspectiva de Event Grid, un controlador de eventos es el lugar al que se envía el evento cuando se usa la entrega de inserción. El controlador realiza alguna acción adicional para procesar el evento. La entrega push en Event Grid admite varios tipos de manejador. Puede usar un servicio de Azure admitido o su propio webhook como controlador. Según el tipo de controlador, Event Grid sigue distintos procedimientos para garantizar la entrega del evento. En el caso de los controladores de eventos de webhook HTTP, el evento se reintenta hasta que el controlador devuelve un código de estado de 200 – OK. En Azure Storage Queue, los eventos se reintentan hasta que Queue service procesa correctamente la inserción de mensajes en la cola.
Para información sobre cómo entregar eventos a cualquiera de los controladores admitidos de Event Grid, consulte Event handlers in Azure Event Grid (Controladores de eventos en Azure Event Grid).
Seguridad
Event Grid proporciona seguridad para suscribirse a temas y al publicar eventos en temas. Para suscribirse, debe tener los permisos adecuados en el tema de Event Grid. Si usa la entrega push, el controlador de eventos es un servicio de Azure y una identidad administrada autentica a Event Grid, la identidad administrada debe tener un rol de acceso basado en roles (RBAC) adecuado. Por ejemplo, si envía eventos a Event Hubs, la identidad administrada que se usa en la suscripción de eventos debe ser miembro del rol Remitente de datos de Event Hubs. Para publicar, debe tener un token de SAS o autenticación de clave para el tema. Para más información, vea Event Grid security and authentication (Seguridad y autenticación de Event Grid).
Entrega de eventos
Si Event Grid no puede confirmar que el punto de conexión del suscriptor recibió un evento al usar la entrega push, vuelve a entregar el evento. Para más información, vea Entrega y reintento de entrega de mensajes de Event Grid.
Procesamiento por lotes
Cuando se usa un tema personalizado, siempre debe publicar los eventos en una matriz. Puede ser un lote de uno para escenarios de bajo rendimiento.
Definiciones de tipo de evento insertado
Si es un asociado, puede definir los tipos de eventos que está poniendo a disposición de los clientes al crear un canal. Con las definiciones de tipo de evento insertados, los suscriptores pueden filtrar fácilmente eventos según su tipo de evento al configurar una suscripción de eventos.
Zonas de disponibilidad
Las zonas de disponibilidad de Azure son ubicaciones separadas físicamente dentro de cada región de Azure y toleran los errores locales. Están conectados por una red de alto rendimiento con una latencia de ida y vuelta de menos de 2 milisegundos. Cada zona de disponibilidad consta de uno o varios centros de datos equipados con una infraestructura de alimentación, refrigeración y redes independientes. Si se ve afectada una zona, las dos zonas restantes admiten servicios regionales, capacidad y alta disponibilidad. Para más información sobre Availability Zones, consulte Regiones y zonas de disponibilidad.
Contenido relacionado
- Para obtener una introducción a Event Grid, vea Acerca de Event Grid.
- Para comenzar a usar temas personalizados, consulte Creación y enrutamiento de eventos personalizados con Azure Event Grid.