Home

Welcome to the Azure Event Grid Simulator documentation. This wiki provides comprehensive documentation for configuring and using the simulator.

Quick Navigation

Getting Started

• Configuration - How to configure topics and subscribers
• Topics - Topic settings and schema support
• Schema Support - EventGrid and CloudEvents schemas

Subscriber Types

• HTTP Subscribers - Webhook configuration
• Service Bus Subscribers - Azure Service Bus queues and topics
• Storage Queue Subscribers - Azure Storage Queues
• Event Hub Subscribers - Azure Event Hubs

Advanced Features

• Filtering - Event filtering and advanced filters
• Retry and Dead-Letter - Retry policies and dead-lettering
• Dashboard - Web-based monitoring UI

Deployment

• Docker - Docker and Docker Compose deployment

Help & Reference

• Troubleshooting - Common issues and solutions
• Known Limitations - Differences from Azure Event Grid

For Contributors

• Architecture - System design, component diagrams, and event flow
• Contributing - Development setup and guidelines

About This Simulator

A simulator that provides endpoints to mimic the functionality of Azure Event Grid topics and subscribers. Compatible with the Microsoft.Azure.EventGrid client library and supports both the EventGrid schema and CloudEvents v1.0 schema.

Why This Simulator?

Azure Event Grid only accepts connections over HTTPS and the Microsoft.Azure.EventGrid client only sends requests over HTTPS. Most existing simulators don't support HTTPS or use query URIs to distinguish between topics, which isn't compatible with the official client library.

This simulator:

• Supports HTTPS on each topic port
• Uses port-based topic routing (compatible with the official client)
• Supports both EventGrid and CloudEvents schemas
• Provides a dashboard for monitoring and debugging

Getting Help

• Troubleshooting - Solutions to common problems
• GitHub Issues - Report bugs or request features
• GitHub Releases - Download the latest version

Development

See the Contributing page for development setup and guidelines.

This project uses CSharpier for code formatting. CSharpier runs automatically on every build.