Auto-tools/Projects/Pulse/Exchanges

From MozillaWiki
Jump to: navigation, search

This page is meant to be a list of exchanges available on pulse.mozilla.org. If exchanges you are publishing isn't listed here, please add them. Your description doesn't have to be long, this is just give an overview of which exchanges is available on pulse, so that people can build tools on top of them. If you have additional documentation available, this is also a good place to put a link.

Example entry

== Notifications About Jonas' Lunch ==
;exchange: [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Fjonasfj%2Flunch-notifications&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/jonasfj/lunch-notifications</code>]
;maintainer: jonasfj@mozilla.com
;description: Exchange where I publish JSON messages about my lunch every day.

Treeherder

New Result-Sets

exchange(prod)
exchange/treeherder/v1/new-result-set
exchange(stage)
exchange/treeherder-stage/v1/new-result-set
maintainer
mdoglio@mozilla.com
description
Messages about new result-sets. These messages include the revision_hash, and can be used to add additional jobs to a treeherder result-set. The exchange for stage is operational as of writing.

Job Actions

exchange(prod)
exchange/treeherder/v1/job-actions
exchange(stage)
exchange/treeherder-stage/v1/job-actions
maintainer
mdoglio@mozilla.com
description
Messages about retrigger/cancel actions on jobs. Includes requester (an email address) and job_id/job_guid to fetch details about the job itself. The exchange for stage is operational as of writing.

Resultset Actions

exchange(prod)
exchange/treeherder/v1/resultset-runnable-job-actions
exchange(stage)
exchange/treeherder-stage/v1/resultset-runnable-job-actions
maintainer
mdoglio@mozilla.com
description
Messages for a push (e.g. "add new jobs"). Sample:

NOTE: Beware, the following sample was copied from tc's pulse-inspector and I could not access to the raw value. I hand edited the structure.

{
  u"requested_jobs": [u'0:desktop-test-linux64/opt-reftest-1', u'Windows 7 VM-GFX 32-bit try debug test mochitest-1'],
  u"resultset_id": u"117941",
  u"timestamp": 1471878682.08,
  u"project": u"try",
  u"version": 1,
  u"requester": "armenzg@mozilla.com",
  u"decisionTaskID": "OpXU-JkRRpW96DEgCoQo2g"
}

Pulse Test

exchange
exchange/pulse/test
maintainer
mcote@mozilla.com
description
A simple heartbeat message published every minute. This can be used to test if your client is working, although subscribing to any high-traffic exchange (e.g. BuildBot) would work as well. Note that this is currently broken.

Simple Bugzilla

exchange
exchange/bugzilla/simple
maintainer
mcote@mozilla.com
description
Notifications of Bugzilla bug updates. See BMO/ChangeNotificationSystem.

BuildBot

exchange
exchange/build/
maintainer
catlee@mozilla.com
description
Notifications of builds and test runs. See Auto-tools/Projects/Pulse#Consuming_Buildbot_messages.

Normalized BuildBot

exchange
exchange/build/normalized
maintainer
jgriffin@mozilla.com
description
See Auto-tools/Projects/Pulse#Consuming_Buildbot_messages.

hg.mozilla.org

exchange
exchange/hgpushes/v1
maintainer
gps@Mozilla.com
description
See v-c-t docs

MozReview

exchange
exchange/mozreview/
maintainer
mcote@mozilla.com
description
See v-c-t docs

TaskCluster

This is just an outline of the most useful exchanges, taskcluster publishes a lot of events to pulse, for more details see reference documentation on docs.taskcluster.net.

Queue: Task Defined

exchange
exchange/taskcluster-queue/v1/task-defined
maintainer
jonasfj@mozilla.com
description
Notifications of new task definitions, for details see official documentation

Queue: Task Pending

exchange
exchange/taskcluster-queue/v1/task-pending
maintainer
jonasfj@mozilla.com
description
Notifications of pending tasks, for details see official documentation

Queue: Task Running

exchange
exchange/taskcluster-queue/v1/task-running
maintainer
jonasfj@mozilla.com
description
Notifications of running tasks, for details see official documentation

Queue: Artifact Creation

exchange
exchange/taskcluster-queue/v1/artifact-created
maintainer
jonasfj@mozilla.com
description
Notifications of new artifacts, for details see official documentation

Queue: Task Completed

exchange
exchange/taskcluster-queue/v1/task-completed
maintainer
jonasfj@mozilla.com
description
Notifications of completed tasks, for details see official documentation

Queue: Task Failed

exchange
exchange/taskcluster-queue/v1/task-failed
maintainer
jonasfj@mozilla.com
description
Notifications of failed tasks, for details see official documentation

Queue: Task Exception

exchange
exchange/taskcluster-queue/v1/task-exception
maintainer
jonasfj@mozilla.com
description
Notifications of tasks that could not run, for details see official documentation

Mozilla: Push detected

exchange
exchange/mozilla-taskcluster/v1/pushlog
maintainer
selena@mozilla.com (for now)
description
Notifications of pushes detected by mozilla-taskcluster, still filling in details by reverse engineering

Generated with publish_push.js

Taskcluster-treeherder: Job Event

exchange(prod)
exchange/taskcluster-treeherder/v1/jobs
exchange(stage)
exchange/taskcluster-treeherder-staging/v1/jobs
maintainer
garndt@mozilla.com
description
Treeherder consumable job information created from Taskcluster task events.

Firefox Test Engineering

exchange
exchange/fxtesteng/jobs
maintainer
dhunt@mozilla.com
description
Treeherder consumable job information created from automated tests.