Auto-tools/Projects/Pulse/Exchanges: Difference between revisions

Latest revision as of 18:26, 10 May 2019

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.

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"
}

Simple Bugzilla

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

hg.mozilla.org

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

TaskCluster

Taskcluster publishes events to pulse for just about everything that goes on. For more details see the Taskcluster Reference Docs.

Firefox Test Engineering

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

@@ Line 1: / Line 1: @@
 This page is meant to be a list of exchanges available on <code>pulse.mozilla.org</code>. 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'''
+== Treeherder ==
-<pre>
-== Notifications About Jonas' Lunch ==
-;exchange: <code>exchange/jonasfj/lunch-notifications</code>
-;maintainer: jonasfj@mozilla.com
-;description: Exchange where I publish JSON messages about my lunch every day.
-</pre>
-== Treeherder: New Result-Sets ==
+=== New Result-Sets ===
-;exchange(prod): <code>exchange/treeherder/v1/new-result-set</code>
+;exchange(prod): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder%2Fv1%2Fnew-result-set&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder/v1/new-result-set</code>]
-;exchange(stage): <code>exchange/treeherder-stage/v1/new-result-set</code>
+;exchange(stage): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder-stage%2Fv1%2Fnew-result-set&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder-stage/v1/new-result-set</code>]
 ;maintainer: mdoglio@mozilla.com
 ;description: Messages about new result-sets. These messages include the <code>revision_hash</code>, and can be used to add additional jobs to a treeherder result-set. The exchange for stage is operational as of writing.
-== Treeherder: Job Actions ==
+=== Job Actions ===
-;exchange(prod): <code>exchange/treeherder/v1/job-actions</code>
+;exchange(prod): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder%2Fv1%2Fjob-actions&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder/v1/job-actions</code>]
-;exchange(stage): <code>exchange/treeherder-stage/v1/job-actions</code>
+;exchange(stage): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder-stage%2Fv1%2Fjob-action&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder-stage/v1/job-actions</code>]
 ;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): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder%2Fv1%2Fresultset-runnable-job-actions&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder/v1/resultset-runnable-job-actions</code>]
+;exchange(stage): [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ftreeherder-stage%2Fv1%2Fresultset-runnable-job-actions&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/treeherder-stage/v1/resultset-runnable-job-actions</code>]
+;maintainer: mdoglio@mozilla.com
+;description: Messages for a push (e.g. "add new jobs"). Sample:
-== Pulse Test ==
+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.
-;exchange: <code>exchange/pulse/test</code>
+<pre>
-;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 (bug 1091042).
+  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"
+}
+</pre>
 == Simple Bugzilla ==
-;exchange: <code>exchange/bugzilla/simple</code>
+;exchange: [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Fbugzilla%2Fsimple&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/bugzilla/simple</code>]
 ;maintainer: mcote@mozilla.com
 ;description: Notifications of Bugzilla bug updates.  See [[BMO/ChangeNotificationSystem]].
-== BuildBot ==
+== hg.mozilla.org ==
-;exchange: <code>exchange/build/</code>
+;exchange: [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Fhgpushes%2Fv2&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/hgpushes/v2</code>]
-;maintainer: catlee@mozilla.com
+;maintainer: gps@Mozilla.com
-;description: Notifications of builds and test runs.  See [[Auto-tools/Projects/Pulse#Consuming_buildbot_messages]].
+;description: See [https://mozilla-version-control-tools.readthedocs.io/en/latest/hgmo/notifications.html v-c-t docs]
-== Normalized BuildBot ==
-;exchange: <code>exchange/build/normalized</code>
-;maintainer: jgriffin@mozilla.com
-;description: See [[Auto-tools/Projects/Pulse#Consuming_buildbot_messages]].
-== TaskCluster Queue: Task Defined ==
-;exchange: <code>exchange/taskcluster-queue/v1/task-defined</code>
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of new task definitions, for details see [http://docs.taskcluster.net/queue/exchanges/#taskDefined official documentation]
-== TaskCluster Queue: Task Pending ==
-;exchange: <code>exchange/taskcluster-queue/v1/task-pending</code>
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of pending tasks, for details see [http://docs.taskcluster.net/queue/exchanges/#taskPending official documentation]
-== TaskCluster Queue: Task Running ==
-;exchange: <code>exchange/taskcluster-queue/v1/task-running</code>
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of running tasks, for details see [http://docs.taskcluster.net/queue/exchanges/#taskRunning official documentation]
-== TaskCluster Queue: Artifact Creation ==
-;exchange: <code>exchange/taskcluster-queue/v1/artifact-created</code>
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of new artifacts, for details see [http://docs.taskcluster.net/queue/exchanges/#artifactCreated official documentation]
-== TaskCluster Queue: Task Completed ==
-;exchange: <code>exchange/taskcluster-queue/v1/task-completed</code>
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of completed tasks, for details see [http://docs.taskcluster.net/queue/exchanges/#taskCompleted official documentation]
-== TaskCluster Queue: Task Failed ==
-;exchange: <code>exchange/taskcluster-queue/v1/task-failed</code>
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of failed tasks, for details see [http://docs.taskcluster.net/queue/exchanges/#taskFailed official documentation]
-== TaskCluster Queue: Task Exception ==
-;exchange: <code>exchange/taskcluster-queue/v1/task-exception</code>
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of tasks that could not run, for details see [http://docs.taskcluster.net/queue/exchanges/#taskException official documentation]
-== TaskCluster Scheduler: Task-Graph Running ==
-;exchange: <code>exchange/taskcluster-scheduler/v1/task-graph-running</code>
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of new task-graphs, for details see [http://docs.taskcluster.net/scheduler/events/#taskGraphRunning official documentation]
-== TaskCluster Scheduler: Task-Graph Extended ==
-;exchange: <code>exchange/taskcluster-scheduler/v1/task-graph-extended
-</code>
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of task-graph extensions, for details see [http://docs.taskcluster.net/scheduler/events/#taskGraphExtended official documentation]
-== TaskCluster Scheduler: Task-Graph Blocked ==
+== TaskCluster ==
-;exchange: <code>exchange/taskcluster-scheduler/v1/task-graph-blocked
+Taskcluster publishes events to pulse for just about everything that goes on.  For more details see the [https://docs.taskcluster.net/docs/reference Taskcluster Reference Docs].
-</code>
-;maintainer: jonasfj@mozilla.com
-;description: Notifications of blocked task-graphs, for details see [http://docs.taskcluster.net/scheduler/events/#taskGraphBlocked official documentation]
-== TaskCluster Scheduler: Task-Graph Finished ==
+== Firefox Test Engineering ==
-;exchange: <code>exchange/taskcluster-scheduler/v1/task-graph-finished
+;exchange: [https://tools.taskcluster.net/pulse-inspector?bindings%5B0%5D%5Bexchange%5D=exchange%2Ffxtesteng%2Fjobs&bindings%5B0%5D%5BroutingKeyPattern%5D=%23 <code>exchange/fxtesteng/jobs</code>]
-</code>
+;maintainer: dhunt@mozilla.com
-;maintainer: jonasfj@mozilla.com
+;description: Treeherder consumable job information created from automated tests.
-;description: Notifications of finished task-graphs, for details see [http://docs.taskcluster.net/scheduler/events/#taskGraphFinished official documentation]