Documentation
¶
Overview ¶
Package scriptevents enqueues a run of each automation that names a webhook source for every event the source stores (#2332). The webhook receiver (posted events and form submissions) and the imap poller hand it a source's events once they are durable; each event becomes one run with trigger event, carrying the event as run.event, executed by the run queue's workers under the script's saved author roles, as a scheduled run is.
Nothing runs inline: the sender was answered when the event was stored, and enqueuing is one transaction per script that names the source. Which scripts name a source is read from memory (Bindings), so a source none names costs a delivery no query (#2480). A failure to enqueue is logged, and never fails the delivery, which stored the event whatever happens to its runs.
Index ¶
- Constants
- func Value(source string, ev whevent.Event) map[string]any
- type BindingReader
- type Bindings
- type Enqueuer
- type EventEnqueue
- type EventSummary
- type PostgresStore
- func (s *PostgresStore) EnqueueEvents(ctx context.Context, runs []*script.Run, maxQueued int) (EventEnqueue, error)
- func (s *PostgresStore) EventBindings(ctx context.Context) (map[string][]string, error)
- func (s *PostgresStore) EventSummary(ctx context.Context, scriptID string, since time.Time) (EventSummary, error)
- type Scripts
- type Store
Constants ¶
const ( KeyID = "id" KeyType = "type" KeyKey = "key" KeyReceivedAt = "received_at" KeySource = "source" KeyPayload = "payload" )
The keys run.event carries.
const BindingsChannel = "script_event_sources"
BindingsChannel is the NOTIFY channel a change to any script's webhook source is announced on (migration 000230's trigger), which drops every replica's Bindings.
const DefaultBindingsMaxAge = 5 * time.Second
DefaultBindingsMaxAge is the longest Bindings answers from one read when no change is heard: a NOTIFY sent while a replica's LISTEN connection was down is lost, and this is how long such a replica can miss a new binding. It is the receiver's own source refresh interval.
const DefaultMaxQueued = 100
DefaultMaxQueued is how many pending event runs a script may hold when scripts.events.max_queued names none; an event past it is recorded as skipped_backlog.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type BindingReader ¶ added in v1.153.1
BindingReader reads which scripts run for every webhook source (PostgresStore).
type Bindings ¶ added in v1.153.1
type Bindings struct {
Reader BindingReader
// MaxAge bounds how long one read is used with no change heard; zero is
// DefaultBindingsMaxAge.
MaxAge time.Duration
// contains filtered or unexported fields
}
Bindings is which scripts run for each webhook source, kept in memory so a stored delivery costs no query (#2480). The webhook receiver hands every delivery to the enqueuer inside the sender's request; asking the database each time held the shared pool through a sender's burst even for a source no script names.
The map is read whole, at most once per MaxAge, and again on the next delivery after Notify, which a LISTEN on BindingsChannel calls when any replica changes a script's source. Callers arriving while a read is under way share it, so a burst after a change is one query.
type Enqueuer ¶
type Enqueuer struct {
Store Store
// Bindings names the scripts that run for each source, from memory
// (#2480).
Bindings *Bindings
Scripts Scripts
// MaxQueued bounds each script's pending event runs; zero is
// DefaultMaxQueued.
MaxQueued int
// Timeout bounds one source's enqueue; zero is ten seconds.
Timeout time.Duration
}
Enqueuer enqueues the runs of a source's events.
type EventEnqueue ¶
EventEnqueue is what enqueuing one source's events for one script did (#2332): runs made pending, events recorded as skipped past the bound, and events that already had a run, which made none.
type EventSummary ¶
type EventSummary struct {
Pending int `json:"pending"`
SkippedSince int `json:"skipped_since"`
LastEventRun *time.Time `json:"last_event_run,omitempty"`
LastSkippedAt *time.Time `json:"last_skipped_at,omitempty"`
}
EventSummary is how a script's event runs stand: how many wait, and how many were skipped past the bound since a moment.
type PostgresStore ¶
type PostgresStore struct {
// contains filtered or unexported fields
}
PostgresStore keeps event runs in script_runs and reads which scripts run for a source from scripts (#2332).
func NewStore ¶
func NewStore(db *sql.DB) *PostgresStore
NewStore is the PostgreSQL event run store.
func (*PostgresStore) EnqueueEvents ¶
func (s *PostgresStore) EnqueueEvents(ctx context.Context, runs []*script.Run, maxQueued int) (EventEnqueue, error)
EnqueueEvents writes one run per event for the script the runs name, in one transaction holding the script's row: each is pending while the script's pending event runs are under maxQueued, and recorded as skipped_backlog past it. An event that already has a run makes none. A worker is woken when any run was made pending. Every run carries the same script and version; its Event, EventSource and EventID name the event.
func (*PostgresStore) EventBindings ¶ added in v1.153.1
EventBindings returns the ids of the scripts that run for each webhook source a script names; a source none names is absent.
func (*PostgresStore) EventSummary ¶
func (s *PostgresStore) EventSummary(ctx context.Context, scriptID string, since time.Time) (EventSummary, error)
EventSummary reports how the script's event runs stand, counting the ones skipped since since.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package sourcerule is who may run a managed script for which webhook source (#2332).
|
Package sourcerule is who may run a managed script for which webhook source (#2332). |