SYNOPSIS

ssh -p <port> <host> gerrit stream-events

DESCRIPTION

Provides a portal into the major events occurring on the server, outputting activity data in real-time to the client. Events are filtered by the caller’s access permissions, ensuring the caller only receives events for changes they can view on the web, or in the project repository.

Event output is in JSON, one event per line.

ACCESS

Caller must be a member of the privileged Administrators group, or have been granted the Stream Events global capability.

SCRIPTING

This command is intended to be used in scripts.

OPTIONS

  • --subscribe|-s
    Type of the event to subscribe to. Multiple –subscribe options may be specified to subscribe to multiple events. When this option is provided, only subscribed events are emitted and all other events are ignored. When this option is omitted, all events are emitted.

EXAMPLES

  $ ssh -p 29418 review.example.com gerrit stream-events
  {"type":"comment-added",change:{"project":"tools/gerrit", ...}, ...}
  {"type":"comment-added",change:{"project":"tools/gerrit", ...}, ...}

Only subscribe to specific event types:

  $ ssh -p 29418 review.example.com gerrit stream-events \
      -s patchset-created -s ref-replicated

SCHEMA

The JSON messages consist of nested objects referencing the change, patchSet, account involved, and other attributes as appropriate.

Note that any field may be missing in the JSON messages, so consumers of this JSON stream should deal with that appropriately.

EVENTS

Assignee Changed

Sent when the assignee of a change has been modified.

  • type
    “assignee-changed”

  • change
    change attribute

  • changer
    account attribute

  • oldAssignee
    Assignee before it was changed.

  • eventCreatedOn
    Time in seconds since the UNIX epoch when this event was created.

Change Abandoned

Sent when a change has been abandoned.

Change Merged

Sent when a change has been merged into the git repository.

Change Restored

Sent when an abandoned change has been restored.

Comment Added

Sent when a review comment has been posted on a change.

Dropped Output

Sent to notify a client that events have been dropped.

  • type
    “dropped-output”

Hashtags Changed

Sent when the hashtags have been added to or removed from a change.

  • type
    “hashtags-changed”

  • change
    change attribute

  • editor
    account attribute

  • added
    List of hashtags added to the change

  • removed
    List of hashtags removed from the change

  • hashtags
    List of hashtags on the change after tags were added or removed

  • eventCreatedOn
    Time in seconds since the UNIX epoch when this event was created.

Project Created

Sent when a new project has been created.

  • type
    “project-created”

  • projectName
    The created project name

  • projectHead
    The created project head name

  • eventCreatedOn
    Time in seconds since the UNIX epoch when this event was created.

Patchset Created

Sent when a new change has been uploaded, or a new patch set has been uploaded to an existing change.

Ref Updated

Sent when a reference is updated in a git repository.

Reviewer Added

Sent when a reviewer is added to a change.

Reviewer Deleted

Sent when a reviewer (with a vote) is removed from a change.

Topic Changed

Sent when the topic of a change has been changed.

  • type
    “topic-changed”

  • change
    change attribute

  • changer
    account attribute

  • oldTopic
    Topic name before it was changed.

  • eventCreatedOn
    Time in seconds since the UNIX epoch when this event was created.

Vote Deleted

Sent when a vote was removed from a change.

SEE ALSO

GERRIT

Part of Gerrit Code Review