Argo Events Setup Guide

When to Use This Skill

This guide covers EventSource, EventBus, and Sensor configuration for event-driven automation.

---

Implementation

This guide covers EventSource, EventBus, and Sensor configuration for event-driven automation.

---

Components

Component	Purpose	Guide
EventSource	Connect to external systems (Pub/Sub, webhooks)	EventSource Configuration
EventBus	Message broker for event delivery	EventBus Configuration
Sensor	Filter events and trigger workflows	Sensor Configuration

---

Quick Start

1. Deploy EventBus - Start with JetStream for production
2. Configure EventSource - Connect your Pub/Sub topic or GitHub webhooks
3. Create Sensor - Define event filters and triggers

---

EventBus First

Deploy the EventBus before creating EventSources or Sensors. Without a running EventBus, events have nowhere to go.

---

Troubleshooting

Events Not Arriving

1. Check EventSource logs: kubectl logs -n argo-events -l eventsource-name=<name>
2. Verify Pub/Sub subscription exists in GCP console
3. Confirm service account has pubsub.subscriber role

Events Arriving But Not Triggering

1. Check Sensor logs: kubectl logs -n argo-events -l sensor-name=<name>
2. Verify filter conditions match event payload
3. Test with a simple sensor that logs all events

Events Lost During Restarts

1. Enable persistence on EventBus
2. Increase maxAge retention
3. Monitor EventBus storage usage

---

Related

• Argo Workflows Patterns - WorkflowTemplate design and error handling
• ConfigMap as Cache Pattern - Volume mounts for zero-API reads
• Event-Driven Deployments - The journey to zero-latency automation

Components

Component	Purpose	Guide
EventSource	Connect to external systems (Pub/Sub, webhooks)	EventSource Configuration
EventBus	Message broker for event delivery	EventBus Configuration
Sensor	Filter events and trigger workflows	Sensor Configuration

---

Quick Start

1. Deploy EventBus - Start with JetStream for production
2. Configure EventSource - Connect your Pub/Sub topic or GitHub webhooks
3. Create Sensor - Define event filters and triggers

---

EventBus First

Deploy the EventBus before creating EventSources or Sensors. Without a running EventBus, events have nowhere to go.

---

Troubleshooting

Events Not Arriving

1. Check EventSource logs: kubectl logs -n argo-events -l eventsource-name=<name>
2. Verify Pub/Sub subscription exists in GCP console
3. Confirm service account has pubsub.subscriber role

Events Arriving But Not Triggering

1. Check Sensor logs: kubectl logs -n argo-events -l sensor-name=<name>
2. Verify filter conditions match event payload
3. Test with a simple sensor that logs all events

Events Lost During Restarts

1. Enable persistence on EventBus
2. Increase maxAge retention
3. Monitor EventBus storage usage

---

Related

• Argo Workflows Patterns - WorkflowTemplate design and error handling
• ConfigMap as Cache Pattern - Volume mounts for zero-API reads
• Event-Driven Deployments - The journey to zero-latency automation

Troubleshooting

See troubleshooting.md for common issues and solutions.

Related Patterns

• Argo Workflows Patterns
• ConfigMap as Cache Pattern
• Event-Driven Deployments

References

• Source Documentation
• AEL Patterns